Upgrading


This topic describes how to upgrade the product from an older version to a new one by migrating the database.

Warning

Important

You can only migrate a database from an older version to a new version only, not from a new version to an older version. To restore an older version, use your backup database.

This topic includes the following sections:

Related topic

When upgrading the BMC AMI Ops Insight product, the application sometimes modifies the database schema because of changes in the new version.

(BMC.AMIOPS.SPE2210)Before upgrading to a new version:

  • Create a backup of the database.
  • Make sure you have sufficient space on the file system (preferably at least 2.5 times the size of the database files) because BMC AMI Manager creates a backup before updating the database. 
  • Make sure you have enough time to complete the upgrade without interruption.
Error
Warning

Failure to follow these steps might result in corruption of the database files and leave them in an unrecoverable state. 

To upgrade to the latest maintenance level

After applying the PTFs, use the following steps to refresh your existing AMIFTPG JCL in UBMCSAMP: 

Warning

Important

Perform these steps only if you have implemented the optional graph component (z/CX docker container) previously.

  1. Rename the existing AMIFTPG JCL member to AMIFTPGO.       
  2. Copy the FTPGRAPH member from PVZSAMP dataset to UBMCSAMP as AMIFTPG.
    The new JCL contains additional statements to FTP the new graph database container to z/CX.
  3. In the new AMIFTPG member, replace the SET statement (Line 8 to 16) with the old JCL member (AMIFTPGO).
  4. Configure the jobcard and submit the AMIFTPG job.
    This job will FTP the TAR files to your instance.         

    Warning

    Important

    Run AMIFTPG job only if you are running BMC AMI Ops Insight Docker container on z/CX. See related APAR for details.   

                                                            

To upgrade to the latest Docker container

When upgrading to the latest version of the Docker container, use the following steps:

  1. Stop and remove the older version of the Docker container.
  2. Download the latest version of the Docker container.
Warning

Important

For Playback Docker container using Docker Desktop on local device, when upgrading to the latest version of the Docker container, the models that were previously loaded are not visible in the Import file window because now they have the mlb.bk extension. Remove the .bk extension and import the models and playback files again.

To upgrade from BMC AMI Ops Insight 1.2.00

When upgrading from BMC AMI Ops Insight version 1.2.00 to 2.0.00, update your existing Tomcat started task (AMITCJCL) JCL to run with 64-bit JVM in version 2.0.00.

  • Set TCENV=AMITCEN6
  • Set VERSION=86

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Ops Insight 2.0