Installation

On this page

• Build Requirements

• Build Tools

• Install Go

• Install the binaries

  • Build Tags

• Work with a ICTech SDK Clone

• Next

This guide will explain how to install the ICPlazad binary and run the cli. With this binary installed on a server, you can participate on the mainnet as either a Full Node or a Validator.

Build Requirements #

At present, the SDK fully supports installation on linux distributions. For the purpose of this instruction set, we’ll be using Ubuntu 20.04.3 LTS. It is also possible to install ICPlazad on Unix, while Windows may require additional unsupported third party installation. All steps are listed below for a clean install.

1. Update & install build tools

2. Install Go

3. Install ICPlazad binaries

Build Tools #

Install make and gcc.

Ubuntu:

sudo apt-get update

sudo apt-get install -y make gcc

Install Go #

::: tip Go 1.18+ or later is required for the ICTech SDK. :::

We suggest the following two ways to install Go. Check out the official docs and Go installer for the correct download for your operating system. Alternatively, you can install Go yourself from the command line. Detailed below are standard default installation locations, but feel free to customize.

Go Binary Downloads

Ubuntu:

At the time of this writing, the latest release is 1.18.2. We’re going to download the tarball, extract it to /usr/local, and export GOROOT to our $PATH

curl -OL https://golang.org/dl/go1.18.2.linux-amd64.tar.gz

sudo tar -C /usr/local -xvf go1.18.2.linux-amd64.tar.gz

export PATH=$PATH:/usr/local/go/bin

Remember to add GOPATH to your $PATH environment variable. If you’re not sure where that is, run go env GOPATH. This will allow us to run the ICPlazad binary in the next step. If you’re not sure how to set your $PATH take a look at these instructions.

export PATH=$PATH:$(go env GOPATH)/bin

Install the binaries #

Next, let’s install the latest version of ICTech. Make sure you git checkout the correct released version.

git clone -b <latest-release-tag> [e-mail]:ICPlaza/ICPlaza.git
cd ICPlaza && make install

If this command fails due to the following error message, you might have already set LDFLAGS prior to running this step.

# github.com/ICTechDAO/cmd/ICPlazad
flag provided but not defined: -L
usage: link [options] main.o
...
make: *** [install] Error 2

Unset this environment variable and try again.

LDFLAGS="" make install

NOTE: If you still have issues at this step, please check that you have the latest stable version of GO installed.

That will install the ICPlazad binary. Verify that everything installed successfully by running:

ICPlazad version --long

You should see something similar to the following:

name: ICPlaza
server_name: ICPlazad
version: v7.0.0
commit: 07f9892a927f451ae204d0c9d1a5601d8fc232a5
build_tags: netgo,ledger
go: go version go1.18 linux/amd64

Build Tags #

Build tags indicate special features that have been enabled in the binary.

Build Tag	Description
netgo	Name resolution will use pure Go code
ledger	Ledger devices are supported (hardware wallets)

Work with a ICTech SDK Clone #

To work with your own modifications of the ICPlaza SDK, make a fork of this repo, and add a replace clause to the go.mod file. The replace clause you add to go.mod must provide the correct import path:

• Make appropriate changes

• Add replace github.com/ICTechDAO/ICPlaza-sdk => /path/to/clone/ICPlaza-sdk to go.mod

• Run make clean install or make clean build

• Test changes

Next #

Now you can join the mainnet

← Introduction

Join Mainnet →