Installing and upgrading Precisely Assure MIMIX™ Software on Skytap 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.5 Base release
  • IBM i 7.4 TR 5
  • IBM i 7.3 TR 11

IBM i 7.2 and older levels aren’t supported.

Installing Assure MIMIX™ Software

This page describes ways to install Precisely Assure MIMIX™ Software software on Skytap VMs.

If you already have an operational Assure MIMIX™ Software installation and want to upgrade to a newer software level of Assure MIMIX™ Software, see Upgrading Assure MIMIX™ Software Software.

Contents

Assure MIMIX™ Software installation prerequisites

Before you install Assure MIMIX™ Software:

  • Contact Skytap Support to enable HA/DR support for your account.
  • For each Skytap VM that you plan to install Assure MIMIX™ Software on, make sure that Enable Assure MIMIX for IBM i is checked.
  • Assure MIMIX™ Software requires an automatic network in the Skytap environment for both installation and operation. If your environment doesn’t have one, you can add a Skytap automatic network.

    enable mimix

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

    The *SECOFR user profile has the required permissions.

Apply current recommended PTFs to both VMs.

The Assure MIMIX™ Software installation process automatically runs the included version of CHKIBMPTF on both Skytap 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 Skytap VM and a remote Skytap 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.

Skytap supports four distinct configurations of Assure MIMIX™ Software

  • New Precisely Assure MIMIX™ Software instance on two Skytap 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 Skytap 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 Skytap 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 Skytap 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.

To start the installation

For all installations except for single VM, run these commands on the remote system (where the installation is not being run):

  1. Type STRTCPSVR *REXEC and press Enter to start the REXEC server.
  2. Type STRTCPSVR *FTP and press Enter to start the FTP server.

If the remote system has an existing Assure MIMIX™ Software configuration, it must be a management (*MGT) system.

On the local install system:

  1. Sign in using a high-power profile (as described in Prerequisites).
  2. Type CALL QCMD and press Enter.
  3. Type CHGJOB CCSID(37) DECFMT(*BLANK) and press Enter to change the CCSID of the job to 37.
  4. Press F11 to expand the command input to full screen.
  5. Press F10 to include detailed messages (this is a toggle PF key).
  6. Copy the following command, paste it to the command window, and then press Enter:
/******** ISSUE 'CHGJOB CCSID(37) DECFMT(*BLANK)' BEFORE RUNNING ******/
RUNSQL COMMIT(*NONE) SQL('BEGIN DECLARE C CLOB(2G) CCSID 1208; DECLARE M
CHAR(2000);DECLARE EXIT HANDLER FOR SQLEXCEPTION BEGIN CALL QCMDEXC(
''QSH CMD(''''rm -rf /qsys.lib/qgpl.lib/cldrqs.dtaara'''')'');SET M=
REPEAT('' '',135) CONCAT''ERROR MXINS: SEE SKYTAP MIMIX INSTALLATION GU''
CONCAT ''IDE FOR FURTHER INFO'' CONCAT REPEAT('' '',90) CONCAT ''ERROR'';
SIGNAL SQLSTATE ''MXINS'' SET MESSAGE_TEXT=M;END;SET C=REPEAT(UX''0020'',
690000000);CALL QCMDEXC(''CHGJOB CCSID(37)'');CALL QCMDEXC(''QSH CMD(''''
rm -rf /qsys.lib/qgpl.lib/cldrqs.dtaara'''')'');CALL QCMDEXC(''CRTDTAARA
QGPL/CLDRQS TYPE(*CHAR) LEN(10) VALUE(INSTALL)'');CALL QCMDEXC(''QSH CMD(
''''rm -rf /qsys.lib/qgpl.lib/inscfgmmx.file'''')'');CALL QCMDEXC(''
CRTSAVF QGPL/INSCFGMMX'');SET C = QSYS2.HTTP_GET(
''http://gw/skytap?feature=hadr&request=installer&provider=precisely'');
CALL QSYS2.IFS_WRITE_BINARY(''/qsys.lib/qgpl.lib/inscfgmmx.file'',
LINE=>BASE64_DECODE(TRIM(T UX''000D''FROM TRIM(T UX''000A''FROM C))),
FILE_CCSID=>37, OVERWRITE=>''REPLACE''); SET C = '''';CALL QCMDEXC(
''LODRUN *SAVF SAVF(QGPL/INSCFGMMX)''); END') DECMPT(*PERIOD)

This command downloads the main installer from the Skytap repository. After a short delay, the INSCFGMMX command displays:

  • If Assure MIMIX™ Software isn’t installed, you’ll see the default values.
  • If Assure MIMIX™ Software is already installed, type the name of the Assure MIMIX™ Software installation library and press Enter. The installer uses the values from the existing configuration.
  • Provide the required values and press Enter.

    Press F1 to see the available help.

                    Install and Configure MIMIX (INSCFGMMX)
Type choices, press Enter.
Installation library . . . . . . > MIMIX         Name
Local node information:
  System def. name for MIMIX . . LPAR1         Name
  Role for replication . . . . . *PRIMARY      *PRIMARY, *BACKUP, *SAME
  Host name or address . . . . . *NODE
  Port number or alias . . . . . 50410
Remote node information:
  System def. name for MIMIX . . LPAR2         Name
  Role for replication . . . . . *BACKUP       *PRIMARY, *BACKUP, *SAME
  Host name or address . . . . . *NODE
  Port number or alias . . . . . 50410
  User profile . . . . . . . . . *CURRENT      Character value, *CURRENT
  Password . . . . . . . . . . . ________
Product-level sec. additions:   _
  User profile . . . . . . . .   *NONE         *NONE, Name
  MIMIX PLS level. . . . . . .   _____         *OPR, *DSP, *MGT, *ADM...
  Lic Mgr. PLS level . . . . .   _____         *NONE, *DSP, *OPR, *MGT...
             + for more values _
System to start AUI server . .   *NONE         *NONE, *ALL

F3=Exit  F4=Prompt  F5=Refresh  F12=Cancel  F13=How to use this display

Assure MIMIX™ Software is installed on the remote system first, unless you specify *INSTALLED for Remote node information (RMTNODE). Information displays on the local system about how to find the job where this occurs.

After Assure MIMIX™ Software is successfully installed on the remote system (if required), installation begins on the local system. Status messages display at the bottom of the screen during this process.

The installation process may take several minutes depending upon the available resources on both systems.

If installation is complete for two nodes, the Assure MIMIX™ Software system managers start. You can use the Assure MIMIX™ Software WRKSYS command to verify the status of the system managers.

If you requested it on the INSCFGMMX prompt, the AUI VSP servers start.

The AUI servers may take a few minutes until they are ready to accept connections.

If the Assure MIMIX™ Software installation fails with a file size or timeout error

Determine if the failure occurred during the API request.

From an IBM i 5250 session (SSH Secure Shell Protocol – A cryptographic protocol that provides a secure channel over an unsecured network. You can use an SSH connection during an SRA browser session. view for IBM i VMs in Skytap):

  1. Type SIGNOFF and press Enter.
  2. Type SIGNON and press Enter.
  3. Type CHGJOB CCSID(37) and press Enter.
  4. Type STRSQL and press Enter.
  5. Paste the following 3 lines:

     select cast( QSYS2.HTTP_GET(
     'http://gw/skytap?feature=hadr&request=installer&provider=precisely') AS VARCHAR(1000) CCSID
     1208) RESPONSE from sysibm.sysdummy1
    
  6. Press Enter to view the first 1000 characters of the installer file. If you see an error value similar to {"error":"An error occurred. Contact Skytap support. (ECCAFFA7)"}, see Alternate Mimix/Skytap Silent Install notes for alternate installation instructions.

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.

Upgrading Precisely Assure MIMIX™ Software software (from version 10.0.20.00 or higher)

This section describes how to upgrade an existing operational Assure MIMIX™ Software installation where one or more nodes of the installation reside on Skytap VM and is enabled via Skytap.

If your Assure MIMIX™ Software installation version is 10.0.19.00 or earlier (use the LAKEVIEW/WRKPRD command to see the version information) then your first upgrade will require a different process, which will be described later.

The upgrade is done with the UPGMMX command. You have the choice of upgrading all nodes (this is the default and is highly recommended) or only upgrading the local node. In addition, you can choose whether or not to start the Assure MIMIX™ Software managers and AUI.

To upgrade Assure MIMIX™ Software:

  1. Type ENDMMX *IMMED and press Enter to stop Assure MIMIX™ Software on all nodes.
  2. Type WRKOBJLCK <installlib> *LIB and press Enter to verify that only the PORTxxxxx job is running for each node.

    You may have to wait for all jobs to end after ENDMMX *IMMED completes.

  3. Sign out and sign in using a high-power profile (see Prerequisites) to a Skytap Assure MIMIX™ Software-enabled node.

    If there are more than two nodes in the installation, you must sign in to a *MGT node.

  4. If the Assure MIMIX™ Software installation library is present in your library list, type RMVLIBLE <mimixLib> and press Enter to remove it.
  5. Type CHGCURLIB QGPL and press Enter to change the current library to QGPL.
  6. Type <installLib>/UPGMMX and press Enter to begin the upgrade.

    You can press F4 to change the default options.

    During the upgrade process, UPGMMX will:

    1. Transfer the most recent Installation package from the Skytap server.
    2. Transfer the installation package to other nodes configured within the installation, (using MIMIX SYNCOBJ)
    3. Perform a pre-check on the local node and each remote node to verify that most preconditions for a successful upgrade are satisfied (if you specified NODES(*ALL)).
    4. If any preconditions aren’t satisfied, Assure MIMIX™ Software is not upgraded and the UPGMMX command fails.
    • If this happens, examine the messages for any preconditions that aren’t satisfied.
    1. If all preconditions are satisfied, the upgrade starts with the remote nodes (if NODES(*ALL) was specified).

      Notes

      • Nodes that are already at the current Assure MIMIX™ Software version aren't upgraded.
      • If any upgrade fails, processing stops and no further nodes are upgraded.
    2. After all the remote nodes are upgraded, then the local node is upgraded.
    3. If you specified RESTART(*YES), the Assure MIMIX™ Software managers and the AUI server start.

Upgrading older versions of Precisely Assure MIMIX™ Software software

To upgrade an older Skytap Assure MIMIX™ Software installation, see Upgrading Precisely Assure MIMIX™ Software 10.0.19.00 and older on Skytap VMs

Getting more help

Assure MIMIX™ Software documentation

Assure MIMIX™ Software product documentation.

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