Updating MOTAR Installation

Guide to updating your MOTAR Ghost Instance to the latest version.

CAUTION

The Platform Version tab has a version checker, will tell you when there is a new version available to update:

When a new version is available, (!) will show next to the Platform Version tab.

Note the Installed Version vs Available Version in the image below.

The Platform Version tab notes a new version is available.

Updating your MOTAR Ghost to the latest version is highly dependent on your installation method. Choose the method below that matches your installation. If you do not know what type of installation you have, consult your platform admin.

WARNING

Choose the guide based on your installation method:

HELM Installation

Upgrade

WARNING

To update the MOTAR version on your HELM install, run:

helm upgrade motar --version {new version} oci://harbor.dynepic.net/helmrepo/motar -f {yourvalues.yaml} -n motar

Uninstall/Upgrade

  • Backup your secrets file (secrets backup is not covered in this guide. If you need assistance on how to backup your secrets, refer to your IT administrator.

Once you have backed up everything, you can run:

helm uninstall motar -n motar

Once the uninstall process completes you can start the install process by running:

helm install motar --version {new version} oci://harbor.dynepic.net/helmrepo/motar -f {yourvalues.yaml} -n motar

If secrets were deleted you will need to destroy persistent volumes

If you uninstall MOTAR before updating, you will need to restore from backup. Follow this guide to restore your data: Backup & Restore Data


ARGO Installation

Update the MOTAR version number to in your settings to the latest version number listed in your Platform Verision tab.

See example below.


DOCKER Installation

Installing via Docker

  • Download the correct install package for your operating system.

  • If you do not have access to this link, please reach out to [email protected] for assistance.

If you want to shut down your instance during the update run:

docker compose down 

cd /path/to/motar/download/directory/motar-3.0.1-beta-docker-compose/EasySetup

Check and Configure Docker

  • Open your terminal window

    1. Search Terminal in Spolight or find it in Application > Utilities

  • Run the following command to check if Docker Compose is installed:

docker compose version
  • You should see a result like this example (your result may vary):

Docker Compose version v2.31.0-desktop.2
  • If no errors, continue, otherwise if you encounter a permission error, prepend sudo to the command:

sudo docker compose version
  • Make sure your Docker is running by typing:

docker ps
  • As an example, if docker is running, but there are no containers running you may see output like this (if you have containers running you may see additional details beneath these headings):

CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES
  • If you get the proper response, continue to Updating MOTAR Installation, otherwise if you encounter a permission error, use the sudo command:

sudo docker ps

With Docker running it is time to Configure your MOTAR Environment

Configure Your MOTAR Environment

While in Terminal, you will configure your MOTAR Docker package.

  1. Change directory to the location you saved the MOTAR docker compose install package from Updating MOTAR Installation

This is the folder where you saved your motar--docker-compose.tar.gz file.

cd /<path to motar-docker-compose package> # Change to your MOTAR download directory
# Example: cd /downloads/
  1. Unpack the MOTAR installation file (if you already unpacked the file, you may skip to step 3)

tar -xvf motar--beta-docker-compose.tar.gz
  1. Once the file is unpacked, you will need to change directory into the EasySetup folder.

cd motar--beta-docker-compose/EasySetup
  1. Before launching MOTAR, you'll need to copy sample environment files and update with your deployment’s specifics. Sample environment files are provided to help you get started.

cd /path/to/motar/download/directory/motar-3.0.1-beta-docker-compose/EasySetup
cp ../sample_env .env
cp ../sample_motar_env motar.env

For this demo the URL for your MOTAR intance will be set to "motarghost.com".

Deploying MOTAR with Docker Compose

  1. Ensure you are still in the EasySetup folder in Terminal

cd motar-X.X.X/EasySetup #Your installation directory
docker compose up -d # brings up the deployment in the background

You should see the following progress/message(s)

 ✔[+] Running 19/19
 ✔ Network motar_motar            Created 
 ✔ Container minio                Healthy 
 ✔ Container motar-traefik-1      Started 
 ✔ Container nats                 Started 
 ✔ Container dnsmasq              Started 
 ✔ Container postgres             Healthy 
 ✔ Container clamav               Started 
 ✔ Container db-init              Exited  
 ✔ Container obj_init             Exited  
 ✔ Container assets               Healthy 
 ✔ Container scanner              Started 
 ✔ Container devices              Started 
 ✔ Container hub                  Started 
 ✔ Container admin                Started 
 ✔ Container studio               Started 
 ✔ Container login                Started 
 ✔ Container studio-permissions   Started 
 ✔ Container hub-permissions      Started 
 ✔ Container devices-permissions  Started  

Configuring Network & Domain Routing

To ensure your client device can resolve domain names correctly, configure your DNS settings.

  1. Use the following Terminal command to backup your 'hosts' file:

cp /etc/hosts /etc/hosts_bak
  1. Append your 'hosts' file with the following command:

IP="127.0.0.1"
BASE_URL="motarghost.com"
echo "$IP admin.$BASE_URL hub.$BASE_URL studio.$BASE_URL devices.$BASE_URL api-minio.$BASE_URL  login.$BASE_URL console-minio.$BASE_URL minio" | sudo tee -a /etc/hosts

Last updated