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.
-
-
You can continue the upgrading procedure only when https://apps.apple.com/us/app/macos-ventura/id1638787999?mt=12 (URL) is accessible.
-
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.
-
Right-click the Parallels desktop icon and click the Check for Update option.
-
If you can see the most recent 19.x version, then update the version.
-
After a 19.x version upgrade, the window redirects to automatically reinstall the parallel tool.
-
Accept the default settings and restart the host system.
-
Open the VM after the host system parallels version is updated.
-
Open the virtual machine to automatically reinstall parallel tools.
-
Accept the defaults and restart the VM.
-
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.
-
Verify the Xcode version with the following command (both in host and VM).
-
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
-
-
-
-
After updating to Xcode 14.x, perform the following changes:
-
Go to the app folder and open the file connect/fastlane/base_fastlane.py.
-
Run
vim connect/fastlane/base_fastlane.py
-
-
Change
env['ITMSTRANSPORTER_FORCE_ITMS_PACKAGE_UPLOAD'] to false as follows:-
Set
env['ITMSTRANSPORTER_FORCE_ITMS_PACKAGE_UPLOAD'] = 'false'
-
-
-
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:
-
The host and VM macOS versions should point to Ventura.
-
The Xcode version should be pointing to 14.x.
-
Before upgrading the operating system, ensure that the versions of the following packages match.
-
brew -–version (both in host and VM)
-
node -–version (in VM)
-
npm -–version (in VM)
-
python -–version
-
-
Before upgrading the operating system, ensure that the versions of the following packages match.
-
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:
-
Shutdown the VM through the Parallels Control Center.
-
Navigate to Hardware > Network.
-
It should be a shared network.
-
Click Advanced. Select Virtio network adapter.
-
If it has an Intel adapter, set it to Virtio.
-
Restart the VM.
-
-
After doing so, if the issue persists, revert to the previous snapshot and contact the engineering team.
-