create-instance

Syntax

tadm create-instance common_options [--force] --config=config_name (node_host)+

Description

Use this command to create an instance of Oracle® Traffic Director. Instance refers to the environment of a Oracle® Traffic Director daemon on a given node, including its configuration, log files, and other runtime artifacts such as lock databases, caches, and temporary files. A node is a network resource, such as a server or a host. In a typical data center, a network of nodes is called a server farm.

Note:

If the node is service-enabled, when you create a new instance, a service is also created for that instance.

Options

For information about common_options, run the help command.

--force|-f

Specify this option to enable a forced creation of an instance. Providing this option deletes any existing instance for the specified configuration on the specified node before creating the instance.

--config|-c

Specify the name of the configuration for which you want to create the instance.

Operands

node-host

Specify the name of the node.

Example

tadm create-instance --user=admin --password-file=./admin.passwd --host=admin.example.com --port=8989 --no-prompt 
--config=www.example.org serverhost

Exit Codes

The following exit values are returned:

0: command executed successfully

>0: error in executing the command

For more information about exit codes and syntax notations, run the help command.

See Also

help, delete-instance, list-instances, start-instance, stop-instance, restart-instance, reconfig-instance, list-nodes, list-nodes, remove-node