2.2.3 Replace a Query Server

  1. Prepare for server replacement:
    1. Identify the DP server that needs to be replaced.

      Hostname: Query server

  2. Make Query server’s Max Allowed HA Role “OOS” so it does not become active:
    1. From the SDS GUI, navigate to Status & Manage and HA.
    2. Select the query server that needs to be replaced.
    3. Change its Max Allowed HA Role to "OOS" and click Ok.
  3. Remove query server from the server group:
    1. From the SDS GUI, navigate to Configuration and Server Groups.
    2. Select query server's server group and click Edit.
    3. Move query server out of the server group and click Ok.
  4. Replace VM For VMWare based deployments:
    1. Open the cloud client of your choice, for example, vSphere client and locate the defective DP server VM.
    2. Power down DP SOAM server VM and remove it from the inventory or disk.

      For more information, see section 2.2 "Creating SDS Guests (VMware)" from Oracle Communications SDS Cloud Installation Guide.

    3. For KVM or OpenStack based deployments:
      1. Run the following command to log in to the OpenStack control node:
        $ ssh admusr@node
      2. Run the following command to power down defective DP SOAM server VM and remove it from the inventory or disk:
        $ nova delete <VM Name>

        For more information, see section 2.3 "Create SDS Guest from OVA (KVM/OpenStack)" from Oracle Communications SDS Cloud Installation Guide.

    4. For OVM-S/OVM-M based deployments:
      1. Run the following command to log in to the command line interface of the OVM-M:
        OVM> ssh -l admin <OVM-M IP> -p 10000
        Example:
        
[root@manager01 ~]# ssh -l admin 10.240.16.138 -p
10000
admin@10.240.16.138's password:
      2. Run the following command to power down SDS VM(s).
        OVM> stop Vm name=<VM Name>

        Note:

        Wait for the VM to have the state stopped.
      3. Run the following command to remove the VM from the inventory or disk:
        OVM> delete Vm name=<VM Name>

        Note:

        Repeat steps 2 and 3 for all the failed VMs.
      4. For more information, see, section 2.4 "Creating SDS Guests from OVA (OVM-S or OVM-M)" from Oracle Communications SDS Cloud Installation Guide.
  5. Prepare the new Query server:
    1. Perform procedure 3.3 "Query Server Installation" steps 5 to 9 from Oracle Communications SDS Cloud Installation Guide.
  6. Add Query server to the server group and validate pairing:
    1. Perform procedure in section 3.3, "Adding Query Server to the SDS Server Group"” within section 3.3, step 1 from Oracle Communications SDS Cloud Installation Guide.
  7. Make query server’s Max Allowed HA Role to “Active”:
    1. From the SDS GUI, navigate to Status & Manage and HA.
    2. Select the query server.
    3. Change its Max Allowed HA Role to Observer and click Ok.
  8. Restart the query server:
    1. Perform procedure within section 3.3, step 2 "Adding Query Server to the SDS Server Group", from Oracle Communications SDS Cloud Installation Guide.

Post-Condition

Query server is back in service.