No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

OceanStor BCManager 6.5.0 eReplication User Guide 02

Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
Installing eReplication Agent on a Windows-based Host

Installing eReplication Agent on a Windows-based Host

This operation installs the eReplication Agent on a Windows-based host. The eReplication Agent starts automatically after being successfully installed.

Prerequisites

  • The software packages, reference documentation, and tools required by the eReplication Server have been obtained. For details, see Obtaining Installation Packages and Documentation.
  • The signature file and digital signature public key have been obtained and the software integrity has been verified.
    1. On the page for downloading the eReplication software package, you can download the .asc digital signature file whose name is the same as that of the software package.
    2. You have used the digital signature public key and verification tool provided by the website to verify the digital signature of the software package. You can obtain the digital signature public key, verification tool, and their usage methods from:

Context

If you need to install the eReplication Agent again after uninstalling it, you can decompress either the old or new installation package to install the eReplication Agent. After the reinstallation is complete, you need to perform operations such as adding the host, creating protected groups, and creating recovery plans for the host on eReplication.

NOTE:
The installation package name of the eReplication Agent is in the format of software name software version_Agent-application server's CPU architecture and bit number.zip. The following details each part of the installation package name:
  • Software version must be the actual version in use. In this document, software version is represented by an asterisk (*).
  • Application server's CPU architecture and bit number: The format varies according to the number of CPU bits of application servers.

This section uses OceanStor BCManager *_Agent-WIN64.zip as an example.

Procedure

  1. Check whether the firewall is enabled.

    • If no, ensure whether the firewall is required.
    • If yes, open the firewall port (port number: 59526) of the server where the eReplication Agent is to be installed. For details about how to open the firewall port, see Configuring the Firewall.

  2. Copy the eReplication Agent installation package to a specific directory of the production application server.

    The name of the directory where the eReplication Agent installation package resides can contain only letters, digits, underscores (_), hyphens (-), periods (.), and one space.

    1. Log in to the production application server as an administrator.
    2. Copy installation package OceanStor BCManager *_Agent-WIN64.zip of the eReplication Agent to the application server.
  3. Optional: If the protected object is Oracle or IBM DB2, configure environmental variables for the operating system.

  4. Go to the Windows service management page and check whether there are processes related to the eReplication Agent.

    • If the RdMonitor, RdAgent, and RdNginx processes exist, the eReplication Agent has been installed. Then you need to run the cd Agent installation path\bin command on the CLI to go to the bin directory, and run the agentcli.exe show command to query the version of the eReplication Agent.
      • If an earlier version of the eReplication Agent is installed, you need to uninstall it and install the latest version. For details about how to uninstall the eReplication Agent, see Uninstalling the eReplication Agent from a Windows-based Host.
      • If the latest version of the eReplication Agent is installed, skip the following steps.
    • If the RdMonitor, RdAgent, and RdNginx processes do not exist, the eReplication Agent has not been installed. You need to perform 5.

  5. Install the eReplication Agent.

    During the eReplication Agent installation, do not manually close the installation window if no anomalies occur. Otherwise, there will be residual information about the automatically created user rdadmin and permission configurations. For details about the troubleshooting case, see What Can I Do If User rdadmin's Information Unable to Be Automatically Deleted When the CLI Window Is Closed Due To Agent Installation Exceptions in Windows.

    1. Decompress OceanStor BCManager *_Agent-WIN64.zip.
    2. Under the bin directory where OceanStor BCManager *_Agent-WIN64.zip is decompressed, right-click the agent_install.bat file and choose Run as administrator from the shortcut menu that is displayed.

      The following command output is displayed:

      Please input your name:
      NOTE:
      During the eReplication agent installation, the system automatically checks whether the rdadmin account is created.

    3. Type the username and press Enter.

      NOTE:

      The username consists of 4 to 16 case-sensitive letters, digits, and underscores (_), and must start with a letter. This username is required for adding hosts to eReplication. Keep the username safe.

      The following command output is displayed:

      Enter new password:

    4. Type the user password and press Enter.

      NOTE:
      The password complexity requirements are as follows:
      • Contains 8 to 16 characters.
      • Must contain at least two of the following types of characters:
        • Uppercase letters
        • Lowercase letters
        • Digits
      • Must contain special characters, including `~!@#$%^ &*()-_=+\|[{}];:'",<.>/?

      This password is required for adding hosts to eReplication. Keep the password safe. If you want to change the password after the installation, follow instructions in Changing the Password of the Account Used to Log In To the Agent to change the password.

      The following command output is displayed:

      Enter the new password again:

    5. Type the user password again and press Enter.

      The following command output is displayed:

      Please select network type for this machine:
       1.ipv4 
       2.ipv6

    6. Select the network type according to the command output.

      The following information is displayed if you select the IPv4 network.
      Please choose IP Address binded by nginx, default choice is 0:
         0  0.0.0.0  any
         1  10.136.27.243
         2  192.168.191.25
      NOTE:

      The IP addresses must be the actual in use.

    7. Select listening IP addresses for the RdNginx service and press Enter. The default value is 0, indicating that all the IP addresses on the production application server are used for listening.

      NOTE:
      • The value of IP Address is the production application server's IP address of the eReplication Agent. The eReplication Agent uses this IP address to listen the connections of the eReplication Server. This IP address is required for adding hosts to eReplication. Keep the IP address safe. If 0 is used, you can use any IP address on the production application server to discover hosts.
      • When necessary, you can use the bin\nginx\conf\nginx.conf file under the eReplication Agent installation directory to change the IP address of the eReplication Agent production server. The new IP address takes effect after the eReplication Agent service is restarted. For details about how to restart the eReplication Agent, see Starting the eReplication Agent.

      The following command output is displayed:

      Please input rdagent listening port number 1024-65535, default port number is 8091:

    8. Type the listening port of the RdAgent service and press Enter. The default port number is 8091.

      The following command output is displayed:

      Please input nginx listening port number 1024-65535, default port number is 59526:

    9. Type the listening port of the RdNginx service and press Enter. The default port number is 59526.

      NOTE:

      The value of Port is a port that is not used by the eReplication Agent production server. The default port number is 59526. This port number is required for adding hosts to eReplication. Keep the port number safe.

    10. The eReplication Agent is installed successfully if the following command output is displayed:

      eReplication Agent was installed successfully.
      NOTE:

      By default, the eReplication Agent starts automatically after being installed.

Follow-up Procedure

For security purposes, users may want to use a certificate issued by a third-party certification authority. The eReplication Agent allows users to replace authentication certificates and private key files as long as users provide the authentication certificates and private-public key pairs. For details about how to replace the server certificate for the eReplication Agent, see Replacing Certificates on the eReplication Agent.

Translation
Download
Updated: 2019-05-21

Document ID: EDOC1100075861

Views: 14776

Downloads: 70

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next