This page describes how to upgrade Row64 Server on Ubuntu from Version 3.4 to Version 3.5. It is critical to back up your data during this process, as any data that is not backed up will be lost.
This page applies to users who have Server V3.4 and would like to upgrade to V3.5. If you do not have Server V3.4 and simply wish to configure a fresh installation of Server V3.5, you can safely skip this page.
Backup
Dashboard and Dataframe Files
The /var/www directory contains dashboard and dataframe data. It also contains the web client files.
The following table describes where important file types are stored:
| File type | Location |
|---|---|
| Dashboard files | /var/www/dashboards |
| Dataframe files | /var/www/ramdb |
| Web files | /var/www/html |
Back up these files to another folder, computer, or USB drive. In this walkthrough, we will simply make a new directory, called Backup, and copy the files there.
After using the following commands, the Backup directory will be created at the following location: /usr/Row64/
In the Ubuntu terminal, use the following commands to create a new directory called Backup and move the needed files:
cd /usr/Row64/
mkdir Backup
cd Backup
cp -r /var/www/ ./wwwLog Files
Row64 Server logs are located at: /var/log/row64server
You will need to back up these log files. Copy these to your backup location. In this walkthrough, we will copy them to the Backup directory. Use the following commands to copy the Log files to the Backup directory:
cd /usr/Row64/Backup
mkdir log
cp -r /var/log/row64server/ ./log/row64serverConfig File
The Row64 configuration file is located: /opt/row64server/conf/config.json
Use the following commands to copy the configuration file to the Backup directory:
cd /usr/Row64/Backup
cp -r /opt/row64server/conf/ ./confUninstall Server Version 3.4
Stop the Row64 Server service: sudo systemctl stop row64server
Remove the Row64 Server: sudo dpkg -r row64server
Install Server Version 3.5
Find the latest Ubuntu Server installer from the Downloads site. Alternatively, you can use the following link for the direct download:
Open a terminal in the directory the installer downloaded to (i.e. Downloads), and use the following command: sudo dpkg -i row64server-3.5_amd64.deb
Connect
Run the following command to execute the Connect_Ubuntu.py script, which is needed before the Server will run:
sudo python3 /opt/row64server/install/Connect_Ubuntu.pyRestore the Configuration File
The new installation of Row64 Server will overwrite the config file at the following location: /opt/row64server/conf/config.json
Open your backed up version of the old config file and copy its settings to the new config file.
Start the Row64 Server Service
Reload systemctl: sudo systemctl daemon-reload
Start the service: sudo systemctl start row64server
Verify Operability
Run the following command to see if row64server is running: sudo systemctl status row64server
If successful, your terminal should resemble the following:
Run Test Examples
To fully verify operability, follow the Test Examples guide to run dashboard tests.