In this article we will look into how to upgrade from Skedler version 4.x to the latest version in RPM based Linux environments such as CentOS, RHEL, Rocky Linux. 

Note: Install Skedler in a new folder (default folder for Skedler v5 is /usr/share/skedler-xg) on the same machine as your Skedler v4 environment.   Do not overwrite your Skedler v4 environment so that you can still run your Skedler v4 if there are any problems with the upgrade.    

Install Pre-requisites

sudo yum -y update
sudo yum install -y fontconfig libnss3.so libnssutil3.so libXcomposite.x86_64 libXrandr.x86_64 libXdamage.x86_64 libxkbcommon.x86_64 libdrm.x86_64 atk.x86_64 at-spi2-atk.x86_64 cups-libs.x86_64 mesa-libgbm.x86_64 gtk3.x86_64 alsa-lib.x86_64 gcc make clang

sudo dnf install -y libxshmfence (only for Rocky Linux)

(For Centos 8+ and RHEL 8+)
sudo yum install libxshmfence

Install Skedler .rpm package

Download the latest skedler .rpm file and extract it. 

curl -LO https://web-api.skedler.com/downloads/latest/skedler-xg.rpm
sudo rpm -i skedler-xg.rpm

Install Skedler .tar.gz package

If you prefer to install using the .tar.gz package, download the latest skedler-xg.tar.gz file and extract it.

curl -LO https://web-api.skedler.com/downloads/latest/skedler-xg.tar.gz
sudo tar xzf skedler-xg.tar.gz
cd skedler-xg
sudo chmod -R 777 *

Configure reporting.yml

To configure the upgrade settings edit the reporting.yml file in the skedler-xg folder.

For .tar.gz 

sudo nano reporting.yml

For .rpm

sudo vi /usr/share/skedler-xg/reporting.yml

Configure the following required information in the reporting.yml.  These parameters are required for migrating from Skedler 4.x to 5.x:

• oldSkedlerBasePath - The absolute path to your Skedler Reports 4.x.  This path should be accessible from the v5 environment. 
  
• migrationSourceDatasource - The database that you are using in Skedler Reports 4.x. The values can be ‘elasticsearch’, ‘mysql’, ‘sqlite'.
• migrationSourceDatastorePath - If you were using sqlite as the database in v4, enter the path to your Skedler Reports 4.x sqlite database.
• Enable and configure the below variables only if you used mysql as the database in Skedler Reports 4.x.

  • migrationDatabaseHost

  • migrationDatabasePort

  • migrationDatabaseName

  • migratoinDatabaseUsername

  • migrationDatabasePassword

  • migrationDialect

• Enable and configure the below variables only if you used elasticsearch as the database in Skedler Reports 4.x.

  • elasticsearchUrl - The Elasticsearch url configured in Skedler v4.x

  • skedlerIndex - The Elasticsearch index configured in Skedler v4.x

  • elasticsearchAuthType - The authentication type, if any, for the configured Elasticsearch.

  • skedlerElasticsearchUsername - Enable and configure if authentication is present.

  • skedlerElasticsearchPassword - Enable and configure if authentication is present

In addition, you can configure other options to run Skedler in an air-gapped environment, change the port number, define the hostname, change the location for the Skedler database, and log files.  Read more about the reporting.yml configuration options.  

Save the reporting.yml file and exit the editor.

Start migration

After configuring the reporting.yml file, start the upgrade process.  

For .tar.gz 

sudo bin/migrate

For .rpm

cd /usr/share/skedler-xg
sudo bin/migrate

Start Skedler for .rpm

To start Skedler, the command is:

sudo service skedler start

To check status, the command is:

sudo service skedler status

To stop Skedler. the command is:

sudo service skedler stop

Start Skedler for .tar.gz 

To run Skedler manually, the command is:

sudo bin/skedler

To run Skedler as a service, the commands are:

sudo ./install_as_service.sh

To start Skedler, the command is:

sudo service skedler start

To check status, the command is:

sudo service skedler status

To stop Skedler. the command is:

sudo service skedler stop

Access Skedler Reports

The default URL for accessing Skedler Reports is:

http://localhost:3005/ 

If you had made configuration changes in the reporting.yml, then the Skedler URL is of the following format:

http://<hostname or your domainurl>:3005 

or 

http://<hostname or your domain url>:<port number>

Login to Skedler Reports

Sign in using the following credentials:

Default username: [email protected]
Default password: admin 

Click Sign in.  

Next step: Proceed to License Activation