Installing the UCP Advisor software on a bare metal server

Installing UCP Advisor on a bare metal server requires you to first install the operating system, verify that the hardware resource requirements are met, and then run the installation script on the bare metal host.

1. Log on to the bare metal server as a root user.
2. (Optional) Provision command devices on the bare metal server.
3. Change the Linux kernel to RHCK kernel. Enter:

   sudo grubby --set-default "/boot/vmlinuz-4.18.0-513.24.1.el8_9.x86_64"

   Note: If you are unable to change the Linux kernel to RHCK kernel, you must enable the RHCK kernel. Complete the procedure in Upgrading the operating system package to enable RHCK kernel on bare metal server and then continue from step 6.
4. Reboot the bare metal server.
5. Relogin to the bare metal server.
6. Navigate to the Advisor4.6\Software folder and extract the installer package, ucpadvisor-air-gapped-v4.6.0-141.tar.gz. Enter:

   tar -xvzf ucpadvisor-air-gapped-v4.6.0-141.tar.gz

7. (Optional) Create a custom user Linux account to install UCP Advisor.
   1. Navigate to the /installer/scripts folder. Enter:

      $ ./create_linux_account.sh

      When prompted, enter the username and password for the Linux account.

      Example:

      $ ./create_linux_account.sh
      Enter the Linux account name (default: ucpadmin):
      Enter the new password for ucpadmin:
      useradd: warning: the home directory already exists.
      Not copying any file from skel directory into it.
      Creating mailbox file: File exists
      Changing password for user ucpadmin.
      passwd: all authentication tokens updated successfully.
      /tmp/sudoers.tmp: parsed OK
      Successfully created Linux account (ucpadmin) and add sudo commands into /etc/sudoers
      In future, please use Linux account (ucpadmin) to install/upgrade UCPAdvisor.

8. Add the bare metal server IP address to the apiserver_advertise_address parameter. Perform the following steps:
   1. Log on to the bare metal server.
   2. Navigate to the /installer folder.
   3. Open the config.toml file in edit mode. Enter:

      vi config.toml

   4. Add the bare metal server IP address to the apiserver_advertise_address parameter. Enter:

      apiserver_advertise_address=Bare_Metal_Server_IP Address"

   5. Exit the edit mode. Press the Esc key.
   6. Save the changes: Enter:

      :wq

9. Navigate to the /installer folder, and then install UCP Advisor. Enter:
   Note: If you want to install UCP Advisor as a ucpadmin or the customer user linux account, then relogin to the bare metal server with those credentials and then run the command.

   sudo ./installer -m <Bare metal server IP address> [-P|<-u <username> -p <password>] [-c <command devices list>] <-s <SCP server IP address> [-lsd SDX]

   where:

   • -m: Bare metal server IP address
   • -P | <-u -p>: If you use the -u -p options, you must enter the username and password in the command. However, if you use the -P option, then you must enter the username and password when prompted.
   • -c: (Optional) Specify the list of command devices that must be used.
   • -s: Enter a free IP address to configure the SCP server.
     Note: The SCP server will be used for UCP Advisor internal operations such as switch back up and restore and switch firmware upgrade.
   • -lsd: (Optional) Specify is you want to use LVM to back up or restore the /root disk partition. Use the 200 GB Linux device to create the LVM snapshot.

   For example:

   sudo ./installer -m 192.168.10.10 -u ucpadmin -p Password -c sdb sdc -s 192.168.10.20 -lsd SDX 

   Note: If you want to install UCP Advisor as a root user, you must log on to the bare metal server with the root user credentials.
   After UCP Advisor is successfully installed, the following message is displayed on the console:

   Congratulations, the installation is successful. The UCP Advisor console UI should be available at https://<IP address>
   In future, if user wants to add or remove command device, must do it on <IP address>