• Overview of Kyndryl Cloud Uplift
  • Service limits for Kyndryl Cloud Uplift
• Access requirements
• Creating environments
  • Creating an environment from a template
    • Using public templates
  • Copying environments
  • Copying environments with running VMs (live clone)
    • Quiescing VM activity
  • Building a VM from an ISO
• Importing VMs
  • Preparing Power LPARs for import
  • Preparing x86 VMs and vApps for import
    • Creating MD5 hash values for VM imports
  • Importing VMs using the VM Imports page
    • Retrying a failed import
  • Importing Power LPARs
    • Importing IBM i workloads using NIS
    • Importing IBM i workloads using IBM Cloud Storage Solutions for i (ICC)
    • Importing IBM i workloads using direct transfer
    • Creating an AIX VM from a mksysb image
    • Creating a mksysb from an AIX VM in Kyndryl Cloud Uplift
    • Downloading and importing IBM-hosted AIX VMs
    • Additional ways to import Power LPARs
  • Testing imported VMs
  • Resolving import errors
• Running and stopping VMs
• Accessing VMs
  • Accessing VM desktops from a browser
    • Testing access requirements with Connectivity Checker
    • Using audio with a VM
      • Troubleshooting VM audio
    • Using an SSH connection in a browser client session
    • Copy and paste text between the local machine and a VM
    • Insert text into a Power VM
    • Keyboard shortcuts for browser client views
    • Improving browser client performance
    • Optional URL parameters for sharing an SRA browser client view
  • Accessing VMs with RDP
• Transferring files to a VM
  • Adding and sharing files with the Assets page
  • Using ISO files
  • Using ISO files with an AIX LPAR
  • Using Kyndryl Cloud Uplift public assets
• Editing environments and environment networks
  • Adding VMs to an environment
  • Multi-attach storage for Power VM environments
  • Locking environments
• Editing VMs
  • Hardware settings for IBM i VMs
    • Editing vCPUs and RAM for IBM i VMs
    • License settings for IBM i VMs
      • Overview of Assure MIMIX™ Software on Kyndryl Cloud Uplift VMs
        • Assure MIMIX™ Software pre-installation test
        • Installing Assure MIMIX™ Software on VMs
      • VM pinning
      • IBM i default license program packages (LPPs)
      • IBM i optional license program packages (LPPs)
  • Hardware settings for AIX and Linux on Power VMs
    • Editing vCPUs and RAM for AIX and Linux on Power VMs
    • License settings for AIX and Linux on Power VMs
  • Hardware settings for x86 VMs
    • Editing vCPUs and RAM for x86 VMs
    • Enabling nested virtualization
    • Upgrading VM hardware versions
    • Using an international keyboard layout with a VM
    • Editing VM BIOS clock sync settings
    • Enabling audio for a VM
    • Adding or extending a virtual disk
    • Deleting a virtual disk
    • Enabling SSH on a VM for use in SRA browser client sessions
  • VM network settings
    • Attaching VMs to networks
    • Adding secondary IP addresses
    • Editing VM MAC address
    • Editing VM hostname or primary IP address
    • Enabling promiscuous mode
    • Using static IP addresses
  • Storing VM credentials
  • Licensing the guest OS
  • Installing and upgrading VMware Tools - Linux
  • Installing and upgrading VMware Tools - Windows
  • Improving operating system or application performance within the VM
• Using containers in Kyndryl Cloud Uplift
  • Getting started with containers
  • About the container host
  • Creating a container host
    • Enable IP address forwarding for a container host
  • Adding containers to a container host
  • Managing individual containers
  • Containers: Known issues
  • Troubleshooting the VM Agent
• Managing networks
  • Network overview
    • Default host-naming behavior
    • What is the difference between automatic and manual networks?
  • Viewing the network topology for an environment
  • Using multiple networks in an environment
    • Creating an automatic network
    • Creating a manual network
    • Routing between networks in the same environment
    • Avoiding restricted subnets and IP addresses
  • Networking between environments
    • Using NAT to avoid IP address conflicts
  • Editing an automatic network
    • Editing the network NAT subnet
  • Connecting an environment network to a VPN or Private Network Connection
  • Manually configuring domain name servers
  • Exposing and blocking public Internet access to VMs
    • Accessing VMs with published services
      • Adding published services
      • Connecting to a published service
      • Troubleshooting my connection to a published service
      • Removing a published service
      • Example - Accessing VMs with RDP
      • Example - Accessing VMs with SSH
    • Using public IP addresses
      • Attaching a static public IP address to a VM
      • Adding a managed DNS name and public IP address to a VM
      • Editing a managed VM DNS name
      • How does Kyndryl Cloud Uplift generate the VM DNS name?
      • Detaching a static public IP address or DNS name from a VM
      • What is the difference between static public IP addresses and dynamic public IP addresses with DNS?
      • Troubleshooting issues connecting to a public IP address or managed DNS name
    • Issue - I can’t access the public Internet from my VM.
  • Deleting a network
  • Moving a VM to a different environment
  • Deleting VMs
• Sharing VMs and environments with sharing portals
  • Creating a sharing portal
    • Overview of sharing portal options
    • How to create custom HTML content for a sharing portal
    • Custom content tab – starter templates
    • Custom content tab - allowed HTML
  • Using a VM or environment from a sharing portal URL
  • Finding and sharing the URL for a sharing portal
  • Exporting sharing portal information and URLs
  • Disabling or deleting a sharing portal
• Sharing resources with projects
  • Creating and deleting projects
  • Adding and removing environments
  • Adding and removing templates
  • Adding and removing assets
  • Adding and removing users
  • Adding and removing groups
  • Understanding project roles
  • Finding project resources
• Adding a shared template to your account
• Saving an environment as a template
  • Copying a template
  • Deleting templates
• Understanding regions
  • Changing your default region
  • Copying an environment to another region
  • Copying a template to another region
  • What to expect when you copy an environment or template
• Managing your account settings
  • Changing your password
  • Changing your user account time zone
  • Finding your primary administrator
  • Finding your user role
  • Finding your user name and API token
  • Resetting your API token
• Viewing your current usage and usage limits
  • Viewing recent activity for an environment
• Best practices
  • Automating VMs and environments
    • Automatically suspend or shut down inactive environments
      • Sending keep-alive messages from a VM
      • Troubleshooting automatic shutdown
    • Automating actions with schedules
      • Adding a new schedule to an environment or template
      • Editing an existing schedule
      • Deleting a schedule
    • Controlling the order of VM startup with VM sequencing
    • Accessing the VM metadata service
  • CI/CD reference architectures
    • Jenkins build farm
    • Functional test environments
    • Systems integration test environments
  • IBM i Data Protection and Resiliency Solutions
    • IBM i backup and restore
    • IBM i disaster recovery and high availability
  • Creating recovery copies of VMs and environments
  • Disaster recovery reference architectures
    • On-premises data center to Kyndryl Cloud Uplift – cold recovery
    • On-premises data center to Kyndryl Cloud Uplift – warm recovery
    • Kyndryl Cloud Uplift region-to-region – cold recovery
    • Kyndryl Cloud Uplift region-to-region – warm recovery
  • Monitoring your usage with email notifications
  • Organizing resources with labels and tags
    • Adding and removing labels for environments
    • Adding and removing labels for templates
    • Adding and removing labels for VMs and other resources
    • Adding and removing tags for environments
    • Adding and removing tags for templates
    • Error messages for tags and labels
  • Security best practices
  • Using Kyndryl Cloud Uplift for demos
  • Using Kyndryl Cloud Uplift for training classes
    • Choosing an environment architecture and remote connection method
    • Creating class lab environments
    • Best practices for preparing student VMs
    • Preparing for and delivering a training class
• Knowledge base
  • Security improvements: Deprecation and end of life (EOL) notices
  • How to add notes to VMs, environments, templates, and assets
  • How to change the name of a VM
  • How to change the name or description of an environment
  • How to check VM hardware version
  • How to connect to a VM from an iPad or iPhone
  • How to connect to Kyndryl Cloud Uplift using a private WAN connection
  • How to delete environments
  • How to export a list of environments, templates, or assets
  • How to export VMs
  • How to find the ID for a VM, VPN, environment, or template
  • How to find the Instance URL for a Kyndryl Cloud Uplift on Azure account
  • How to find the IP addresses for a VM
  • How to find the network gateway IP address
  • How to find your user name and API security token
  • How to generate an API security token for your account
  • Guide to the Dashboard
  • Protecting a VM that is exposed to the internet or compromised
  • Time zones and UTC offsets
  • Understanding storage
  • Using search
  • Using Windows in Kyndryl Cloud Uplift
    • Fixing duplicate SID errors for Windows networking
    • Resolving prompts to reactivate a Windows license
    • Running a Windows domain
  • Using Power VMs in Kyndryl Cloud Uplift
    • Differences between Power and x86 VMs
    • IBM i FAQ
    • Viewing system reference codes for an IBM i VM
    • Applying PTFs to an IBM i VM in Kyndryl Cloud Uplift
    • Manually refreshing IBM i licenses
    • Refreshing IBM i licenses with LICKEY
    • Booting an AIX VM into maintenance mode
    • Configuring TCP/IP network settings for an AIX VM
    • Connecting to an AIX VM with X Windows
    • Importing Power VM
    • Known issues for Power VMs
    • Preserving AIX disk numbering with ghostdev
    • Overview of Assure MIMIX™ Software
  • Editing VMs outside of Kyndryl Cloud Uplift
    • Compressing VMX files to OVA for import
    • Converting a physical machine to a VM
    • Converting non-VMware-based VMs for import
    • Converting OVF files to VMX for use with VMware Converter
  • Troubleshooting connections to a VM from a Windows 10 computer?
• Troubleshooting

Installing Precisely Assure MIMIX™ Software on Kyndryl Cloud Uplift VMs

The Precisely Assure MIMIX™ Software package supports the following minimum IBM i OS release levels (note the Technology Refresh level as well):

• IBM i 7.3 TR 11
• IBM i 7.4 TR 5
• IBM i 7.5 Base release
• IBM i 7.6 Base release

IBM i 7.2 and older levels aren’t supported.

Installing Assure MIMIX™ Software

This article describes how to install the most current version of Precisely Assure MIMIX™ Software software on Kyndryl Cloud Uplift VMs.

Assure MIMIX™ Software installation prerequisites

Before you install Assure MIMIX™ Software:

• Contact Kyndryl Cloud Uplift Support to enable HA/DR support for your account.

• For each Kyndryl Cloud Uplift VM that you plan to install Assure MIMIX™ Software on, make sure that Enable Assure MIMIX for IBM i is checked.

  

• For each Kyndryl Cloud Uplift VM that you plan to install Assure MIMIX™ Software on, make sure that Java is installed–either Java 11 (64-bit) or Java 17 (64-bit) from the Licensed Program Product (LPP): IBM I 5770JV1.
• Assure MIMIX™ Software requires an automatic network in the Kyndryl Cloud Uplift environment for both installation and operation. If your environment doesn’t have one, you can add a Kyndryl Cloud Uplift automatic network alongside any existing environment networks.
• Make sure that the Kyndryl Cloud Uplift environment that contains the VM that you plan to install Assure MIMIX™ Software also contains a Windows VM.

• Review the System values required for installing.
• Use high-power user profiles, such as *SECOFR on both the local and remote systems to install Assure MIMIX™ Software.

Step 1 – Apply recommended PTFs

Apply current recommended PTFs to both VMs.

• Run CHKIBMPTF on your partitions to determine which PTFs you should apply. More information can be found here: Checking systems for recommended IBM PTFs

The Assure MIMIX™ Software installation process automatically runs the included version of CHKIBMPTF on both Kyndryl Cloud Uplift VMs—local and remote—and notes any missing PTFs.

The version of CHKIBMPTF included with the installer may not be the most current version. We strongly recommended that you download and run the most recent stand-alone version.

Step 2 – Install Precisely Assure MIMIX™ Software

Every Assure MIMIX™ Software installation requires both a local Kyndryl Cloud Uplift VM and a remote Kyndryl Cloud Uplift VM. The local system can be the production system, but it doesn’t have to be. If you have an existing Assure MIMIX™ Software installation and configuration, the configuration must reside on the primary system. You don’t need to manually download the Assure MIMIX™ Software installer.

Kyndryl Cloud Uplift supports four distinct configurations of Assure MIMIX™ Software

• New Precisely Assure MIMIX™ Software instance on two Kyndryl Cloud Uplift VMs(where Assure MIMIX™ Software has not been previously installed). Use RMTNODE(<node-name>) when prompted on INSCFGMMX.
• Assure MIMIX™ Software installation libraries transferred from other LPARs via save/restore or similar means. The Kyndryl Cloud Uplift Assure MIMIX™ Software installation will overwrite the existing installations but will preserve much of the critical configuration information from the node where the installation is performed. Use RMTNODE(<node-name>) when prompted on INSCFGMMX.
• Assure MIMIX™ Software instance on a single Kyndryl Cloud Uplift VM, and then the addition of an external node. You must manually configure other nodes and you set RMTNODE(*NONE) on the INSCFGMMX prompt.
• Addition of a Kyndryl Cloud Uplift VM to an existing Assure MIMIX™ Software instance. Assure MIMIX™ Software uses the configuration on the previously installed node and you set RMTNODE(*INSTALLED) on the INSCFGMMX prompt.

Preparing the environment for Assure MIMIX™ Software installation

The Assure MIMIX™ Software installation is initiated from the Windows VM.

To start the installation

From a web browser in the Windows VM, visit Assure MIMIX software downloads for Kyndryl Cloud Uplift and follow the steps listed on the page.

If the installer detects an existing Assure MIMIX™ Software installation, it will provide an opportunity to upgrade it.

Next steps

You may have to update additional settings, based on your configuration of Assure MIMIX™ Software.

New Assure MIMIX™ Software configuration

If this is a new Assure MIMIX™ Software installation, the installation process automatically creates an initial configuration based on system replication best practices. You may need to create additional replication configurations as appropriate. See the Assure MIMIX™ Software product documentation or engage a certified Assure MIMIX™ Software consultant.

Added Assure MIMIX™ Software node configuration

If this is a new Assure MIMIX™ Software node that you added to an active Assure MIMIX™ Software installation with the option RMTNODE(*INSTALLED) set, this new node will be added to the existing configuration and the system manager activated. You may need to create additional replication configurations. See the Assure MIMIX™ Software product documentation or engage a certified Assure MIMIX™ Software consultant.

Single Assure MIMIX™ Software node installation

If this is a new, single Assure MIMIX™ Software node, installed with the option RMTNODE(*NONE) set, you must manually configure the installation to combine it with other Assure MIMIX™ Software nodes. See the Assure MIMIX™ Software product documentation or engage a certified Assure MIMIX™ Software consultant.

Connecting to Assure Unified Interface (AUI) with a browser

After the Assure Unified Interface (AUI) server is running, you can use a web browser to view the AUI server at: https://<hostname>:8410. You’ll need to add a portal connection to access the Assure MIMIX™ Software installation. See the Before configuring from the Assure UI portal for more details about using the AUI.

Getting more help

Assure MIMIX™ Software documentation

Assure MIMIX™ Software product documentation.

The Kyndryl Cloud Uplift-specific information provided by this document supersedes some information in the general Assure MIMIX™ Software documentation set.