4.7 Deleting a Configuration

You can delete a configuration by using either the administration console or the CLI.

Note:

• To delete a configuration that has one or more failover groups, you should first delete the failover groups. For more information, see Section 14.2.4, "Managing Failover Groups."

• 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 Configuration Using the Administration Console

To delete a configuration 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 that you want to delete.

4. In the Common Tasks pane, click Delete Configuration.

   • If there are no instances of the configuration that you want to delete, a prompt to confirm deletion of the configuration is displayed.

     1. Click Delete.

        A message is displayed confirming that the configuration was deleted.

     2. Click Close.

   • If there are instances of the configuration that you want to delete, a dialog box is displayed listing the administration nodes on which the configuration is deployed. The list also indicates whether the instances are running.

     1. If you want to proceed with the deletion, you can choose to save the log files of the instances by selecting the Save Instance Logs check box.

        To confirm deletion, click Delete.

        A message is displayed confirming that the configuration and its instances were deleted.

     2. Click Close.

     Note:

     If you selected the Save Instance Logs check box, the server access and error logs for the instances that were deleted are retained in the INSTANCE_HOME/net-config_name/logs directory.

5. Click the Delete button corresponding to the configuration that you want to delete.

Deleting a Configuration Using the CLI

Note:

You cannot delete a configuration by using the CLI if instances of the configuration are deployed to administration nodes, regardless of whether the instances are running or stopped.

To delete such a configuration by using the CLI, you must first delete all of its instances.

To delete a configuration, run the delete-config command, as shown in the following example:

tadm> delete-config --config=soa.example.com
OTD-70201 Command 'delete-config' ran successfully.

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