On-premises Joan users should periodically upgrade their servers to the most recent software version to further improve Joan's stability and performance, as well as upgrade the system settings and device firmware. The updates are easy and don’t take more than a couple of minutes.
- How to check the current server version
- How to upgrade Joan’s server if the current version is higher than v5.2
- How to upgrade Joan's server if the current version is between v2 and v5.2
- How to upgrade Joan's server from v2 to the latest version
How to check the current server version
To check which on-premise server version you're currently running, follow these steps:
- Go to the admin dashboard of your server
http://IP_OF_VM:8081
- Log in with your credentials. By default, the following credentials are set
- Username: admin
- Password: admin123
- On the "Status" page of your server's dashboard, you will see the version under "Server info" in the top-left corner
Upgrade Joan's server software to the latest version
To update Joan's server software to the latest version, please login into the server console. You can use the VM console or SSH.
The default credentials are:
- Username: joan
- Password: joanaccess
Once you are successfully logged in, follow the steps below.
Upgrade Joan's server software if the current version is higher than v5.2:
After logging in to the console, execute the following command:
- Establish a terminal connection with the server
cd /opt/visionect/ - Start the new server
sudo docker-compose pull vserver && sudo docker-compose up -d vserver
And that's it! You have successfully upgraded your VSS server to the latest version.
Upgrade Joan's server software if the current version is between v2 and v5.2:
- Establish a terminal connection with the server
cd /opt/visionect/ - Remove the current docker-compose.yml file
sudo rm docker-compose.yml
- Download the new docker-compose.yml file
sudo wget https://storage.googleapis.com/joan-public-files/knowledge%20base%20files/Docker%20Compose/docker-compose.yml
- Start the new server
sudo docker-compose pull vserver redis && sudo docker-compose up -d vserver redis
And that's it! You have successfully upgraded your VSS server to the latest version.
Upgrade Joan's server software from v2 to the latest version:
Since v2 of the Visionect Software Suite (VSS) server, there have been quite a few updates and improvements. So, if your server is still running on v2, it is not possible to simply update the server's version, due to the changes in its structure.
In order to upgrade Joan's server software from v2 to the latest version, you will have to download the latest Virtual Machine (VM) server image from the links below:
- If you're using VMware or VirtualBox: Download the virtual machine here (.ovf and .vmdk)
- If you're using Hyper-V: Download the .vhd image here
As you will be using a new VM image, you will have to pair your Joan devices once again in the Joan Portal.
If you will need assistance with the pairing process, you can always reach out to us at support@getjoan.com and we will do our best to assist you.
While not mandatory, we advise you to keep the existing VM image as a backup in case the upgrade does not go as planned.