To configure the vSphere Replication Cloud Service host, you must register each vSphere Replication Cloud Service appliance to your vCloud Director appliance, resource vCenter Server, and RabbitMQ.

About this task

Important:

If you have more than one vCloud Director instance configured in your vCenter Server lookup service, the vSphere Replication Cloud Service VM registers to the first vCloud Director instance in the lookup service.

Procedure

  1. Configure the vSphere Replication Cloud Service Appliance.

    The cassandra-replication-factor argument in the following command defines the number of data replicas across the Cassandra cluster. A replication factor 4 means that there are four copies of each row, where each copy is on a different node. The replication factor must not exceed the number of nodes in the Cassandra cluster.

    By default, the following command uses the AMQP settings from vCloud Director. If vCloud Director is not using an SSL port for AMQP, the vcav hcs configure operation returns an error. You can add the --amqp-port=port-number argument to override the vCloud Director port and point the AMQP service to an SSL port.

    Standard Command

    Command Using Registry

    # vcav hcs configure \
    --hcs-address=$HCS01_ADDRESS \
    --amqp-password-file=~/.ssh/.amqp \
    --cassandra-replication-factor=number-of-Cassandra-nodes \
    --vcd-address=$VCD_ADDRESS \
    --vcd-user=$VCD_USER \
    --vcd-password-file=~/.ssh/.vcd \
    --sso-user=$SSO_USER \
    --sso-password-file=~/.ssh/.sso 
    # vcav hcs configure \
    --hcs-address=$HCS01_ADDRESS \
    --amqp-password-file=~/.ssh/.amqp \
    --cassandra-replication-factor=number-of-Cassandra-nodes \
    --vcd=vcd-01-name

    The system returns an OK message, after the process finishes.

  2. Run the following command to verify that the hcs service starts successfully.

    Standard Command

    Command Using Registry

    # vcav hcs wait-for-extension \
    --hcs-address=$HCS01_ADDRESS \
    --vcd-address=$VCD_ADDRESS \
    --vcd-user=$VCD_USER \
    --vcd-password-file=~/.ssh/.vcd \
    --sso-user=$SSO_USER \
    --sso-password-file=~/.ssh/.sso 
    # vcav hcs wait-for-extension \
    --hcs-address=$HCS01_ADDRESS \
    --vcd=vcd-01-name
    

    If the hcs service starts successfully, the system displays an ОК message.

    If the system returns an error, or there is no output in 5 minutes, check the /opt/VMware/logs/hms/hcs.log file for errors.

  3. Assign vSphere Replication Cloud Service rights to the vCloud Director Organization Administrator role.
    • For vCloud Director 8.10 and earlier, you assign vSphere Replication Cloud Service rights to the Organization Administrator role and it applies to all organizations.

      Standard Command

      Command Using Registry

      # vcav hcs add-rights-to-role \
      --vcd-address=$VCD_ADDRESS \
      --vcd-user=$VCD_USER \
      --vcd-password-file=~/.ssh/.vcd \
      "--role=Organization Administrator"
      # vcav hcs add-rights-to-role \
      --vcd=vcd-01-name \
      "--role=Organization Administrator"
    • For vCloud Director 8.20 and above, you assign vSphere Replication Cloud Service rights to the Organization Administrator role for each organization or for all organizations.

      Standard Command

      Command Using Registry

      for each organization

      # vcav hcs add-rights-to-role \
      --vcd-address=$VCD_ADDRESS \
      --vcd-user=$VCD_USER \
      --vcd-password-file=~/.ssh/.vcd \
      "--role=Organization Administrator" \
      --org=org-name
      # vcav hcs add-rights-to-role \
      --vcd=vcd-01-name \
      "--role=Organization Administrator" \
      --org=org-name

      for all organizations

      # vcav hcs add-rights-to-role \
      --vcd-address=$VCD_ADDRESS \
      --vcd-user=$VCD_USER \
      --vcd-password-file=~/.ssh/.vcd \
      "--role=Organization Administrator" \
      --org=*
      # vcav hcs add-rights-to-role \
      --vcd=vcd-01-name \
      "--role=Organization Administrator" \
      --org=*
    Note:

    You do not need to restart any component for the changes to take effect.