安装环境 ubuntu16.04 64位

一安装依赖库(mysql数据库 )

注意，记得安装sql时的root用户密码

sudo apt-get install mysql-server libmysqlclient-dev  libreadline-dev

二 安装ruby环境

//回到home目录
cd ~
git clone git://github.com/sstephenson/rbenv.git .rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
exec $SHELL

git clone git://github.com/sstephenson/ruby-build.git ~/.rbenv/plugins/ruby-build
echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"' >> ~/.bashrc
exec $SHELL

git clone https://github.com/sstephenson/rbenv-gem-rehash.git ~/.rbenv/plugins/rbenv-gem-rehash

sudo rbenv install 2.2.3
sudo rbenv global 2.2.3
sudo gem install bundler

三下载水龙头代码

git clone https://github.com/bitshares/faucet
cd faucet
sudo bundle   # ignore warnings

四 配置水龙头文件

（1）水龙头访问配置faucet.yml

cp config/faucet-example.yml config/faucet.yml
vim config/faucet.yml

》》内容如下
cli_wallet_connection: ws://127.0.0.1:8099   //钱包开放的websocketurl，cli_wallet -r参数对应  ./cli_wallet --chain-id="a35368851451335a25ea894c9bf81831c4e7c39e56ce94700a7813700cadf701" -s ws://127.0.0.1:8090 -w wallet.json -r 127.0.0.1:8099   -H 127.0.0.1:8092  
registrar_account: nathan                    //提供注册的推荐人用户名，本例子为在比特股环境搭建》已创建且升级为会员的用户名nathan
referrer_percent: 50                               
refcode_prefix: F01                                
                                                   
default_url: 127.0.0.1                       //水龙头对外访问的IP      
default_port: 3000                           //水龙头对外访问的端口
                                                   
exception_notification:                            
  sender_address: faucet@example.com               
  exception_recipients: admin@example.com          
                                                   
smtp:                                              
  address: address                                 
  user_name: user                                  
  password: password 

（2）密码种子文件secrets.yml(ruby on rails用到的密码种子配置文件)

cp config/secrets-example.yml config/secrets.yml
rake secret
vim config/secrets.yml
》》内容如下 （按需要改各个清空的密码种子）
development:                                          
  secret_key_base: abcdefg123456                      
                                                      
test:                                                 
  secret_key_base: abcdefg123456                      
                                                      
# Do not keep production secrets in the repository,   
# instead read values from the environment.           
production:                                           
  secret_key_base: abcdefg123456   

（3）数据库配置

vim config/database.yml

》》内容如下
default: &default                    
  adapter: mysql2                    
  encoding: utf8                     
  pool: 5                            
  username: root           #数据库登录用户名                   
  password:                #数据库登录密码，根据安装mysql时的填写
  host: localhost          #数据库url          
                                     
development:                         
  <<: *default                       
  database: bitshares_faucet_dev     
                                     
test:                                
  <<: *default                       
  database: bitshares_faucet_test    
                                     
production:                          
  <<: *default                       
  database: bitshares_faucet   

五 创建并初始化数据库

rake db:create; rake db:migrate; rake db:seed
RAILS_ENV=production bundle exec rake db:create db:schema:load

六 运行水龙头服务 （-b 0.0.0.0 -b，bind之意。是让本机以外的主机，能够访问水龙头服务）

rails s -b 0.0.0.0

七 联合调试

1 创建创世状态json

 ./witness_node --create-genesis-json "genesis.json"

2 启动witness_node

 ./witness_node --rpc-endpoint "127.0.0.1:8090" --enable-stale-production -d test_net --seed-nodes "[]" --genesis-json "genesis.json"

3 启动cli_wallet（如果报chain-id出错，则替换提示的chain-id）

 ./cli_wallet --chain-id="a35368851451335a25ea894c9bf81831c4e7c39e56ce94700a7813700cadf701" -s ws://127.0.0.1:8090 -w wallet.json -r 127.0.0.1:8099   -H 127.0.0.1:8092  

4 启动网页钱包服务
4.1 修改网页钱包的配置文件，配置默认水龙头地址，默认p2p网络的地址
/bitshares-ui/app/api/apiConfig.js

》》内容如下
export const blockTradesAPIs = {
    BASE: "https://api.blocktrades.us/v2",
    // BASE_OL: "https://api.blocktrades.us/ol/v2",
    BASE_OL: "https://ol-api1.openledger.info/api/v0/ol/support",
    COINS_LIST: "/coins",
    ACTIVE_WALLETS: "/active-wallets",
    TRADING_PAIRS: "/trading-pairs",
    DEPOSIT_LIMIT: "/deposit-limits",
    ESTIMATE_OUTPUT: "/estimate-output-amount"
};

export const settingsAPIs = {
    DEFAULT_WS_NODE: "ws://127.0.0.1:8090",               //默认witness_node节点网络地址
    WS_NODE_LIST: [
        {url: "ws://127.0.0.1:8090", location: "My hosted"}//本地witness_node节点网络地址
    ],
    DEFAULT_FAUCET: "http://127.0.0.1:3000",            //默认水龙头地址
    RPC_URL: "http://127.0.0.1:8092"                                //推测是钱包api服务地址，测试中暂时未用到
};

4.2 启动网页钱包

npm start

4.3 浏览器打开127.0.0.1:8080

5 注册(用账户模式测试)
注意：此时的cli_wallet命令行，
5.1 必须是unlock状态(否则注册报Failed to create account: tes32 - Assert Exception: !self.is_locked():)
5.2 nathan账户存在，且已升级为会员。
5.3 nathan账户有很多余额

注册成功的后台打印

八 遇到的问题

1 配置水龙头服务时，生成密码种子命令rake secret报错

$rake secret报错
 Could not find a JavaScript runtime. See https://github.com/rails/execjs for a list of available runtimes.，因为没nodejs环境
=>安装nodejs 
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.30.2/install.sh | bash
nvm install v6
nvm use v6

2 执行rake db:create; rake db:migrate; rake db:seed报错,因root用户在localhost被禁用
ERROR 1698 (28000): Access denied for user 'root'@'localhost'

=>
$ sudo mysql -u root # I had to use "sudo" since is new installation
mysql> USE mysql;
mysql> UPDATE user SET plugin='mysql_native_password' WHERE User='root';
mysql> FLUSH PRIVILEGES;
mysql> exit;

3 Failed to create account: tes32 - Assert Exception: !self.is_locked():
=》
进入cli_wallet命令模式（my_password 是set_password my_password设置的密码）

locked >>> unlock my_password 

4 运行witness_node 一天后，发现无法产生块

2994239ms thread-0 producer_plugin.cpp:210 block_production_loo ] initk generated block #202 @ 2017-09-11T06:49:54 with 0 trxs 0 pending
2998489ms thread-0 producer_plugin.cpp:229 block_production_loo ] Not producing block because node didn't wake up within 500ms of the slot time.
3000615ms thread-0 producer_plugin.cpp:229 block_production_loo ] Not producing block because node didn't wake up within 500ms of the slot time.
3002818ms thread-0 chain_controller.cpp:235 _push_block ] inith #203 @2017-09-11t06:50:03 | 0 trx, 0 pending, exectime_ms=13

=>
BM说，生成一个大区块是阻塞了，没说解决方法。以下是原文
This is an indication that the single CPU is getting backlogged by a large blocking task that is not properly timebound... eg, block generation with a large pending set. （https://github.com/EOSIO/eos/issues/397）

5 注意，witness_node, cli_wallet,faucet配置的IP为127.0.0.1，则服务只能本机访问。如需要本机外的机器能访问，把127.0.0.1设置为本机的局域网IP或公网IP。

6 注册时，水龙头后台服务报异常Failed to create account: tes2 - Assert Exception: base58str.substr( 0, prefix_len ) == prefix

!!! register_account error: {"code"=>1, "message"=>"Assert Exception: base58str.substr( 0, prefix_len ) == prefix: ", "data"=>{"code"=>10, "name"=>"assert_exception", "message"=>"Assert Exception", "stack"=>[{"context"=>{"level"=>"error", "file"=>"types.cpp", "line"=>60, "method"=>"public_key_type", "hostname"=>"", "thread_name"=>"th_a", "timestamp"=>"2017-09-23T06:47:58"}, "format"=>"base58str.substr( 0, prefix_len ) == prefix: ", "data"=>{"base58str"=>"GPH5jNZn4sB7t3sBDcX3NFdx2BLEh3WA15SLmoG71dHCoLs1iTZwH"}}, {"context"=>{"level"=>"warn", "file"=>"websocket_api.cpp", "line"=>122, "method"=>"on_message", "hostname"=>"", "thread_name"=>"th_a", "timestamp"=>"2017-09-23T06:47:58"}, "format"=>"", "data"=>{"call.method"=>"call", "call.params"=>[0, "register_account", ["tes2", "GPH5jNZn4sB7t3sBDcX3NFdx2BLEh3WA15SLmoG71dHCoLs1iTZwH", "GPH5fMdwtVVKGvyawZwEBTBnftbovvNdJg1Q34BMpXPWggXtEKrbv", "nathan", "nathan", 0, true]]}}]}}

=》
因为网页钱包生成的公钥的地址前缀（GPH）和比特股源码的前缀（BTS）不对应。目前采用方法（2），原因是试错先试了这方法（2）。方法（1）未验证.
推测可行修改方式

（1）网页钱包bitshares-core的公钥前缀生成，是在bitsharesjs库里提供的。这里说可以把公钥前缀修改下。(https://blog.xiaofuxing.name/2017/04/18/ecc_in_nodejs_introduction.html)

 const bitsharesjsws = require('bitsharesjs-ws');
 bitsharesjsws.ChainConfig.setPrefix('BTS'); //可以手工设定前缀，这样的话可以兼容Steem区块链。


bitsharesjs库公钥前缀源码见
node_modules>bitsharesjs>cjs>src>ChainConfig.js
"use strict";
exports.__esModule = true;
var _this = void 0;
var ecc_config = {
    address_prefix: process.env.npm_config__graphene_ecc_default_address_prefix || "GPH"
};
_this = {
    core_asset: "CORE",
    address_prefix: "GPH",
    expire_in_secs: 15,
    expire_in_secs_proposal: 24 * 60 * 60,
    review_in_secs_committee: 24 * 60 * 60,
    networks: {
        BitShares: {
            core_asset: "BTS",
            address_prefix: "BTS",
            chain_id: "4018d7844c78f6a6c41c6a552b898022310fc5dec06da467ee7905a8dad512c8"
        },
        Muse: {
            core_asset: "MUSE",
            address_prefix: "MUSE",
            chain_id: "45ad2d3f9ef92a49b55c2227eb06123f613bb35dd08bd876f2aea21925a67a67"
        },
        Test: {
            core_asset: "TEST",
            address_prefix: "TEST",
            chain_id: "39f5e2ede1f8bc1a3a54a7914414e3779e33193f1f5693510e73cb7a87617447"
        },
        Obelisk: {
            core_asset: "GOV",
            address_prefix: "FEW",
            chain_id: "1cfde7c388b9e8ac06462d68aadbd966b58f88797637d9af805b4560b0e9661e"
        }
    },

（2）改bitshares-core源码的公钥前缀为GPH重新编译，且修改所有公钥前缀为GPH。
修改如下

（2.1）修改源码
（2.1.1） 源码/bitshares-core/libraries/chain/include/graphene/chain/config.hpp
#define GRAPHENE_SYMBOL "BTS"
#define GRAPHENE_ADDRESS_PREFIX "BTS"
=>
#define GRAPHENE_SYMBOL "GPH"
#define GRAPHENE_ADDRESS_PREFIX "GPH"

（2.1.2）源码/bitshares-core/libraries/chain/protocol/types.cpp 搜索多处"BTS"
std::string( "BTS" ); 
=>  
std::string( "GPH" );

（2.1.3）源码bitshares-core/libraries/chain/db_init.cpp
    if( symbol == "BTS" )
=>
    if( symbol == "GPH" )

(2.1.4) 修改 bitshares-core/genesis.json ，替换多处
"BTS
=》
"GPH
然后重新编译bitshares-core

（2.2）修改witness_node启动创世块状态文件genesis.json，替换多处
"BTS
=》
"GPH

（2.3）修改witness_node启动参数文件，比特股参数文件 config.ini，替换多处
"BTS
=》
"GPH

九 引用

http://docs.bitshares.org/testnet/7-faucet.html 《Setting up the Faucet》