PowerProtect Data Manager 19.14 Virtual Machine User Guide

Manually install the VM Direct agent on Linux as a non-root user from the command line

A non-root user can manually install the VM Direct agent by performing the following steps from the command line.

1. Provide sudo access to the following files at a minimum:
   • RPM command (SLES, Red Hat Enterprise Linux, CentOS) and dpkg command (Debian/Ubuntu)
   • /opt/emc/vproxyra/bin/postinstall.sh
   • /opt/emc/vproxyra/bin/preremove.sh

   Note the following additional requirements:

   • The sudo user or group must be configured for no password prompt.
   • The sudo user or group must be provided with the no requiretty option.
   • When user elevation is enabled for file-level restore:
     • To browse files, you must have the appropriate authority in the destination virtual machine operating system. For example, you must be permitted to run vflrbrowse using sudo without being prompted for a password.
     • To perform the restore, the user account must have the appropriate authority. For example, this account requires sudo access and must be able to run vflrcopy without being prompted for a password.

   NOTE:If the Run with Elevated Privileges file-level restore is unsuccessful, an error displays indicating Unable to perform FLR Agent operation 'recover_files' on VM virtual machine name. This might occur when a typographical error has been made in the sudo commands. To determine if this has occurred, review the log file output for the following text:

   • sudo: a password is required
   • /etc/sudoers.d/admin: syntax error near line 1
   • sudo: no valid sudoers sources found, quitting

   It is recommended that you test the sudo command before performing a file-level restore in order to resolve any potential errors.

2. Use visudo to create the file /etc/sudoers.d/linuxuser, where linuxuser is the Linux login user, and then add the following contents to the file.

   On CentOS, OpenSuSE Leap, Oracle Linux, Red Hat Enterprise Linux, and SuSE Linux Enterprise Server operating systems:
   

   username ALL=NOPASSWD: /usr/bin/rpm, /opt/emc/vproxyra/bin/postinstall.sh, /opt/emc/vproxyra/bin/preremove.sh, /opt/emc/vproxyra/bin/vflrbrowse, /opt/emc/vproxyra/bin/vflrcopy

   Defaults:username !requiretty

   NOTE:On SuSE 12, the location is /bin/rpm instead of /usr/bin/rpm.

   On Debian and Ubuntu Server operating systems:
   

   username ALL=NOPASSWD: /usr/bin/dpkg, /opt/emc/vproxyra/bin/postinstall.sh, /opt/emc/vproxyra/bin/preremove.sh, /opt/emc/vproxyra/bin/vflrbrowse, /opt/emc/vproxyra/bin/vflrcopy

   Defaults:username !requiretty

3. Save the sudoers file.
   NOTE:If the file contains any syntax errors, correct the file to ensure that the sudo command will execute successfully. You can test the file by running the sudo command sudo rpm -qa as this user. If the file syntax is correct, you will not be prompted for any password when running the command.
4. Connect to the PowerProtect Data Manager console and change to the root user.
5. Run the command cd /opt/emc/sw-repo/vflragent/linux.
6. Run the following command:

   scp <package_file> <destination_vm_user>@<destination_vm_ip>:</path/to/copy>
   

   • If the destination virtual machine operating system is CentOS, OpenSuSE Leap, Oracle Linux, RedHat Enterprise Linux, or SuSE Linux Enterprise Server, replace <package_file> with the name of the .rpm file.
   • If the destination virtual machine operating system is Debian or Ubuntu Server, replace <package_file> with the name of the .deb file.
   • Replace <destination_vm_user> with the name of a root user on the destination virtual machine.
   • Replace <destination_vm_ip> with the IP address of the destination virtual machine.
   • Replace </path/to/copy> with a directory path on the destination virtual machine to which the VM Direct agent installer package should be copied.
     NOTE:When installing the VM Direct agent as a non-root user, ensure the non-root user has read and execute permissions to files in this directory path.
7. Log in to a shell prompt of the destination virtual machine.
8. Change directories to the location of the file copied in step 3.
9. If the destination virtual machine operating system is CentOS, OpenSuSE Leap, Oracle Linux, RedHat Enterprise Linux, or SuSE Linux Enterprise Server, run the following command:

   rpm -ivh <package_file.rpm>

   Replace <package_file.rpm> with the name of the file copied in step 3.
10. If the destination virtual machine operating system is Debian or Ubuntu Server, run the following command:

    dpkg -i <package_file.deb>

    Replace <package_file.deb> with the name of the file copied in step 3.
11. Run the command /opt/emc/vproxyra/bin/postinstall.sh.