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.

results matching ""

    No results matching ""