Upgrade an Infrastructure management Non-VMDB appliance

Important: Do not run evmserverd if a database is in a partially migrated state.

  1. Create a temporary upgrade directory.

    On the target appliance, create a temporary upgrade directory by running the following commands:

    mkdir /tmp/upgrade
    cd /tmp/upgrade
    
  2. Stop the evmserverd process.

    Run the following command:

    systemctl stop evmserverd
    
  3. Back up important files.

    Important: This step is only required if you are upgrading from Infrastructure management 3.5.x and older.

    Back up the following files and make a note of the appliance that each file comes from. This step is to replace the old appliances in the database and for disaster recovery.

    Note: The REGION file might not exist.

    • /var/www/miq/vmdb/GUID
    • /var/www/miq/vmdb/REGION
  4. Download the IBM Cloud Pak for Watson AIOps - Infrastructure Automation RPM updates image to the upgrade directory.

    For information on downloading the image, see Passport Advantage part numbers. Download the RPM updates image and copy the image into the temporary upgrade directory.

  5. Extract the .tgz on the target appliance.

    Run the following commands:

    cd /tmp/upgrade
    tar -zxvf infrastructure-management-upgrade-15.y*.tgz
    
  6. Enable new stream 8 modules.

    Important: This step is only required if you are upgrading from Infrastructure management 3.5.x and older.

    Enable the stream 8 modules by running the following commands:

    dnf -y module reset postgresql
    dnf -y module enable postgresql:13
    dnf -y module reset ruby
    dnf -y module enable ruby:3.0
    
  7. Upgrade the RPM packages.

    Run the following commands:

    dnf -y upgrade --allowerasing --refresh *.rpm
    dnf -y autoremove
    
  8. Migrate the database.

    Important: In a single (stand-alone database) or replicated environment, run the following command only on the first Non-VMDB appliance.

    Change to the vmdb directory.

    cd /var/www/miq/vmdb/
    

    Run the command appropriate to your environment to migrate everything in the database to work with the latest configuration. If you receive an error, contact IBM Support.

    rake db:migrate
    
  9. Update the Automate Model to the latest version.

    This command resets the ManageIQ and IBM domains (base domains) to a new and upgraded version. Run the command appropriate to your environment to update the Automate Model:

    Important: In a single (stand-alone database) or replicated environment, run the following command only on the first Non-VMDB appliance.

    rake evm:automate:reset
    
  10. Start the evmserverd process.

    In a single (stand-alone database) or replicated environment, run this command on each Non-VMDB appliance:

    systemctl start evmserverd
    
  11. Remove the temporary upgrade directory.

    Remove the upgrade directory by running the following command:

    rm -rf /tmp/upgrade
    

    The upgrade process is now complete. After appliances are running again, you can configure database replication in your environment. For more information, see Configuring Database Replication and Centralized Administration in the General Configuration guide.