Installing Unified Manager on Red Hat Enterprise Linux or CentOS

You can install Unified Manager on a physical or virtual Red Hat Enterprise Linux or CentOS platform.

Before you begin

About this task

The Red Hat Enterprise Linux or CentOS system may have all the required versions of the required supporting software (Java, MySQL, additional utilities) installed, or it may have only some of the required software installed, or it may be a newly installed system with none of the required software installed.

Steps

  1. Log in to the server on which you are installing Unified Manager.
  2. Enter the appropriate commands to assess what software might require installation or upgrade on the target system to support installation:
    Required software and minimum version Command to verify software and version
    OpenJDK version 11 java -version
    MySQL 5.7.23 Community Edition rpm -qa | grep -i mysql
    p7zip 9.20.1 rpm -qa | grep p7zip
  3. If any version of the listed software is earlier than the required version, enter the appropriate command to uninstall that module:
    Software to uninstall Command to uninstall the software
    MySQL
    Note: Uninstall any version that is not MySQL 5.7.23 Community Edition or later.
    rpm -e <mysql_package_name>
    Note: If you receive dependency errors, you must add the --nodeps option to uninstall the component.
    All other modules yum remove module_name
  4. Navigate to the directory where you downloaded the installation .zip file and expand the Unified Manager bundle: unzip OnCommandUnifiedManager-rhel7-9.5.zip
    The required .rpm modules for Unified Manager are unzipped to the target directory.
  5. Verify that the following modules are available in the directory: ls *.rpm
    • ocie-au-<version>.x86_64.rpm
    • ocie-server-<version>.x86_64.rpm
    • ocie-serverbase-<version>.x86_64.rpm
    • netapp-application-server-<version>.x86_64.rpm
    • netapp-platform-base-<version>.x86_64.rpm
    • netapp-ocum-<version>.x86_64.rpm
  6. Run the pre-installation script to ensure that there are no system configuration settings or any installed software that will conflict with the installation of Unified Manager: pre_install_check.sh
    The pre-installation script checks that the system has a valid Red Hat subscription, and that it has access to the required software repositories. If the script identifies any issues, you must fix the issues prior to installing Unified Manager.
    Note: You must perform step 7 only if you are required to manually download the packages that are required for your installation. If your system has Internet access and all the required packages are available, go to step 8.
  7. Optional: For systems that are not connected to the Internet or that are not using the Red Hat Enterprise Linux repositories, perform the following steps to determine whether you are missing any required packages, and then download those packages:
    1. On the system on which you are installing Unified Manager, view the list of available and unavailable packages: yum install *.rpm --assumeno
      The items in the "Installing:" section are the packages that are available in the current directory, and the items in the "Installing for dependencies:" section are the packages that are missing on your system.
    2. On a system that has Internet access, download the missing packages: yum install <package_name> --downloadonly --downloaddir=.
      Note: Because the plug-in "yum-plugin-downloadonly" is not always enabled on Red Hat Enterprise Linux systems, you might need to enable the functionality to download a package without installing it: yum install yum-plugin-downloadonly
    3. Copy the missing packages from the Internet-connected system to your installation system.
  8. Install the software: yum install *.rpm
    This command installs the .rpm packages, all other necessary supporting software, and the Unified Manager software.
    Important: Do not attempt installation by using alternative commands (such as rpm -ivh ...). The successful installation of Unified Manager on a Red Hat Enterprise Linux or CentOS system requires that all Unified Manager files and related files are installed in a specific order into a specific directory structure that is enforced automatically by the yum install *.rpm command.
  9. Disregard the email notification that is displayed immediately after the installation messages.
    The email notifies the root user of an initial cron job failure, which has no adverse effect on the installation.
  10. After the installation messages are complete, scroll back through the messages until you see the message in which the system displays an IP address or URL for the Unified Manager web UI, the maintenance user name (umadmin), and a default password.
    The message is similar to the following:
    OnCommand Unified Manager installed successfully.
    Use a web browser and one of the following URL(s) to configure and access the Unified Manager GUI.
    https://default_ip_address/    (if using IPv4)
    https://[default_ip_address]/  (if using IPv6)
    https://fully_qualified_domain_name/
    
    Log in to Unified Manager in a web browser by using following details:
      username: umadmin
      password: admin
    
  11. Record the IP address or URL, the assigned user name (umadmin), and the current password.
  12. If you created a umadmin user account with a custom home directory prior to installing Unified Manager, then you must specify the umadmin user login shell:usermod -s /bin/maintenance-user-shell.sh umadmin

After you finish

You can access the web UI to perform the initial setup of Unified Manager, as described in the OnCommand Unified Manager System Configuration Guide.