BitShares X was the first project from Invictus Innovations that I participated in.
For some reason Invictus Innovations creates binaries for their client software only for Mac and Windows.
Below are the instructions on how I set it up on Ubuntu 14.04.
Install prerequisite packages (including some that are not mentioned in the docs):
sudo apt-get update
sudo apt-get install cmake git libreadline-dev uuid-dev g++ libdb++-dev libdb-dev zip libssl-dev openssl build-essential python-dev autotools-dev libicu-dev libbz2-dev libboost-dev libboost-all-dev nodejs-legacy libgl1-mesa-dev libegl1-mesa-dev npm
Download BitShares X code from GitHub:
git clone https://github.com/dacsunlimited/bitsharesx.git
Go to this web page so you can get the latest release number (for example: 0.4.20):
git tag #Note the exact name of the tag for that version
git checkout v0.4.20
git submodule init
git submodule update
Download and install Qt 5.3.1 for Linux 64-bit:
chmod +x qt-opensource-linux-x64-1.6.0-4-online.run
Download and install Node.js v0.10.29:
tar xzf node-v0.10.29-linux-x64.tar.gz
Install lineman and its dependencies in web_wallet folder using npm:
(The next two commands take a few minutes to complete.)
sudo npm install -g lineman
sudo npm install
Configure using CMake:
cmake -DINCLUDE_QT_WALLET=ON ../bitsharesx
Make the web wallet first, and then the rest of the system -- note that there will be a lot of warnings -- just ignore all the warnings:
Run the Qt client to confirm that it works:
cd ~/src/bitsharesx-build/programs/qt_wallet && ./BitSharesX
The first thing you should do is export your wallet. It will be saved in the form of a .json file and the contents will be encrypted already.
To upgrade to the latest release of BitSharesX
First, delete the old build:
sudo rm -rf bitsharesx
Then repeat the steps above in the section titled: "Download BitShares X code from GitHub"
Skip the sections for installing Qt and node.js.
Then continue following instructions above starting with the section "nstall lineman and its dependencies in web_wallet folder using npm".
If you have problems with any of the above, then refer to the original instructions here.
If BitSharesX never synchronizes completelyIf you can launch BitSharesX and log in normally but it never completely synchronizes because it displays "Severe network problems | Last block is synced xx days old" at the bottom of the screen, then do the following:
- Using Ubuntu's GUI file browser, go to your Home folder.
- Copy the "BitShares X" folder and Paste it -- the new folder will be named "BitShares X (copy)" -- this is your backup in case things don't work properly.
- Open the "BitShares X" folder and delete everything except the "wallets" folder.
- Re-boot your VM.
- Launch BitSharesX -- it will take a while to respond. While you're waiting it will say "Not connected" in the lower right. Eventually it will start synchronizing... and that will take even longer because it will download the entire blockchain again.