Quick start

This walkthrough summarizes the installation order of the Riversoft® STCP Gemini components on an Enterprise Linux server. The details of each step are in Installation and Configuration.

Note

If Riversoft STCP DirectLink is already installed, the database, the repository, the API and the Portal are already in place: start at the Create the instance in the Portal step.

Tip

Just want to try the product? Use the Docker test environment, which runs complete Riversoft STCP Gemini and Riversoft STCP DirectLink installations in containers, with no server to prepare.

Prerequisites:

Server with a supported operating system and administrator (root) access. See Requirements.
Supported database, available and reachable from the server.

Prepare the database

Download the script package for your DBMS and run the scripts in numerical order. See Database preparation.

Configure the Riversoft repository

curl https://repo.riversoft.com.br/configs/riversoft-el9.repo \
  --output /etc/yum.repos.d/riversoft-release.repo
dnf clean all && dnf makecache

Use the file that matches your system version (el8, el9 or el10).

Install and start the Riversoft STCP Gemini API

dnf install -y stcpgemini-api
cp /usr/local/stcpgemini-api/configs/example-config.json /usr/local/stcpgemini-api/configs/config.json

Adjust config.json (databases, port and certificate) and start the service:

systemctl start stcpgemini-api

Install the Riversoft Console Portal

dnf install -y stcpgemini-portal

Set the Portal EntryPoint to the API address. See Portal configuration.

Create the instance in the Portal

Open the Portal at the API address, sign in with the default administrator operator (stcpadmin) and change the password. Create the instance that Riversoft STCP Gemini Server will run, or use the Riversoft STCP DirectLink instance. See First access.

Install and start Riversoft STCP Gemini Server

dnf install -y stcpgemini-server
cp /usr/local/stcp/configs/example-stcpserver.config.json /usr/local/stcp/configs/stcpserver.config.json

Set ApplName to the name of the instance created in the Portal and fill in the configuration database details. Then start the service:

systemctl start stcpgemini-server
systemctl status stcpgemini-server

Expected result: the Riversoft STCP Gemini API, the Riversoft Console Portal and Riversoft STCP Gemini Server running, with the instance created in the Portal active on the server.

For file routing and automation, also install Riversoft STCP Gemini Rename on the same server as Riversoft STCP Gemini Server.

Next steps

Configuration

Operation

Riversoft STCP Gemini Rename

Docker test environment