Adding Physical Machines to Inventory

NAKIVO Backup & Replication allows you to use the existing agent when adding Windows or Linux physical machine to NAKIVO Backup & Replication inventory. For this option to be available, you need to install or update the agent on the physical machine.

Manual Installation of Physical Agent

To install or update a physical agent, do the following:

For Windows:

  1. Go to Settings > Nodes and click the Download button.

  2. Select the Physical machine agent package for Windows to download the package for Windows OS.

  3. Extract the package to the C:\Program Files\NAKIVO Backup & Replication\transporter folder of NAKIVO Backup & Replication in the physical machine. Create the folder if it does not exist.

  4. Extract file transporter-physical-windows.7z to C:\Program Files\NAKIVO Backup & Replication\transporter folder.

  5. Run the command: bhsvc.exe -b [keyPassword] to generate bhsvc.id file with pre-shared key.

    Notes

    • You can replace [keyPassword] with the desired password.

    • Full path: C:\Program Files\NAKIVO Backup & Replication\transporter\bhsvc.exe -b

  6. Run the install.bat file as an Administrator.

  7. Add the agent as the installed service.

    Notes

    • Make sure to check permissions in case the user is not the Administrator.

    • UAC must be turned off on the PC.

For Linux:

Note

Make sure you have the required permissions. Note that the creation of pam.d file is necessary for RHEL, CentOS, and SLES operating systems, but is not required for Ubuntu OS.

  1. Go to Settings > Nodes and click the Download button.

  2. Select the Physical machine agent for Linux to download the installer for Linux OS.

  3. Copy the installer to the tmp folder on the target physical machine.

  4. Run the following command for silent installation/update of the agent:

    sudo bash /tmp/transporter-physical-linux-installer.sh -s 9446 -i /opt/nakivo/transporter -p [keyPassword] --pam-conf --eula-accept

  5. Run the following command to grant permissions to the scripts folder:

    chmod 777 /opt/nakivo/transporter/scripts

  6. Create and edit the bhsvc file. Do the following:

    1. Launch the vi editor and create a new bhsvc file using the following command:

      vi /etc/pam.d/bhsvc

    2. Edit the content of the bhsvc file to have it contain the following:

      Go to Settings > Nodes and click the Download button.

    3. Select the Physical machine agent for Linux to download the installer for Linux OS.

    4. Copy the installer to the tmp folder on the target physical machine.

    5. Run the following command for silent installation/update of the agent:

      sudo bash /tmp/transporter-physical-linux-installer.sh -s 9446 -i /opt/nakivo/transporter -p [keyPassword] --pam-conf --eula-accept

    6. Run the following command to grant permissions to the scripts folder:

      chmod 777 /opt/nakivo/transporter/scripts

    7. Create and edit the bhsvc file. Do the following:

      1. Launch the vi editor and create a new bhsvc file using the following command:

        vi /etc/pam.d/bhsvc

      2. Edit the content of the bhsvc file to have it contain the following:

        auth required pam_unix.so nullok

        auth required pam_nologin.so

        account required pam_unix.so

        session required pam_selinux.so close

        session required pam_loginuid.so

      3. Save the bhsvc file and close the vi editor:

        • Press the Esc button to switch the vi editor to the Normal mode.

        • Enter the ":" symbol to switch to the Command-line mode.

        • In the Command-line mode, enter the "x" symbol and then press Enter.

      4. Provide the necessary permissions for the bhsvc file with the following command:

        chmod 644 /etc/pam.d/bhsvc

      Make sure to exclude “--pam-conf” for Ubuntu-type of OSes.

    8. Add the agent as the installed service. If you encounter errors when adding the agent or Transporter as an installed service, you may need to downgrade the security for Linux, including the following:

      • Adding new firewall rules for port 9446 and data transfer ports.

      • Editing sudoers.

      • Disabling SELinux.

    Adding a Physical Machine

    To add a Windows or Linux physical machine to NAKIVO Backup & Replication, follow the steps below:

    1. Make sure that a physical machine is a supported version and all prerequisites are met before proceeding. For more details, refer to Supported Platforms.

    2. Click Settings in the left pane of the product.

    3. Go to the Inventory page and click +.

    4. On the Platform page of the wizard, select Physical and click Next to proceed.

    On the Options page of the wizard, fill in the following fields.

    For Windows physical machines:

    • Display name: Specify a name for the physical machine. This name will be displayed in the inventory.

    • Type: Display the type of machine that you add to the inventory. 

    • Hostname(s) or IP(s): Specify the hostname or IP address of the physical machine that you want to add to the inventory. To add multiple physical machines at once, use commas to separate hostnames or IP addresses, or use a dash for an IP address range.

    • Use existing agent: If this option is selected, the product will use the existing physical machine agent for discovering the machine.

      • Note

      This option is disabled in case Direct Connect is enabled.

    • Username: Provide a username for the physical machine.

    • Password: Provide a password for the physical machine.

    • For Linux physical machines:

      • Display name: Specify a name for the physical machine. This name will be displayed in the inventory.

      • Type: Display the type of machine that you add to the inventory. 

      • Hostname(s) or IP(s): Specify the hostname or IP address of the physical machine that you want to add to the inventory. To add multiple physical machines at once, use commas to separate hostnames or IP addresses, or use a dash for an IP address range.

      • Use existing agent: If this option is selected, the product will use the existing physical machine agent for discovering the machine.

        Notes

        • For this option to be available, you need to manually install the physical agent.

        • The manually installed agent is not updated automatically during product auto-update.

        • The Use existing agent option is disabled in case Private Key credentials type is selected.

        • This option is disabled in case Direct Connect is enabled.

      • SSH port: Specify the SSH port number to provide access to the physical machine. The default SSH port number is 22. 

      • Credentials Type: Select the type of credentials used to access the physical machine.

        • Password

          • Username: Provide a username for the physical machine.

          • Password: Provide a password for the physical machine.

        • Private Key

        • Credentials: Select the saved private key-based credentials. Refer to Managing Credentials for details.


          Note
          You will not be able to change the type of key credentials through the Manage Credentials option. 

      • Optionally, you can enable the Use Direct Connect option for this item to discover a physical machine located in a remote environment using the Direct Connect functionality. To do this:

      • Select Use Direct Connect.

        Note

        This option is disabled in case Use existing agent is enabled.

      • In the Assigned transporter drop-down list, choose the Transporter that was installed in the remote environment with Direct Connect enabled. Note that this Transporter must be discovered in the multi-tenant deployment of NAKIVO Backup & Replication.

        Note

        This option is only available if there is a Transporter with Direct Connect enabled on a tenant’s side. For details, refer to Adding Existing Nodes.

    6. Click Finish. The successfully added physical machine is displayed on the inventory list.