4.3 Deploying a Configuration

You deploy a configuration to either create an instance of it on an administration node or update a previously created instance with new configuration settings. When you deploy a configuration, the running instances are reconfigured to reflect the configuration changes.

Note:

Certain configuration changes cannot be applied dynamically without restarting the instances. For the configuration changes that require instances to be restarted, the administration interfaces—CLI and administration console—display a prompt to restart the instances.

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

Note:

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."

Deploying a Configuration Using the Administration Console

To deploy 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 deploy.

   If there is no instance yet of the configuration that you selected to deploy, the message Undeployed Configuration is displayed at the top of the main pane. For the procedure to create one or more instances of an undeployed configuration, see Section 5.1, "Creating Oracle Traffic Director Instances."

   If instances of the configuration exist, but do not have the latest configuration settings, the message Deployment Pending is displayed at the top of the main pane. To update the instances with the latest configuration settings, do the following:

   1. Click Deploy Changes.

      A prompt to confirm deployment is displayed.

   2. Click Deploy.

      A message is displayed confirming that the updated configuration was successfully deployed.

   3. Click Close.

Deploying a Configuration Using the CLI

To deploy a configuration, run the deploy-config command.

For example, the following command updates all instances of the configuration soa.example.com with the latest configuration settings.

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

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

After deploying an updated configuration, for the changes to take effect, you should restart the instance.

Note:

For some parameters, you can reconfigure an instance without restarting it. For more information, see Section 5.4, "Updating Oracle Traffic Director Instances Without Restarting."