Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 6 Using the EMS Administration Tool : Starting the EMS Administration Tool

Starting the EMS Administration Tool
The EMS Administration Tool is located in your EMS_HOME/bin directory and is a stand-alone executable named tibemsadmin on UNIX and tibemsadmin.exe on Windows platforms.
On a computer running Windows, you can also start the administration tool from the Start menu, following the path All Programs > TIBCO > TIBCO EMS 8.4 > Start EMS Administration Tool. If TIBCO Enterprise Message Service is installed in an installation environment with a custom ENV_NAME, that environment name is part of the Start menu path.
The EMS server must be started as described in Chapter 5, Running the EMS Server before you start the EMS Administration Tool.
When a system uses shared configuration files in the .conf format, actions performed using the tibemsadmin tool take effect only when connected to the active server.
When a system uses a shared configuration file in the .json format, most commands in the tibemsadmin tool are unavailable when connected to a server that is not in the active state. In such a situation, the only commands available are show connections, show state, shutdown, and rotatelog.
Type tibemsadmin -help to display information about tibemsadmin startup parameters. All tibemsadmin parameters are optional.
Table 16 lists options for tibemsadmin.
-help or -h
-script script-file
Execute the specified text file containing tibemsadmin commands then quit. Any valid tibemsadmin command described in this chapter can be executed.
-server server-url
-user user-name
-password password
-pwdfile password-file
Use the clear-text password in the specified file to connect to the server. If both -pwdfile and -password options are given, the password specified through the -password option takes precedence.
-mangle [password]
-ssl_issuer filename
-ssl_key filename
-ssl_pwdfile password-file
Use the private key or PKCS12 password in the specified file to connect to the server. If both -ssl_pwdfile and -ssl_password options are given, the password specified through the -ssl_password option takes precedence.
 
When a command specifies -user and -password, that information is not stored for later use. It is only used to connect to the server specified in the same command line. The user name and password entered on one command line are not reused with subsequent connect commands entered in the script file or interactively.
Some options are needed when you choose to make a SSL connection. For more information on SSL connections, refer to Chapter 18, Using the SSL Protocol.
When You First Start tibemsadmin
The administration tool has a default user with the name admin. This is the default user for logging in to the administration tool.
To protect access to the server configuration, you must assign a password to the user admin.
Assign a Password to the Administrator
1.
2.
Use the set password command to change the password:
   set password admin password
When you restart the administration tool and type connect, the administration tool now requires your password before connecting to the server.
For further information about setting and resetting passwords, refer to set password on page 144.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved