rsdiag

The rsdiag command-line utility captures the information about a Replication Server's configuration, its log files, and host details, and archives the information into a file that the customer can send to SAP technical support. It stores the results in XML format and provides a simple HTML file that you can view using a web browser.

Syntax

rsdiag -U username
    [-P password]
     -S [server_name | host:port]
	[-I interfaces_file] 
	[-L log_file] 
	[-N num_threads]
	[-O output_directory] 
	[-R resource_file] 
	[-T feature_list]
	[-h]
	[-m message_level] 
	[-D user_data_directory [-v]

Parameters

-I <interfaces_file>

(optional) specifies the name of the interfaces file. If <-I> is specified, rsdiag uses the <interfaces_file> and displays an error message if the file is not found. If <-I> is not specified, rsdiag first checks the LDAP server for the server entry, and if the entry is not found, rsdiag uses the default interfaces file in the directory specified by the SYBASE environment variable.

-L <log_file>

(optional) specifies the name of the log file that rsdiag creates. If the log_file is not an absolute path, the log file is created in the directory where rsdiag is executed. Whether you specify this parameter or not, rsdiag creates a default log file called rsdiag.log in the .zip output file.

-N <num_threads>

(optional) specifies the maximum number of parallel threads that rsdiag executes in parallel. The default value is <5>. Do not change the default value unless you cannot execute parallel collections.

-O <output_directory>

(optional) specifies the name of a local directory to store rsdiag output. If not specified, rsdiag creates the output .zip file in the directory where the command was executed. The output file is named rsdiag-<server name>-<datetime stamp>.zip.

-R <resource_file>

(optional) specifies the resource file that rsdiag uses on start-up. Use this option only at the direction of SAP Technical Support.

-P <password>

specifies your Replication Server password. If you do not specify the -P flag, rsdiag prompts for the password. If your password is NULL, use the-P flag without any password.

-S <server_name | host:port>

server_name specifies the name of the Replication Server to which rsdiag connects. rsdiag looks for this name in the interfaces file or the LDAP directory. If you specify <-S> with no argument, rsdiag looks for a server named SYBASE. If you do not specify <-S>, rsdiag looks for the server specified by your DSQUERY environment variable. The host:port entry specifies the machine name and the port number.

-T <feature_list>

(optional) specifies the type of diagnostic data that rsdiag gathers, based on these feature_list values:

osdata – operating system data
rscore – Replication Server configuration data
rsadd – Replication Server monitoring data
keyfile – information about Replication Server and operating system files

All diagnostic data is collected if you do not specify <-T>.

-U <username>

specifies a case-sensitive login name.

-h

(optional) displays all help options.

-m <message_level>

(optional) displays different levels of error messages depending on the value of message_level:

0 – no messages
1 – fatal errors only
2 – all errors
3 – warnings and all errors
4 – informational messages, warnings, and all errors
5 – debug and informational messages, warnings, and all errors

By default, the error message display level is set to 4.

-v

(optional) displays version information.

Examples

Example 1

# source SYBASE.sh
# rsdiag -Usa -PSybase123 -SD01

Usage

To gather all Replication Server data, you must have permission to access all data sources. You must run this command with user <sa> or a user who has the <sa_role> to collect Replication Server configuration and monitoring data.
To gather all environment data, you must have authorized access to operating system and the device files.
Note On Linux, you must have read permission to access operating system messages in /var/log/messages.
You must have read permissions on these files:
- Replication Server error log
- Replication Server configuration file
- Environment scripts such as SYBASE.csh, SYBASE.sh or SYBASE.bat
- You must have write permissions on an output directory specified by the <-O> parameter.
  Note If you do not have the required permissions on a file, rsdiag displays an error message and does not process that file.