Upgrading Ops Center Administrator by using the application installer

Ops Center Administrator Getting Started Guide

Version
10.8.x
File Size
916 KB
Audience
anonymous
Part Number
MK-99ADM000-13
If you are running Ops Center Administrator v10.0.x or later, you can use the application installer script to upgrade.

Verify the following:

  • There is a total of 60 GiB of temporary available space. This includes the following:
    • 40 GiB under the Docker root directory (default directory: /var/lib/docker) for Docker
    • 40 GiB under the Podman root directory (default directory: /var/lib/container) for Podman
    • 10 GiB under /var/tmp
    • 10 GiB under /tmp
  • There are no backup or restore jobs running.
  • The Virtual Appliance Manager log level is set to INFO. Upgrading fails when the log level is set to DEBUG or TRACE.
  • If you also want to upgrade the container runtime version, verify the following additional prerequisites:

    For Docker:

    Upgrade Ops Center Administrator first and then upgrade Docker.

    For Podman:

    • If the supported version of Podman is not installed in the environment, you must configure Yellowdog Updater, Modified (YUM) settings to install packages over a network. The application installer connects to the configured YUM repository and installs the required version of Podman. The packages related to Podman are located in the latest BaseOS and AppStream repositories.

      If you want to install or upgrade Podman yourself, you can run the following command:

      yum install podman-required-version

      For example, to install Podman v3.3.x:

      yum install podman-3.3.*

      The asterisk indicates to obtain and install the latest patch version available in the repository.

    • If the upgrade of Podman is suppressed, unlock the suppression temporarily before starting the installation. After completing the installation, suppress the upgrade of Podman again.
    • If you cannot use YUM to install Podman because your management server is not connected to the network, you must obtain the Podman software from the OS media (ISO image or CD-ROM).

      The supported version of Podman (3.3.x) is available with v8.5 of Red Hat Enterprise Linux and Oracle Linux. Therefore, regardless of the OS version that you are using, download v8.5 of the OS to get the required Podman version.

      1. Download the Linux ISO image (for example, redhat 8.5 iso).
      2. Mount the ISO image using the following command:

        mount /dev/cdrom /media

        For example: mount -o loop rhel-8.5-x86_64-dvd.iso /media

      3. If the /etc/yum.repos.d directory contains an existing repo file, rename the file extension or delete it.
      4. Create the yum repository file by running the following command:

        vim /etc/yum.repos.d/local.repo

      5. Add the required definition lines as shown in the following examples, and then save and close the file:
        For Oracle Linux
        [LocalRepo_BaseOS]name= LocalRepo_BaseOS
        gpgcheck=0
        enabled=1
        baseurl=file:///media/BaseOS/
        LocalRepo_AppStream]
        name=LocalRepo_AppStream
        gpgcheck=0
        enabled=1
        baseurl=file:///media/AppStream/
        For Red Hat Enterprise Linux
        [LocalRepo_BaseOS]
        name=LocalRepo_BaseOS
        metadata_expire=-1
        enabled=1
        gpgcheck=0
        baseurl=file:///media/BaseOS/
        gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-redhat-release
         
        [LocalRepo_AppStream]
        name=LocalRepo_AppStream
        metadata_expire=-1
        enabled=1
        gpgcheck=0
        baseurl=file:///media/AppStream/
        gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-redhat-release
      6. Verify the required library by running the following command:

        yum repolist

      7. Install podman by using the following command :
        yum install podman-required-version

        For example, to install Podman v3.3.x:

        yum install podman-3.3.*

    During installation, the following files are created under /tmp. Delete them if they are no longer required:

    • Application log
    • Audit log
    • Backup file

    The installation log is created under /var/logs/rainier-install.

Note: When upgrading Ops Center Administrator, do not configure the noexec mount option for the file system including the /tmp and /var/tmp directories. To check whether the option is configured, run the mount command.
  1. Either open an SSH connection to the VM or open the VMware console and press Alt+F2 to reach the console.
  2. Log in using the root account.
  3. Copy the tar file ops-center-administrator-xx.tar.gz from the installation media to any folder in the Linux environment and extract it. Navigate to the extracted folder.
  4. Navigate to the extracted folder and run the following command:
    sudo ./install.sh.
  5. Log in when prompted.
    • For Ops Center preconfigured media or application installer installations, use the sysadmin credentials.
    • For stand-alone preconfigured media installations, use the service credentials.
  6. At the prompt enter y at the following:
    Do you want to upgrade? [y/n]:
    Do you want to configure Ops Center [y/n]:
    Ops Center Administrator begins upgrading.
  7. For Podman, suppress the upgrade of Podman to avoid unintentionally upgrading to an unsupported version.

    For example, you can use yum-plugin-versionlock or the exclude parameter in yum.conf.

Troubleshooting the upgrade

If the installation fails, try the following:

  • Check and resolve any error messages and then retry the installation.
  • Verify that the Virtual Appliance Manager log level is set to INFO. Upgrading fails when the log level is set to DEBUG or TRACE.
  • Check your YUM settings and the host network to make sure that your system can connect to the YUM repository.
  • If you use a local YUM mirror repository server, confirm the setting of the HTTP server and whether the repository data gathered by the reposync command exists correctly.
  • Restart the Docker or Podman service, verify that the older version is running, and then retry the installation.
  • Check the Docker or Podman logs.

    Consult the documention of your container runtime for more information on how to perform these actions.

  • View the journal log entries to see whether there is additional error information by connecting to the host with the root account and running these commands:
    • journalctl --no-pager
    • journalctl --no-pager -u docker (Docker only)
    • journalctl --no-pager -u rainier (Podman only)
  • If the installation produces any warnings or errors, they may point to the cause of the problem. Correct any issues the installer identifies, delete any Ops Center Administrator containers and images, and start the installation again.
  • If the problem persists after the issues are corrected, try a fresh installation.
    1. Check that the backup file of the current version exists under the folder where install.sh is located and download the backup file.

      If the backup file does not exist, access the virtual appliance manager and download the backup file.

      • For an environment where the application installer version was originally installed, remove the older version and start a fresh installation.
      • For an environment where the preconfigured media installer version was originally installed, discard the current environment and perform a preconfigured media installation.
    2. After the installation completes, apply the backup file.