Smartlog 0.5 peer and client installation
This chapter describes steps needed to install SmartLog version 0.5 to your own infrastructure. SmartLog is delivered as Docker images you can use to run your own containers. When all of the steps are done successfully, you have your own version of Smartlog up and running.
Prerequisites
Please see chapters Requirements and Migration before starting the installation or manual version update.
Install Docker and peer configuration
Install required packages
Install Docker and curl on CentOS 7 or RHEL7:
$ sudo yum install docker curl
$ sudo systemctl start docker
$ sudo systemctl enable docker
Peer configuration files
After we've created your organization, you will receive a passowrd protected 7z-file. Extract it to your workstation. Inside you will find a zip file that includes peer configuration files and certificates. These need to be transferred to server before installation.
Transfer your.organization.address.zip to server that will run peer container. You can use, for example, scp or WinSCP to do that.
When file is transferred, extract archive to your home directory on server:
$ unzip your.organization.address.zip
You will now have directory your.organization.address in your home directory.
Create directory for configuration files:
$ sudo mkdir -p /etc/hyperledger/ext_config
Copy everything under your.organization.address to directory you just created:
$ sudo cp -R your.organization.address/* /etc/hyperledger/ext_config/
Check everything is in place:
$ sudo ls -1 /etc/hyperledger/ext_config
You should see directory listing similar to this:
channel.tx
config.json
crypto-config
genesis.block
SmartlogMSPanchors.tx
Install and run SmartLog docker images
Credentials
Before you run the installer, you need to decide credentials for CouchDB database user. Store these somewhere safe, for example your password manager.
You will also need credentials to our Docker registry, which you should have received with the configuration files. Installer script in next step will ask for both of these when you run it.
Run the installer
You can now run the installer. Installer will ask you about your peers address, credentials to CouchDB and credentials to Docker registry. It will then setup network, removes old containers and finally pulls and runs latest version.
$ curl "https://projectsmartlog.gitlab.io/smartlog-installer/smartlog-installer.sh" | sudo bash
If installer lets you know everything is OK, you now have all Smartlog containers installed and running! If something went wrong, maybe you copypasted wrong credentials, worry not. You can just rerun the installer and it'll start from scratch. If you have problems or special use cases, see chapter Usage. When everything is running, you can read chapter Overview to get a better understanding about the technical details of Smartlog.
Add CouchDB credentials to configuration
Open config.json using your favourite text editor and replace couchDbUsername with your own and do the same for couchDbPassword.