Starting the Administration Tool


The administration tool is located in your <installation_path> /bin directory and is a stand-alone executable named tibemsadmin on UNIX and tibemsadmin.exe on Windows platforms.

Type tibemsadmin -help to display information about tibemsadmin startup parameters. All tibemsadmin parameters are optional.

Table 19 lists options for tibemsadmin.

Table 19 tibemsadmin Options (Sheet 1 of 2)
Option
Description
-help or -h
Print the help screen.
-script <script-file>
Execute the specified text file containing tibemsadmin commands then quit. Any valid tibemsadmin command described in this chapter can be executed.
Line breaks within the file delimit each command. That is, every command must be contained on a single line (no line breaks within the command), and each command is separated by a line break.
-server <server-url>
Connect to specified server.
-user <user-name>
Use this user name to connect to server.
-password <password>
Use this password to connect to server.
-ignore
Ignore errors when executing script file. This parameter only ignores errors in command execution but not syntax errors in the script.
-mangle [password]
Mangle the password and quit. Mangled string in the output can be set as a value of server password or server SSL password in the server configuration file. If the password is not entered it is prompted for.
-ssl_trusted <filename>
File containing trusted certificate(s). This parameter may be entered more than once if required.
-ssl_identity <filename>
File containing client certificate and (optionally) extra issuer certificate(s), and the private key.
-ssl_issuer <filename>
File containing extra issuer certificate(s) for client-side identity.
-ssl_password <password>
Private key or PKCS#12 password. If the password is required, but has not been specified, it will be prompted for.
-ssl_noverifyhostname
Do not verify hostname against the name on the certificate.
-ssl_hostname <name>
Name expected in the certificate sent by the host.
-ssl_trace
Show loaded certificates and certificates sent by the host.
-ssl_debug_trace
Show additional tracing, which is useful for debugging.

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.

Examples

tibemsadmin -server "tcp://myhost:7222" 
tibemsadmin -server "tcp://myhost:7222" -user admin -password secret

Some options are needed when you choose to make a SSL connection. For more information on SSL connections, refer to Chapter 12, 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. Log in and connect to the administration tool, as described directly above.
  2. Change the password by entering:
  3.    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.


TIBCO Enterprise Message Service™ User’s Guide
Software Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com