6.4 Deleting an Origin-Server Pool

You can delete an origin-server pool by using either the administration console or the CLI.

Note:

• You cannot delete an origin-server pool that is associated with one or more routes in virtual servers.

  To delete an origin-server pool that is associated with routes, you must first delete the referring routes, as described in Section 8.4, "Configuring Routes."

• When you delete an origin-server pool, 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 an Origin-Server Pool Using the Administration Console

To delete an origin-server pool 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 origin-server pools.

4. In the navigation pane, select Origin-Server Pools.

   The Origin-Server Pools page is displayed.

5. Click the Delete icon for the origin-server pool that you want to delete.

   • If the origin-server pool is associated with one or more routes in virtual servers, a message is displayed indicating that you cannot delete the pool.

   • If the origin-server pool is not associated with any virtual server, a prompt to confirm the deletion is displayed.

6. Click OK.

   A message is displayed in the Console Message pane confirming that the origin-server pool 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 an Origin-Server Pool Using the CLI

To delete an origin-server pool, run the delete-origin-server-pool command, as shown in the following example:

tadm> delete-origin-server-pool --config=soa osp1
OTD-70201 Command 'delete-origin-server-pool' ran successfully.

Note:

If the specified origin-server pool is associated with one or more routes in virtual servers, the following error message is displayed:

OTD-67108 Cannot delete the origin-server pool. It is referred by virtual server(s): vs1_name,vs1_name,[...]

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-origin-server-pool, see the Oracle Traffic Director Command-Line Reference or run the command with the --help option.