Installing Smart Chain Software From Source Code
The basic Indexchain software package includes two applications.
Indexchain
The Indexchain software application is the Smart Chain daemon that powers all Indexchain blockchains.
Both are Installed Automatically
Both of these software applications are installed in the ~/komodo/src/
directory as a part of any of the following installation procedures.
The Two Methods to Install Smart Chain Software
There are two methods available to install Smart Chain software.
Pre-compiled Binaries
You can download and unzip our pre-compiled binaries. This is the simplest method and requires no installation procedure.
For more information on this method, please see the link below.
Link to simple installations section for pre-compiled executables
Building Smart Chain Software From Source
You may also build Smart Chain software from source.
This is not required, but building from source is considered the best practice in a production environment, as this allows you to instantly update to the latest patches and upgrades.
Linux
Requirements
Linux (easiest with a Debian-based distribution, such as Ubuntu)
For Ubuntu, we recommend using only the 16.04 or 18.04 releases
64-bit Processor
Minimum 32GB HDD or SDD storage space
Minimum 4GB of free RAM (8GB+ recommended)
Get Started
Verify that your system is up to date.
Install the dependency packages
This action takes some time, depending on your Internet connection. Let the process run in the background.
Once completed, follow the steps below to install Indexchain.
::: tip Note At some point during the installation process, you will see a warning, "libgmp headers missing". This can safely be ignored. :::
Clone the Indexchain Repository
Fetch the Zcash Parameters
Build the Indexchain Daemon
In the command below, the -j$(nproc)
parameter instructs the script to utilize all available processors in your hardware.
Alternatively, you may instruct the script to use only a set number of processors. For example, -j8
instructs the script to use 8
processors, -j4
instructs the script to use 4
processors, etc.
This script can take some time.
Create the komodo.conf File
With the komodo.conf
file open in the Nano text editor, add the following lines.
(Create your own rpcuser
username and rpcpassword
password.)
Press CTRL+O
to save the changes.
Press CTRL+X
to exit the Nano editor.
Start the komodod
daemon. It will automatically begin syncing with the network.
The &
parameter in the last instruction above instructs the terminal to continue allowing you to enter commands within this terminal shell.
(Optional) Tail the Indexchain Daemon
Enter the following command to "tail" the Indexchain daemon. The tail
command allows you to view the debug.log
file updates in real time.
Test Your Daemon with komodo-cli
Ensure that your current working directory is in the default src
directory.
You may now use the komodo-cli
software to send API (RPC) calls to the komodod
daemon.
For example:
This command returns the latest state information about the DIC blockchain and your wallet.dat
file.
When the blocks
and longestchain
values are equal to each other, your machine is in sync with the network.
Backup your wallet
We can not stress enough the importance of backing up your wallet.dat
file.
On Linux, the file is located here: ~/.komodo/wallet.dat
One method to backup this file is to archive a copy of the file.
MacOS
Requirements
OSX (version > 10.11)
Minimum 4GB of free RAM (8GB+ recommended)
Ensure Command Line Tools are Installed.
Issue the following command in a terminal.
Ensure brew is Installed
We use the software brew
to install dependencies. If you have the latest version of brew
installed already, you may skip this step.
Use brew to Install Dependencies
Execute each command separately
Clone the Komodo repository
Fetch the Zcash Parameters:
Compile Komodo
This can take some time.
While this process proceeds, open a new terminal for the next step.
Create Configuration File
Create the configuration file in the following directory:
If the directory does not yet exist, create the directory.
Create the configuration file by entering the following commands in the terminal. Execute each line separately.
Run Indexchain
Once all processes are complete, run the Indexchain daemon.
Track the Syncing Progress
Using the tail Command
Using komodo-cli and getinfo
When the returned properties of blocks
and longestchain
are equal to each other, the daemon is finished syncing with the network.
Backup Your Wallet
We can not stress enough the importance of backing up your wallet.dat
file.
On MacOS, the file is located here: ~/Library/Application\ Support/Komodo/wallet.dat
One method to backup this file is to archive a copy of the file.
Windows
The Windows software for komodod
and komodo-cli
files are slightly different than their MacOS and Linux counterparts in two ways.
The Windows software cannot be directly compiled on a Windows machine. Rather, the software must be compiled on a Linux machine (Ubuntu recommended), and then transferred to the Windows machine
You can use a Virtual Machine-based installation of Ubuntu Linux, running on a Windows machine, as a solution
The names of the software are
komodod.exe
andkomodo-cli.exe
Once you have access to an Ubuntu machine and have access to a terminal with sudo privileges, you are prepared to continue the installation process.
Install dependencies
Install Rust
Configure the compiler to use POSIX thread model
Execute:
After executing the above command, select the POSIX option.
Execute:
After executing the above command, select the POSIX option.
Clone the Indexchain Repository
Fetch the Zcash Parameters
Build the Indexchain Daemon
In the command below, you may instruct the script to use only a set number of processors. For example, -j8
instructs the script to use 8
processors, -j4
instructs the script to use 4
processors, etc.
This script can take some time. Once completed, you will find komodod.exe
& komodo-cli.exe
files inside the src
directory.
Transfer these 2 executable files to your Windows computer and place the files in a new folder on the Desktop called DIC or any other location you prefer (remember the location and use that). For this guide we are using DIC
directory on Desktop.
Open a command prompt for the following steps.
Create the Indexchain Directory
Create the Configuration File
When the software dialogue box opens, click Yes
to create the komodo.conf
file.
Copy the information below and paste it into Notepad.
After pasting, save and exit Notepad.
Create the Directory for the Zcash Parameters
Download following files and move them into the new directory.
Run Smart Chain Software
Verify Syncing Progress
Backup Your Wallet
We can not stress enough the importance of backing up your wallet.dat
file.
On Windows, the file is located here: %HOMEPATH%\AppData\Roaming\Komodo\wallet.dat
One method to backup this file is to create a copy and archive it.
Last updated
Was this helpful?