Upgrade Ubuntu Server to V3.5
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
Warning
Any data that is not backed up will be lost!
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/ ./www
Log 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/row64server
Config 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/ ./conf
Uninstall Server Version 3.4
Warning
Please ensure that your data is properly backed up before proceeding. While this guide outlined backing up the data to a new Backup directory on the same system, you can safely back up your data to a different location, if desired.
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:
row64server-3.5_amd64.deb
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
Restore 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.
Note
The Row64 config JSON file may have have new fields in the updated version. We recommend manually copying over the settings you want to keep from your backed up version of the 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:
Tip
You can start the row64server service with the following command:
sudo systemctl start row64 server
You can stop the row64server service with the following command:
sudo systemctl stop row64server
Run Test Examples
To fully verify operability, follow the Test Examples guide to run dashboard tests.