Installation on Linux
Introduction
The purpose of this tutorial is to allow Linux users to run a Credits node with ease, and to teach them how to install, configure and manage it on a Linux Ubuntu 18.04 distribution.
You don’t need to have an IT background to run this tutorial!
Required Elements
- A Personal Computer
- Latest version of Credits Mainnet software
- Ubuntu (Ubuntu 18.04 is recommended)
Installation Instruction
1) Connect to your Linux machine.
2) First, be sure that your system is up to date by updating and upgrading it. Then install OpenJDK from repo
$ sudo apt-get update
$ sudo apt-get upgrade
$ sudo apt-get install default-jdk
Only type the commands that are shown in bold font. You can also make a copy-paste of those commands.
3) Dowlnload the Credits node software on your computer from Credits website with "wget" by following commands (the first one must not by typed if you already have installed “wget“ on your computer).
$ sudo apt install wget
$ sudo wget https://github.com/CREDITSCOM/node/releases/download/mainnet-4.2.531.15/Ubuntu18_Mainnet-4.2.531.15.tar.gz
4) Extract archive with the following command:
$ tar zxvf Ubuntu18_Mainnet-4.2.531.15.tar.gz
Be sure that you type the correct file name in your command, as it may change in the future, depending on the next releases name.
Launching the Network Node
Now that the Credits software is downloaded and extracted, it’s time to launch it, and make the initial settings.
1) Go to the “csnode“ directory:
$ cd csnode/
2) Then launch the node:
$ ./node
3) Type “g” to generate public and private keys, then press Enter.
4) When you will have pressed the “g” key, you will see a sequence of 24 words that you must carefully save in case of losing your private key. You can simply highlight these 24 words with your mouse pointer, right-click, choose “copy” and paste them in the text editor of your choice. Once it’s done, type Enter.
5) Then choose to Encrypt with password your private key file [1] by typing “1”, followed by Enter.
6) Now, you have the choice between two methods of encryption: the method of encryption by password (P) or the access method by indicating the path of a defined file (F).
7) Press “p” key (encryption method with a password), then enter your password, confirm it a second time and type Enter.
8) After having confirmed the chosen password a second time, you will have the option to display your public key and your “real” private key (unencrypted) for 10 seconds, by pressing the “s” key.
Once you have copied it, press Enter or any other key to continue the CS node boot process.
Don’t worry if you didn’t press the “S” key on time, because you will be able to show it again the next time you will relaunch your node.
9) The node is now starting.
10) After a while, The sync process will appear soon. Once it’s running, the first time it can take a while before your node is 100% synchronized, it's totally normal.
Closing a Credits node
If you need to close your Credits node, please press [CTRL+C] shortcut in order to close it properly. It will avoid database corruption when you will open it again.
Reinstalling a Credits node
If you want to reinstall your node, please first backup your files for a better safety (especially “NodePublic.txt” and “NodePrivate.txt” files, and “db” folder if you want to keep your database in order to save time during the next synchronization).
If you want to run your new node with your previous keys and database, just follow this steps: once you have launched your new node, stop it with [CTRL+C], then replace in “csnode” folder your public and private keys files, as well as the database folder (“db”), with the files you previously saved before the reinstallation.
Credits node version
If you want to know if your CS node software is up to date or need an upgrade to the last version, you can find which version of the CS node software you are running, type the following commands:
$ cd csnode/
$ ./node --version