10.4 Deleting a Listener

You can delete HTTP or TCP listeners by using either the administration console or the CLI.

Note:

• When you delete a listener, you are, in effect, modifying a configuration. So for the updated configuration to take effect in the Oracle Traffic Director instances, you should redeploy the configuration as described in Section 4.3, "Deploying a Configuration."

• The CLI examples in this section are shown in shell mode (tadm>). For information about invoking the CLI shell, see Section 2.3.1, "Accessing the Command-Line Interface."

Deleting a Listener Using the Administration Console

To delete an HTTP or TCP listener by using the administration console, do the following:

1. Log in to the administration console, as described in Section 2.3.2, "Accessing the Administration Console."

2. Click the Configurations button that is situated at the upper left corner of the page.

   A list of the available configurations is displayed.

3. Select the configuration for which you want to delete listeners.

4. In the navigation pane, select Listeners.

   The Listeners page is displayed. It shows a list of the listeners defined for the configuration.

5. Click the Delete icon for the listener that you want to delete.

   A prompt to confirm deletion of the listener is displayed.

   Note:

   For HTTP listeners: If the HTTP listener is associated with any virtual servers, the prompt shows the names of those virtual servers.

6. To proceed with the deletion, click OK.

   A message is displayed in the Console Message pane confirming that the HTTP/TCP listener was deleted.

   In addition, the Deployment Pending message is displayed at the top of the main pane. You can either deploy the updated configuration immediately by clicking Deploy Changes, or you can do so later after making further changes, as described in Section 4.3, "Deploying a Configuration."

Deleting a Listener Using the CLI

• To delete an HTTP listener, run the delete-http-listener command, as shown in the following example:

  tadm> delete-http-listener --config=soa http-listener-1
  OTD-70201 Command 'delete-http-listener' ran successfully.
  

  To delete an TCP listener, run the delete-tcp-listener command, as shown in the following example:

  tadm> delete-tcp-listener --config=soa tcp-listener-1
  OTD-70201 Command 'delete-tcp-listener' ran successfully.
  

For the updated configuration to take effect, you should deploy it to the Oracle Traffic Director instances by using the deploy-config command.

For more information about delete-http-listener and delete-tcp-listener, see the Oracle Traffic Director Command-Line Reference or run the command with the --help option.