Replicate TIBCO ActiveMatrix Administrator Server
Machine 2 - Replicate the Administrator server on
1. Run the installer, specifying the same TIBCO_HOME location as Machine 1 is using.
2. On Machine 1, copy the content of CONFIG_HOME/tct/keystore and put it in the same folder on Machine 2. Create the folder if it does not exist.
3. Launch TIBCO Configuration Tool and select the same CONFIG_HOME as was used on Machine 1.
4. Configure the same third-party driver as you did on Machine 1.
5. When TIBCO Configuration Tool returns to the wizard selection screen, click Replicate TIBCO
ActiveMatrix Administrator Server and configure the replica server by responding to the wizard prompts.
a. In the Remote Administrator Details screen, enter the information to connect to the first Administrator server. This information is used to fetch the current configuration.
b. When you click Next, Machine 2 settings are validated. As part of validation, the wizard checks that.
– Both machines use the same CONFIG_HOME.
– The shared folder is accessible and contains valid data.
– The first administrator server is using an external database.
c. When validation is successful, you can provide a unique host name and node name for the replica server on the next screen.
The wizard displays the current Administrator server configuration. You cannot edit the configuration.
d. Enter passwords when prompted.
e. After you have entered all configuration details, click Configure to replicate the Administrator server.
The TIBCO Configuration Tool Replicate TIBCO ActiveMatrix Administrator Server wizard does not show the configuration details for Monitoring, Logging and Payload services. If those services are configured and deployed on the first Administrator server, they are automatically deployed on the replica server as part of the replication process.
When you log in to one of the Administrator servers (or access the load balancing URL), you see the following system setup:
• Two hosts exist in the Infrastructure > Hosts screen.
• Two nodes exist in the SystemEnvironment environment in the Infrastructure > Nodes screen
After you have completed the setup, requests can be processed by either server. If one server is unavailable, the other server can process requests.
Remote Administrator Server Details
The Remote Administrator Server Details screen allows you to specify the machine name and port for the primary server. You must also specify the username and password. If you configured the primary server with SSL, you must perform SSL configuration for the replica server as well.
Description Field
Name of the machine on which the primary Administrator server runs. The value of this property must a hostname resolvable through DNS or an IP address.
Machine Name
TIBCO ActiveMatrix Service Grid Installation and Configuration 86 | Configuration
Description Field
Management port that the primary Administrator server is using.
Default: 8120 Port
User name of the administrator of the primary Administrator server. This user must be a super user. This credential is used to access the first admin server to Username
get the current configuration. Only super user is allowed to query the current configuration.
Default: root
Specify the password of the administrator of the primary Administrator server.
Password
If the primary Administrator server is SSL enabled, click this check box so that TIBCO Configuration Tool uses SSL to connect to the primary Administrator Administrator server is
SSL enabled
server. If you click the check box, you are prompted for keystore configuration information.
Click this button to verify that TIBCO Configuration Tool can access the server you specified using the username and password you specified.
Test Connection
Description Field
Invokes a wizard to import certificates from a server and create the trust store.
Create a Trust Store...
Invokes a dialog to navigate to a keystore file.
Browse
Location of the keystore.
Keystore Location
Type of the keystore: JKS or JCEKS.
Default: JKS.
Keystore Type
Password that protects the keystore.
Keystore Password
Create Replicated Instance Validation Info
The Create Replicated Instance Wizard Validation Info screen appears only if your system setup meets all requirements.
The requirements are listed in Setting Up Your Environment for Replication on page 85.
Administrator Server Configuration Details
You must specify a host name and node name for your replica server.
Description Field
Displays the enterprise name of the remote Administrator server. You cannot change the enterprise name; the remote server and the replica server must be in the same enterprise.
Enterprise Name
Name of the SystemHost instance that will be associated with the replica server.
The host name must be unique. You cannot use the name you used for the host associated with the remote Administrator server.
Default: SystemHostReplica Host Name
TIBCO ActiveMatrix Service Grid Installation and Configuration Configuration | 87
Description Field
Name of the SystemNode instance that will be associated with the replica server.
The node name must be unique. You cannot use the name you used for the node associated with the remote Administrator server.
Default: SystemNodeReplica Node Name
Administrator Server TIBCO Host Configuration
As part of the replica server setup, you specify the machine and port for the TIBCO host on which the replica server runs. This information is for the local machine, not the remote machine.
Description Field
Machine on which the TIBCO Host instance runs.
Machine
Port that the TIBCO Host instance will use to communicate with other services in the environment.
Port
Check to register the TIBCO Host instance as a Windows service named TIBCO ActiveMatrix Admin-enterpriseName-serverName with startup type Automatic. The service is not started.
Default: Unchecked.
Register as Windows Service
Check to add a shortcut named TIBCO ActiveMatrix Admin-enterpriseName-serverName that points to Create Windows Shortcut
CONFIG_HOME\tibcohost\Admin-enterpriseName-serverName\host\bin\tibcohost.exe
to the Windows desktop.
Default: Unchecked.
Administrator Server Connection Settings Description Field
Address of the network adapter on the machine on which the Administrator server runs. The default is set to 0.0.0.0 so that Administrator will listen on all Network Adapter
network adapters (including http://localhost and http://hostname). If you leave the default, clients can connect to the Administrator server using any of the conventions (localhost, IP address, hostname). The value of this property must either be a hostname resolvable through DNS or 0.0.0.0; it cannot be an IP address.
Management port of the node that runs Administrator server.
Default: 6021.
Management Port
Port on which Administrator clients access the Administrator server.
Default: 8120.
External HTTP Port
Check to secure communication between Administrator server and clients with SSL. When checked, the Self-Signed Certificate and Imported Certificate radio buttons display.
Default: Same as for remote server.
Enable SSL for External HTTP Port
TIBCO ActiveMatrix Service Grid Installation and Configuration 88 | Configuration
Description Field
Indicate that Administrator server will identify itself to clients with a self-signed certificate generated by TIBCO Credential Server.
Do not use a self-signed certificate in production environments.
Self-Signed Certificate
Default: Same as for remote server.
Indicate that Administrator server will identify itself to clients with a certificate imported into Administrator server. When selected, the Keystore fields and Fetch Keystore button are enabled.
Imported Certificate
Location of the keystore to import.
Keystore Location
Type of keystore.
Keystore Type
Password that protects the keystore.
Keystore Password
When you click this button, you can select one of the available key aliases, specify the keystore password, and click Verify Keystore to check that the password you entered is valid.
Fetch Keystore
Administrator Server Notification and Messaging Bus Server
The notification server is an Enterprise Message Service server delivers status messages sent by hosts and nodes to the Administrator server.
This screen displays the Enterprise Messaging Serer details used by the first Administrator server. With the exception of the Password field, you cannot edit the configuration. If SSL is enabled in the first admin server the SSL settings are displayed as well, but are not editable.
Click Test Connection to make sure that they can connect to EMS from the replica administrator machine.
Administration Server Database Details
The administrator server that you are replicating must be set up to use an external database. This screen displays the information about the external database used by the first admin server. You cannot change this information for the replica server.
Click Test Connection to make sure you can connect to the database from the replica machine.
Description Field
Driver for the external database: org.hsqldb.jdbcDriver, com.mysql.jdbc.Driver, or com.ibm.db2.jcc.DB2Driver.
Database Driver
URL of the external database.
Database URL
External database username.
Username
External database password.
Password
Maximum number of database connections to allocate.
Max Connections
Check to enable the database server for SSL. When checked, the SSL Keystore Configuration fields are enabled.
Database Server is SSL Enabled
TIBCO ActiveMatrix Service Grid Installation and Configuration Configuration | 89
Administrator Server Database Authentication Realm Details
If you selected a database authentication realm on the remote server, both Administrator server instances will store information about users and groups in a database. This screen displays connection information for the database you set up from the remote server.
You can review connection information in this screen, then enter the password for the specified database and click Test Connection.
Administrator Server Configuration LDAP Authentication Realm
If you select an LDAP authentication realm when you configure the remote Administrator server, Administrator retrieves information about users and groups from LDAP. This screen shows the LDAP configuration used by the first administrator server.
Click the Test Connection button to make sure the connection between LDAP server and the replica server works properly.
Administrator Server Configuration Summary
Each TIBCO Configuration Tool wizard's summary screen allows you to check the configuration that you specified and see the effects of that configuration. You can click Back to make changes, save the configuration for use by the silent installer, or click Configure to start the configuration. If you are using the console configuration tool, you can perform the same actions by typing single-letter commands, as prompted.
The Administrator Server Configuration Summary screen displays information about the session scripts and log folder and about the Administrator URL. For this wizard, you can only choose to replicate the remote server, or cancel the replication.
Deleting an Administrator Server
If you are using a replica Administrator server, you might want to delete a replica instance and create a new one. You perform this task from the command-line, the TIBCO Configuration Tool wizard does not allow you to delete an instance.
Before you begin
Make sure that the super user specified in the remote_props.properties has force_delete permission.
Only users with explicit force_delete and super user permission are allowed to delete the Administrator server instance.
About this task
Do not run the deletion script on the machine on which the Administrator instance you want to delete is running. For example, assume your cluster consists of Administrator instance A running on machine X and Administrator instance B running on machine Y. To delete instance B, run the script from instance A running on machine X.
Procedure
1. Open a command window.
2. Go to the following directory.
CONFIG_HOME/admin/enterprise_name/samples
3. Edit the deleteAdminInstance_data.xml file to update the node and host name properties.
4. Run the following command.
ant -f deleteAdminInstance_build.xml
When you run this command, the replica node is deleted from the environment and the replica host will be unregistered. If the replica host has any runtime nodes, the replica host is not unregistered.
TIBCO ActiveMatrix Service Grid Installation and Configuration 90 | Configuration
5. If the replica host is unregistered, got to the machine on which the administrator instance was running and terminate the tibcohost process.