How to update your on-premises server

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

To check which on-premise server version you're currently running, follow these steps:

  1. Go to the admin dashboard of your server
    http://IP_OF_VM:8081
  2. Log in with your credentials. By default, the following credentials are set
    • Username: admin
    • Password: admin123
  3. On the "Status" page of your server's dashboard, you will see the version under "Server info" in the top-left corner

marked-server-version

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 v7:

After logging in to the console, execute the following command: 

  1. Establish a terminal connection with the server
    cd /opt/visionect/
  2. 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 v7:

 

  1. Establish a terminal connection with the server
    cd /opt/visionect/
  2. Remove the current docker-compose.yml file
    sudo rm docker-compose.yml
  3. Download the new docker-compose.yml file
    sudo wget https://storage.googleapis.com/joan-public-files/knowledge%20base%20files/Docker%20Compose/docker-compose.yml
  4. 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:

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.

 

Service not running after the upgrade

The service might have issues with running after the upgrade. This is due to the database migration of the status packages in the service. This can take quite some time, especially in case your database is a few GB in size. 

The migration is not important for Joan's services to work and does not contain any meeting data. The information migrating are the charts of the devices such as "Disconnects", "RSSI", "Battery"...

 

To speed up the upgrade process you can simply follow the instructions below:

cd /opt/visionect 
sudo docker-compose down
sudo docker-compose up -d

Ubuntu 16.04

If your VM is running the server on the Ubuntu 16.04 version, you have two options:

  1. Due to the outdated OS version, we would recommend replacing the VM with a new VM from the knowledge base. The new version of VM is using the 20.04 Ubuntu OS version.
  2. Since we have noticed that Postgres version 12 has issues running on the outdated OS, please use Postgres version 9.6. Below you can find the instructions for using an older Postgres.

Edit the docker-compose file in order to use an older Postgres version so you can get the service running. To do that, please follow the instructions below:

  1. navigate to the visionect folder:
    cd /opt/visionect/
  2. stop the server:
    sudo docker-compose down
  3. edit the docker-compose.yml file with nano and lock the version to 9.6:
    sudo nano docker-compose.yml
  4. find the line:
    vserver_postgres:
    image: postgres:12
    restart: always
  5. Edit to look like this:
    vserver_postgres:
    image: postgres:9.6
    restart: always
  6. save the file and run the following commands:
    sudo docker volume prune 
    sudo docker-compose pull
    sudo docker-compose up -d

In case you still don't see the services running, please reach out to the support team and they will be more than happy to help.

If the services are running you should see the message “Could not pair device on this server”, in that case simply follow the instructions in the knowledge base article