Supported Version

This update process applies to the following deployment type:

zman-2.0.x - ISO based deployment

Overview

This article explains how to update a zMan Director ISO-based deployment to a newer zMan version. To update zMan Director, log in to the zMan Director ISO-installed system through SSH, exit the zMan Console Menu, copy the deployment update package to the system, extract the package, and run the deployment update script.

After the update completes, log out of zMan Director and log back in. Existing settings and profiles should remain available after the update.

Log In to the zMan Director System

1. Connect to the zMan Director ISO-installed system through SSH.

2. Log in using the appropriate root credentials.

User: root
Password: <root-password>

3. After login, the zMan Console Menu appears.

4. Enter 0 to select Exit.

Switch to the Vagrant Directory

After exiting the zMan Console Menu, switch to the /home/vagrant/ directory.

cd /home/vagrant/

Download and Extract the Deployment Update Package

1. Download the deployment update tar file from the provided FTP location.

2. Copy the tar file to the desired location inside the zMan Director system.

The deployment update package should use the following naming format:

deployment-zman-2.0.x.tar

3. Extract the contents of the tar file.

tar -xvf deployment-zman-2.0.x.tar

4. After extraction, navigate to the setup directory.

cd deployment-zman-2.0.x/setup

Run the Deployment Update Script

Once inside the setup directory, run the deployment update script.

./setup_deploy_update.sh

Important Note

The previous zMan directory must already exist on the system.

The installer validates the previous zMan path before continuing. If the specified directory does not exist, the update process stops with an error.

Confirm the Update Completed Successfully

When the update script finishes successfully, zMan Director is updated to the new version.

Log Back In to zMan Director

After the update completes:

1. If you are already logged in to zMan Director, log out.

2. Open a browser.

3. Log back in to zMan Director using your credentials.

Verify Existing Settings and Profiles

After logging back in, verify that the previous zMan settings and profiles are still available.

Additional Tenant Note

During a zMan update, the internal zDM for the default zman-tenant is updated automatically.

If the environment has an additional tenant, a separate zDM instance exists for that tenant. The corresponding zDM must also be updated to the latest version to ensure proper zMan functionality.