2.4. Removing the SGD Gateway

To remove the SGD Gateway, you remove the software installed on the SGD Gateway host.

2.4.1. How To Remove the SGD Gateway

  1. Log in as superuser (root) on the SGD Gateway host.

  2. Change the SGD Client routing configuration for the SGD array.

    1. Log in as superuser (root) on the primary SGD server.

    2. Edit the --security-gateway attribute for the SGD array.

      For a basic deployment using a single SGD Gateway, run the following command:

      # tarantella config edit --security-gateway ""
      Note

      For a load-balanced deployment using multiple SGD Gateways and an external load balancer, you do not need to edit the --security gateway attribute.

  3. Uninstall the SGD Gateway.

    Run the following command:

    # /opt/SUNWsgdg/bin/gateway uninstall

    A warning message is displayed, prompting you to confirm that you want to stop the SGD Gateway.

    Caution

    The gateway uninstall command is the only supported method of removing the SGD Gateway. Do not use the pkgrm or rpm commands directly to remove the SGD Gateway.

  4. (Optional) Remove the SGD Gateway from the list of SGD Gateways registered for the SGD array.

    1. Display the SGD Gateways registered for the SGD array.

      # tarantella gateway list
      Installed gateway: gateway1.example.com
      Issuer: CN=gateway1.example.com, OU=Marketing, O=Example, L=Boston, 
      ST=Massachusetts, C=US
      Serial Number: 1208509056
      Subject: CN=gateway2.example.com, OU=Marketing, O=Example, L=Boston, 
      ST=Massachusetts, C=US
      Valid from Fri Sep 26 09:57:36 GMT 2008 to Thu Dec 25 09:57:36 GMT 2008
    2. Remove the SGD Gateway from the list of SGD Gateways registered for the SGD array.

      # tarantella gateway remove --name gateway1.example.com