Copyright © TIBCO Software Inc. All Rights Reserved

> 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 Programs > TIBCO > TIBCO EMS 6.1 > Start EMS administration tool.
> 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, then actions performed using the administration tool take effect only when connected to the active server. If you have configured fault-tolerant servers and connect to the standby server, the administration tool will print a message notifying you of this. Additionally, if the administration tool is connected to the backup server, it will be disconnected when a switchover occurs.

> Type tibemsadmin -help to display information about tibemsadmin startup parameters. All tibemsadmin parameters are optional.
> Table 15 lists options for tibemsadmin.

> Table 15 tibemsadmin Options
> 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 one of these passwords from the configuration files:
> • | server password
> • | server SSL password
> • | LDAP admin password
> • | database password
> 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://host:7222" tibemsadmin -server "tcp://host: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 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. | Log in and connect to the administration tool, as described directly above.

> 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 136.

Copyright © TIBCO Software Inc. All Rights Reserved