Skip to main content
Active IQ Unified Manager 9.14

Installing Unified Manager

Contributors
PDFs

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

What you'll need

  • The system on which you want to install Unified Manager must meet the system and software requirements.

    See Hardware system requirements.

    See Linux software and installation requirements.

  • You must have downloaded the Unified Manager .zip file from the NetApp Support Site to the target system.

  • You should have verified the integrity of the downloaded .zip file.

  • You must have a supported web browser.

  • Your terminal emulation software must have scrollback enabled.

The Red Hat Enterprise Linux or CentOS system might have all the required versions of the required supporting software (Java, MySQL, additional utilities) installed, only some of the required software installed, or might 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.0.21

    java -version

    MySQL 8.0.34 Community Edition

    rpm -qa | grep -i mysql

    p7zip 16.02

    rpm -qa | grep p7zip

  3. If the installed version of MySQL is earlier than MySQL 8.0.34 Community Edition, enter the following command to uninstall it:

    rpm -e <mysql_package_name>

    If you receive dependency errors, you must add the --nodeps option to uninstall the component.

  4. Navigate to the directory where you downloaded the installation .zip file and expand the Unified Manager bundle:

    unzip ActiveIQUnifiedManager-<version>.zip

    The required .rpm modules for Unified Manager are unzipped to the target directory.

  5. Verify that the following module is available in the directory:

    ls *.rpm

    netapp-um<version>.x86_64.rpm

  6. Run the pre-installation script to ensure that there are no system configuration settings or any installed software that might conflict with the installation of Unified Manager:

    sudo ./pre_install_check.sh

    The pre-installation script checks that the system has a valid Red Hat Enterprise Linux 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.

    For Red Hat Enterprise Linux 8 system, if you have internal repositories with JDK 11 - OpenJDK, p7zip, and other software packages provided by the AppStream repository, you must disable your AppStream repository and install MySQL Community Server. Run the following command:

    # sudo yum --disablerepo=rhel-8-for-x86_64-appstream-rpms install  mysql-community-server

  7. Optional: You must perform step 7 only if your system is not connected to the internet and you have to manually download the packages that are required for your installation. If your system has the internet access and all the required packages are available, go to step 8. 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 netapp-um<version>.x86_64.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 the 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. As the root user, or using sudo, run the following command to install the software:

    yum install netapp-um<version>.x86_64.rpm

    This command installs the .rpm packages, all other necessary supporting software, and the Unified Manager software.

    If the installation fails with the GPG NOKEY error , use rpm --import to import the keys from a URL:

    rpm --import https://repo.mysql.com/RPM-GPG-KEY-mysql-2022

    Note

    Do not attempt installation by using alternative commands (such as rpm -ivh). A 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 netapp-um<version>.x86_64.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:

    Active IQ 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

Access the web UI to change the default password of the umadmin user, and perform the initial setup of Unified Manager, as described in Configuring Active IQ Unified Manager. It is mandatory to change the default password of the umadmin user.