Scope
Updating the VIP Containers in your VIP system.
Description
The scope of this document is to assist you in manually updating your VIP containers on your VIP appliance, in the cloud or on your own provided hardware. There are multiple ways to update panels them selves. This document will not cover every way. Please read through the whole article before starting the process.
Things to do
To update your VIP Panels you must have access to the panels and portainer web access as well. To access portainer on your VIP system, navigate to your appliance IP address with port :9000 directly after the IP. For example:
If your IP address is 10.10.10.20, your access would be 10.10.10.20:9000
Once on the Web UI, you’ll need to sign in with your credentials. Navigate to the portainer settings section, then registeries.
You will need to add your Quay.io credentials into the registry just like so:
Now that you have access to pull the correct images from Quay into your portainer repository for use. We will need to pull the images you will use for the container on your system. To do so navigate to images, choose Quay, add the image path and name of the file you’ll be downloading.
Our images are usually named:
Intercom:latest, this will download the image needed for panels and vipserver.
Intercom-dashboard, this is for the dashboard program.
Beacon:latest, will download the beacon image for the signaling server
Coturn:latest, for the webrtc portion of your system for invites and audio.
***Note - unless told otherwise, please only pull the :latest tag for your images. Pulling :edge or a direct version could be considered beta and may cause your system issues while in use. Please check with support before pulling anything other than :latest tag.
If you receive an error or cannot pull an image, please check your credentials by signing into Quay.io. If you still have an issue, you may need to send a note to support@telosalliance.com to check your permission in Quay.
Now that you have the images downloaded, you can go to dashboard, navigate to the Zones tab, choose All Zones or the zone you’d like to work on. Choose the container tab and this will open the above window. You will see the newly pulled image here and when ready, choose update. This will start the update process for all panels in the system or zone.
You can check the version of the panel on the home page of the panel, like below.
If you have the need to update hardware panels or belt packs individually, or you do not have access to dashboard. Each panel and belt pack has its own individual update tool built into the maintenance tab of the Web UI.
You will need to know the IP address:port or domain/panel name to gain access to the device and the credentials for the panel or belt pack. Example:
Mydomain.com/vip1 or 10.10.10.30:18001
To update other containers outside of the panel variety. Navigate to portainer once more and sign in, choose the container your wanting to update. For this example we will be working on beacon container. Choose your beacon container and stop the running container.
Note - this will affect your systems operation.
You can choose duplicate/edit, this will take you into the config tab for the container, please be careful not to change any settings not needed going forward.
Only change the image we are going to use for the update. Change the beacon image section to beacon:latest or if instructed the direct version told by support.
Scroll down to the deploy the container button and choose it.
You may check the version of the container on its respective Web UI.
Once the latest images are in place and have been deployed. Updating will be easier in the future. You need only to go into the container you’d like, and choose Recreate. This will use the image within the :latest tag and push it to the container in use, updating the panel. This can be repeated in the future for updating any container.
For ease of updating multiple panels at once, you can still update panels from the Zones section within dashboard.
Note - Coturn does not have a web ui, so you will have to trust it is on the latest image and in use.
If you have trouble pulling the latest image, you may need to go into the registry and add your credentials for quay.io into the settings.