安装环境 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-H参数对应  ./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:3000/api/"                   //默认水龙头地址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账户存在，且已升级为会员。

注册成功的后台打印八遇到的问题 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》