This chapter provides information about creating administration server and administration nodes for Oracle Traffic Director.
This chapter contains the following sections:
After installing Oracle Traffic Director, create the Oracle Traffic Director administration server by performing the following steps:
Note:
For more information about the administration server, see "Managing the Administration Server" in the Oracle Traffic Director Administration Guide.Use the configure-server command to create the administration server. You can configure Oracle Traffic Director as the root or a non-root user.
When the administration server is configured as root, then Oracle Traffic Director starts the keepalived daemon automatically when you start instances that are part of a failover group, and stops the daemon when you stop the instances. On the other hand, if the administration server is configured as non-root and if the administration node process is running as non-root on the node where the instances are located, then the keepalived daemon does not start or stop automatically. In this case, you will need to run the start-failover command on those nodes as a root user. This is to manually start the failover. If this command is not executed, failover will not start and there will be no high availability. For more information about creating and managing failover groups, see "Configuring Oracle Traffic Director for High Availability" in the Oracle Traffic Director Administrator's Guide.
To configure Oracle Traffic Director as the root user, run the following command:
$ORACLE_HOME/bin/tadm configure-server [--user=admin-user] [--password-file=admin-passwd-file] [--host=admin-host] [--port=admin-port] [--rcfile=rcfile] [--echo] [--no-prompt] [--verbose] ([--admin-node] [--node-host=node-host] [--node-port=node-port]) [--server-user=root] [--java-home=java-home] [--bind-ip=ip] --instance-home=instance-home
Note:
ORACLE_HOME is the directory in which you installed Oracle Traffic Director.
The user name can contain a maximum of 100 characters and must not contain spaces.
Example:
$ORACLE_HOME/bin/tadm configure-server --user=otd_admin --server-user=root --instance-home=production/otd/
Note:
If the--port option is not specified, it defaults to 8989.To configure Oracle Traffic Director as a non-root user, run the configure-server command without the --server-user option. Oracle Traffic Director supports high availability even when it is configured as a non-root user. For more inform see "Configuring Oracle Traffic Director for High Availability" in the Oracle Traffic Director Administrator's Guide.
If you do not use the --password-file option to specify the file containing the password, the following prompt is displayed:
Please enter admin-user-password>
Note:
You can remove the administration server instance by running the following command:
$ORACLE_HOME/bin/tadm unconfigure-server --instance-home=path
For more information about the configure-server and unconfigure-server commands, see the Oracle Traffic Director Command-Line Interface Reference.
Enter the administrator password. You will later use this password to log in to the Oracle Traffic Director administration console.
A prompt to re-enter the administrator password is displayed, as follows:
Please enter admin-user-password again>
Confirm the administrator password by entering it again.
An administration server instance of Oracle Traffic Director is created and deployed on the local host in a directory named admin-server within the instance-home directory that you specified in step 1.
To create an administration node, make sure that the administration server is running, and then run the configure-server command from the shell prompt of the host that you want to designate as the administration node. You can create the administration node as the root or a non-root user.
For example, to designate a mount point called secondary as an Oracle Traffic Director administration node that is registered with the administration server on the host admin_server, do the following:
Note:
To create the administration node asroot, run the configure-server command as root and include the --server-user=root option.Run the configure-server command from the secondary system.
Example:
$ORACLE_HOME/bin/tadm configure-server --user=admin --host=admin_server
--port=8889 --admin-node --node-host=secondary --node-port=8900
--instance-home=/home/otd/instances
ORACLE_HOME is the path to the directory or mount point containing the Oracle Traffic Director installation on the node that you want to designate as the administration node.
The --instance-home option specifies the directory in which the instance directories should be created on the node.
The --admin-node option specifies that the specified host should be configured as an administration node.
The --port option specifies the port where the administration server is running. If the --port option is not specified, it defaults to 8989.
The --node-port option specifies the port where the administration node will run. If the --node-port option is not specified, it defaults to 8989.
The following message is displayed.
This command will create an administration node and register it with the remote administration server: https://secondary:8900. Enter admin-user-password>
Enter the password for the administration server user.
The configure-server command attempts to connect to the remote administration server by using the specified administration server host, port, user, and password.
Note:
If the administration server is not reachable, the following error message is displayed.OTD-70104 Unable to communicate with the administration server: Unable to connect to admin-server. Please check if the server is up and running and that the host and port provided are correct.
Start the administration server and run the configure-server command again.
If this is the first time that the host on which you are creating the administration node is attempting to connect to the administration server, the server certificate of the administration server is displayed.
Enter y to trust the certificate.
The following message is displayed:
OTD-70215 The administration node has been configured successfully.The node can be started by executing: /home/otd/instances/admin-server/bin/startserv
For more information about configure-server, see the Oracle Traffic Director Command-Line Reference or run the command with the --help option.
After you start the administration node, you can create instances of Oracle Traffic Director configurations on the administration node. Note that on each administration node, you can create only one instance of a configuration.