Administration

Setup

A process is already listening on port 5432 (Binary)

Problem:

After running installLisk.sh, the installation script is aborted with the following output:

Error: A process is already listening on port 5432
PostgreSQL by default listens on 127.0.0.1:5432 and attempting to run two instances at the same time will result in this installation failing
To proceed anyway, use the -i flag to ignore warning.

PostgreSQL is already installed on your system and listening to the PostgreSQL default port 5432.
This can happen e.g. when a second Lisk Core node is installed on the same server.

Solution 1:

Change the port of your already installed PostgreSQL instance to an unused and available port number.
Locate the corresponding configuration file for PostgreSQL, postgresql.conf, and change the port to e.g. 5433.

locate postgresql.conf

After changing the config, restart the corresponding PostgreSQL process.
Now, the 2 PostgreSQL instances shouldn't interfere each other anymore.

Solution 2:

The error can be ignored by setting the ignore flag -i.
In that case, the installation script installLisk.sh will be executed regardless of the above error.
The script might run successfully to the end, but ignoring the error might result in unwanted interferences between the different PostgreSQL instances.

bash installLisk.sh install -r main -i

Solution 3:

If PostgreSQL has been installed globally on the system, disable it:

sudo systemctl stop postgresql
sudo systemctl disable postgresql

Possible data inside of databases remains stored in this case.

Solution 4:

If PostgreSQL has been installed globally on the system and the data in it is not needed anymore, simply remove the already installed PostgreSQL by running the following command:

Role "lisk" does not exist (Source)

Problem:

Starting the Lisk node fails with error:

error: role "lisk" does not exist

Lisk Core expects a Postgres user called "lisk" exists on the system and has the rights to create database.
This user is specified in config.json.
If the user is not present on the system, the above error will be thrown.

Solution 1: create lisk user (recommended)

Create a Postgres user with name "lisk" and grant it the right to create databases.

sudo -u postgres createuser --createdb lisk

Solution 2: change db.user from "lisk" to custom username

Edit config.json and replace the value "lisk" in db.user with an alternative postgres username on the system, that has the right to create databases.

Nothing shown in console after starting Lisk Core (Source)

Problem:

After installing from Source and starting Lisk Core with npm start, no are logs visible in the console.
This is, in fact, an expected behavior, as the default console logging value in the config is none, which means no logs are shown in the console after starting the process.

Solution:

To verify, that your installation works as expected, you can change theconsoleLogLevel to error, info or debug.
Alternatively, you can check the log files located in logs/, which are on info logging level by default.

Administration

Enable forging: Delegate not found

Problem:

When trying to activate forging on your node, it answers with Delegate with publicKey: xyz not found

Solution 1: Node still syncing

Check the current height of your Node and compare it with the Height in Explorer.
If your Nodes' height is significantly lower than the height shown in the Explorer, it means your Node is still syncing / downloading the Lisk Blockchain. At this time, enabling forging might fail, because the Delegate registration has not been downloaded, yet.
To solve it, just wait until your Node is fully synced.

Solution 2: Missing data in config

Check your config.json in section forging.delegates.
If you want to enable forging for a particular delegate on your node, you need to store an object with the delegates' publickey and encrypted passphrase in that section as described here.

Enable forging: Invalid password and public key combination

Problem:

When trying to activate forging on a node like described in section Configuration, it responds with: {"message":"\"Invalid password and public key combination\""}.

Solution:

As the message states, the provided combination of your delegates publicKey and the password don't seem to be valid. Please ensure, both properties are set to the correct values, especially that you don't use the original passphrase of your account with that command.

We further explain the chosen naming in order to avoid confusion:

Passphrase is always referring to your 12 word long mnemonic passphrase that was created at the same time as your Lisk ID. You should always keep this secure and private! For communication with the API, the passphrase is not passed in plaintext. Instead the password is passed so you use it to encrypt your passphrase and the encrypted passphrase is stored in your config.

Password is always referring to the secret word/s you use to encrypt your passphrase symmetrically, like described in this section

Should you have any further queries please reach out to one of the team or the Lisk community on Lisk Discord.

What's next?

When accessing our website, we obtain and process your personal data. We also use cookies to improve your experience on our site. To find out more about our use of your data, read our updated privacy policy To continue using our website, click „I accept“.