Updating MOTAR Installation

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

CAUTION

Before updating MOTAR, you should take a backup of your instance. See: Backup & Restore Data

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

Updating the platform version requires some degree of technical knowledge pertaining to your company's server architecture and installation method.

Please review the steps below and if you are unsure of any of the steps, DO NOT PROCEED, reach out to your company administrator or Contact Us!

Choose the guide based on your installation method:

HELM Installation

Upgrade

WARNING

If you did not provide secrets for HELM install, do NOT delete the secrets . The update process will recreate secrets and motar won't be able to access your data.

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

# Replace {new version} with the latest release number (e.g. 1.2.3)
# Replace {yourvalues.yaml} with your Helm values file

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

Uninstall/Upgrade

If you uninstall instead of upgrade, you need to backup your secrets and your instance first!

• 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.

• Backup your MOTAR Instance: Backup & Restore Data

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:

# Replace {new version} with the latest release number (e.g. 1.2.3)
# Replace {yourvalues.yaml} with your Helm values file

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

The relevant secrets will persist (do not delete the ones that stayed)

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

The following guide is for Docker installtion/update on a Linux/Mac machine. For Windows machines, see the Tutorial setup installation guide: Commercial-Use Installation & Setup Tutorial

For an easier install process, download the MOTAR Installer for Windows:

https://dyn-downloads.s3.us-east-1.amazonaws.com/MOTAR.Installer.exedyn-downloads.s3.us-east-1.amazonaws.com

Instructions can be found here: MOTAR Installer for Windows

Installing via Docker

• Download the correct install package for your operating system.

  • https://github.com/Dynepic/MOTAR/tree/main/Docker-Installation-Packages

• 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 

Take note of where you download the MOTAR installation package because you will need it to configure the MOTAR Environment.

---

# Replace <version-number> with the MOTAR version you downloaded (e.g., 1.2.3)
cd /path/to/motar/download/directory/motar-<version-number>-beta-docker-compose/EasySetup

Check and Configure Docker

Before running Docker commands, ensure the Docker desktop app is running.

• 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

If you still encounter an error or do not see the expected output (see below), please follow Docker’s documentation for fixing your Docker or Docker Compose.

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-3.0.1-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)

# Replace <version-number> with the MOTAR version you downloaded (e.g., 1.2.3)
tar -xvf motar-3.0.1-beta-docker-compose.tar.gz

1. Once the file is unpacked, you will need to change directory into the EasySetup folder.

cd motar-3.0.1-beta-docker-compose/EasySetup

For other more advanced options, replace the child sub-directory with ‘SelfProxy-Advanced’ or ‘EasyDNS’. This walk-through will only provide instructions for ‘EasySetup’.

Reach out to [email protected] with questions.

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.

#Replace <version-number> with the MOTAR version you downloaded (e.g., 1.2.3)
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".

MOTAR images are hosted in Dynepic’s private Harbor repository. Follow these steps to authenticate

Deploying MOTAR with Docker Compose

MOTAR can be deployed in different configurations. Choose the setup that best suits your needs.

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

#Replace <version-number> with the MOTAR version you downloaded (e.g., 1.2.3)
cd motar-<version-number>/EasySetup #Your installation directory
docker compose up -d # brings up the deployment in the background

Deployment of MOTAR on your local machine will take 3-5 minutes.

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  

Launching a browser window may direct your admin page to https:// to avoid this, launch in a private window. This should keep the path http://

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