Ivanti incapptic Connect OS Upgrade

Ivanti incapptic Connect instances (host and VM) macOS can now be upgraded to version 13.x (Ventura) from 12.x (Monterey) using the below procedure.

If there are any errors during the upgrade process, please revert to the previous snapshot and contact the engineering team.

Prerequisites

Before you begin upgrading, you must fulfill the following prerequisites:

  • Take a snapshot of both the host and the virtual machine.

    • For host machines, take time machine backup.

    • For VM, take a parallel snapshot.

  • Make a note of the following package versions:

    • brew -–version (both in host and VM)

    • node -–version (in VM)

    • npm -–version (in VM)

    • python -–version

Procedure

Proceed only if both a time machine backup and a parallels (VM) snapshot are taken.

Update Parallels version on host machine

You have to update the parallels version to 19.x, as Ventura is supported by this version.

  1. Right-click the Parallels desktop icon and click the Check for Update option.

  2. If you can see the most recent 19.x version, then update the version.

  3. After a 19.x version upgrade, the window redirects to automatically reinstall the parallel tool.

  4. Accept the default settings and restart the host system.

  5. Open the VM after the host system parallels version is updated.

  6. Open the virtual machine to automatically reinstall parallel tools.

  7. Accept the defaults and restart the VM.

  8. After restarting the VM, you can see the following icon on your desktop.

MacOS Upgrade

Proceed only if both a time machine backup and a parallels (VM) snapshot are taken.

You must first upgrade the host operating system (OS), followed by the VM OS. The upgrade procedure can take up to 4-5 hours, depending on the internet connection and VPN connections.

1. Open a Web browser and navigate to the following URL:
https://apps.apple.com/us/app/macos-ventura/id1638787999?mt=12.

2. Click Open App Store.

3. Click Get. The macOS Venture window opens.

4. Click the Download to get Ventura OS.

5. Click Continue, and then click Agree.

6. Click Continue.

7. Enter the system password and click Unlock.

The Venture OS installs and then restarts the system. After restarting the machine, you can see that the system has been updated to Ventura OS.

If the system prompts you to update Xcode to version 14.x, perform the steps according to the prompts. Alternatively, perform the following steps:

Xcode Version Update

After updating MacOS to Ventura, Xcode should be automatically updated to 14.x.

  1. Verify the Xcode version with the following command (both in host and VM).

    1. Run the following command in the terminal
      /usr/bin/xcodebuild -version

      • If the above command returns version 14.x, skip the following steps:
        Perform the steps in the Post installation checklist section.

      • If the above command displays an error given below, skip the following steps:
        Perform the steps in the Post installation checklist section.

        • xcode-select: error: tool 'xcodebuild' requires Xcode, but the active developer directory '/Library/Developer/CommandLineTools' is a command line tool instance.

      • If the above command returns version 13.x, execute the following instructions in the VM terminal:

        • softwareupdate –l

        • It will display the available Xcode version. Copy this version and use the following command: Replace 14.2 in the following command with the available 14.x Xcode version.

        • getosupd=$(softwareupdate -l | grep "Xcode-14.2" | awk NR==1 | cut -d ' ' -f 3-)

        • sudo softwareupdate -i "$getosupd" -R

      • Entering the system password will initiate the download and installation of Xcode. After Xcode is downloaded, restart the system.

      • To check the version after restarting, run:

        • /usr/bin/xcodebuild -version

  2. After updating to Xcode 14.x, perform the following changes:

    1. Go to the app folder and open the file connect/fastlane/base_fastlane.py.

      • Run
        vim connect/fastlane/base_fastlane.py

    2. Change env['ITMSTRANSPORTER_FORCE_ITMS_PACKAGE_UPLOAD'] to false as follows:

      • Set
        env['ITMSTRANSPORTER_FORCE_ITMS_PACKAGE_UPLOAD'] = 'false'

  3. After making the above changes, save the changes. Restart the services by executing the following commands in the terminal:

    • launchctl stop connect.gunicorn

    • launchctl stop connect.celery.worker

    • launchctl stop connect.celery.beat

    • launchctl start connect.gunicorn

    • launchctl start connect.celery.worker

    • launchctl start connect.celery.beat

Checklist for Post-Installation

After the macOS upgrade is completed, you must ensure that it was successful.

To ensure that the upgrade was successful:

  1. The host and VM macOS versions should point to Ventura.

  2. The Xcode version should be pointing to 14.x.

  3. Before upgrading the operating system, ensure that the versions of the following packages match.

    1. brew -–version (both in host and VM)

    2. node -–version (in VM)

    3. npm -–version (in VM)

    4. python -–version

  4. Before upgrading the operating system, ensure that the versions of the following packages match.

  5. Log in to the UI and check all tabs.

Known issue when upgrading mac OS

After upgrading the VM, if the CPU is overloaded or the machine becomes unresponsive, do the following steps:

  1. Shutdown the VM through the Parallels Control Center.

  2. Navigate to Hardware > Network.

    1. It should be a shared network.

    2. Click Advanced. Select Virtio network adapter.

      • If it has an Intel adapter, set it to Virtio.

      • Restart the VM.

    3. After doing so, if the issue persists, revert to the previous snapshot and contact the engineering team.