Installation

Prerequisites

  • Java 11+.
  • To be able to run a Postchain node: PostgreSQL 10.

Using a full Rell Eclipse IDE bundle

Rell Eclipse IDE can be downloaded here: https://www.chromia.dev/rell-eclipse/index.html.

Note. For MacOS, M1 is currently not supported. The Rell plugin should be installed separately in this case. See the next section.

Download an archive for your OS.

  • Linux: unpack, run eclipse
  • Windows: unpack, run eclipse.exe
  • MacOS: open the DMG image, run or install Eclipse.

Adding the Rell plugin to an existing Eclipse IDE installation

If you already have an Eclipse IDE (for example, Eclipse IDE for Java), the Rell plugin can be added to it. (Eclipse can be downloaded here.)

  1. Go to the menu Help - Install New Software…

  2. In the Install dialog, click Add…, then type:

    ../_images/install_add_site.png
  3. Rell shall appear in the list. Select it and click Next >, then Finish.

    ../_images/install.png
  4. When seeing a warning “You are installing software that contains unsigned content”, click Install anyway.

  5. Click Restart Now when asked to restart Eclipse IDE.

  6. Switch to the Rell perspective. Menu Window - Perspective - Open Perspective - Other…, choose Rell.

    ../_images/menu_perspective_crop.png

Next step is to create a Rell project (see Hello World Program).

How to update the Rell plugin

When a new version of the Rell plugin is released, it has to be updated in Eclipse. If Rell update URL has already been configured, Eclipse will check for updates automatically once in a while, and show a message when a plugin can be updated.

To manually check for updates:

  1. Menu: Help - Check for Updates.
  2. If it shows that a new version of Rell plugin is available, install it.

If “No updates found” message is shown, check that Rell update site is set up.

../_images/update_no_updates_found.png
  1. Click available software sites link in the message dialog.

  2. If there is no Rell in the list, click Add… to add it.

    ../_images/update_available_software_sites.png
  3. Specify:

    and click Add.

If Rell update site is in the list, but “No updates found” message is shown, try to reload the site:

  1. Click available software sites link in the message dialog.
  2. Click Reload.

If still no updates are shown, your Rell plugin must be already up-to-date.

Database Setup

Rell requires PostgreSQL 10 to be installed and set up. The IDE can work without it, but will not be able to run a node. A console app or a remote postchain app can be run without a database, though.

Default database configuration for Rell is:

  • database: postchain
  • user: postchain
  • password: postchain

Ubuntu (Debian)

Install PostgreSQL:

sudo apt-get install postgresql

Prepare a Rell database:

sudo -u postgres psql -c "CREATE DATABASE postchain;" -c "CREATE ROLE postchain LOGIN ENCRYPTED PASSWORD 'postchain'; GRANT ALL ON DATABASE postchain TO postchain;"

MacOS

Install PostgreSQL:

brew install postgresql
brew services start postgresql
createuser -s postgres

Prepare a Rell database:

psql -U postgres -c "CREATE DATABASE postchain;" -c "CREATE ROLE postchain LOGIN ENCRYPTED PASSWORD 'postchain'; GRANT ALL ON DATABASE postchain TO postchain;"

Note

If you get an error saying that peer authentication failed, you will have to change authentication method from peer to md5. this can be done inside the pg_hba.conf file of your psql database.