Community Tester Install Guide for Factom Federation (M2)
This will walk you through setting up the experimental distributed version of Factom.
Prepare Operating System
The most testing to date has been done under Linux. To get the best testing experience, it should be done on Linux. That will also help us recreate the bugs you experience better. If you are running Windows, please install a virtual machine to run Factom. Installing on Windows has been known to work, but is not covered here.
Here are some good directions to get a virtual machine installed with Linux. http://www.instructables.com/id/Introduction-38/?ALLSTEPS
The following are assuming you are using the 64 bit version of Ubuntu, or one of its descendant projects like xubuntu or mint.
Install the go language and dependencies, then setup GOPATH
Install Package Managers
In a terminal window, install Git
sudo apt-get install git
On Mac: Steps 1 and 3 should be enough in this tutorial: https://confluence.atlassian.com/pages/viewpage.action?pageId=269981802
Download latest version of go https://golang.org/dl/ This example uses 64 bit Linux and 1.10.3 is the latest tested version.
sudo tar -C /usr/local -xzf go1.10.3.linux-amd64.tar.gz
On Mac, installing go this way should work: http://www.cyberciti.biz/faq/installing-go-programming-language-on-mac-os-x/
Put the go binary directory in you path. Also add the GOPATH to your profile.
Open the file
~/.profile and add these lines to the bottom. If they are not exact, then your Linux may not be bootable.
export PATH=$PATH:/usr/local/go/bin export GOPATH=$HOME/go export PATH=$PATH:$GOPATH/bin
logout and login. This is the most straightforward way to run/test these changes. Run
go version from a terminal to verify the install.
Currently, the blog post here has some screenshots of what to expect Factom Federation (M2) to look like.
These steps will get factom installed onto a linux machine. The steps should be similar for mac.
# install glide, the package dependency manager go get -u github.com/Masterminds/glide # download the code git clone https://github.com/FactomProject/factomd $GOPATH/src/github.com/FactomProject/factomd git clone https://github.com/FactomProject/factom-cli $GOPATH/src/github.com/FactomProject/factom-cli git clone https://github.com/FactomProject/factom-walletd $GOPATH/src/github.com/FactomProject/factom-walletd git clone https://github.com/FactomProject/enterprise-wallet $GOPATH/src/github.com/FactomProject/enterprise-wallet # To use the unstable development branch, uncomment these lines # This is primarily for developers who are updating factom itself # Leave alone to get the tested, released version. cd $GOPATH/src/github.com/FactomProject/factomd # git checkout develop cd $GOPATH/src/github.com/FactomProject/factom-cli # git checkout develop cd $GOPATH/src/github.com/FactomProject/factom-walletd # git checkout develop cd $GOPATH/src/github.com/FactomProject/enterprise-wallet # git checkout develop # get the dependencies and build each factom program glide cc cd $GOPATH/src/github.com/FactomProject/factomd glide install go install -ldflags "-X github.com/FactomProject/factomd/engine.Build=`git rev-parse HEAD` -X github.com/FactomProject/factomd/engine.FactomdVersion=`cat VERSION`" -v cd $GOPATH/src/github.com/FactomProject/factom-cli glide install go install -ldflags "-X main.FactomcliVersion=`cat VERSION`" -v cd $GOPATH/src/github.com/FactomProject/factom-walletd glide install go install -ldflags "-X github.com/FactomProject/factom-walletd/vendor/github.com/FactomProject/factom/wallet.WalletVersion=`cat ./vendor/github.com/FactomProject/factom/wallet/VERSION`" -v cd $GOPATH/src/github.com/FactomProject/enterprise-wallet glide install go install -v cd $GOPATH/src/github.com/FactomProject/factomd # done. factomd should be installed # you can optionally use a config file to run in a non-standard mode # mkdir -p ~/.factom/m2/ # cp $GOPATH/src/github.com/FactomProject/factomd/factomd.conf ~/.factom/m2/
Note: currently factomd uses a lot of drive accesses when running. It is reccomended to hold the blockchain on a solid state drive. Running factomd on a spinning hard drive will be arduously slow. Factomd currently scans the entire blockchain the first time it is started after if downloads the blockchain, bootup takes a while the first two times, but it is faster after is downloads and is restarted once. You can watch the progress on the Control Panel.
Most users will want to run either the API wallet factom-walletd or the GUI wallet enterprise-wallet. Directions for those are located here: https://docs.factom.com/wallet#run-the-factom-foundation-wallet
Although the factomd API is backwards compatible, the API extended by the old API wallet, fctwallet, is not supported by factom-walletd. The entire wallet from M1 can be imported into factom-walletd using the -i flag and an empty ~/.factom/wallet directory.
Some users will want to use the old fctwallet with the new factomd. Follow the directions here to compile the old programs.
You can run a local version of factomd to get greater flexibility by running it like this:
This will make a new blockchain without worrying about other's data interfering with your testing. You can use the key
factom-cli importaddress Fs1KWJrpLdfucvmYwN2nWrwepLn8ercpMbzXshd1g8zyhKXLVLWj to get local Factoids after starting factom-walletd.
For issues with the software, please post here.