The generate-diagnostic-report command generates an HTML report that contains pointers or navigational links to a application server installation details such as configuration details, HADB information, logging details, process specific information, for an application server instance. If report generation is targeted for a domain, data is collected for all instances belonging to the domain and is stored on DAS. Such data may help diagnose application server malfunctioning such as exceptions, performance bottlenecks, and unexpected results. This command is supported in remote and local mode. In local mode, reports can be generated for a DAS, a server instance, or a node agent. In remote mode, this command can generate reports for all the targets supported by the local mode and for the entire domain or a cluster.
Indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-formatted data for consumption by a script. Default is false.
Setting to true will echo the command line statement on the standard output. Default is false.
If set to true (default), only the required password options are prompted.
The machine name where the domain administration server is running. The default value is localhost.
The HTTP/S port for administration. This is the port to which you should point your browser in order to manage the domain. For example, http://localhost:4848.
The default port number for Platform Edition is 4848. The default port number for Enterprise Edition is 4849.
If set to true, uses SSL/TLS to communicate with the domain administration server.
The authorized domain administration server administrative username.
If you have authenticated to a domain using the asadmin login command, then you need not specify the --user option on subsequent operations to this particular domain.
The ––passwordfile option specifies the name of a file containing the password entries in a specific format. The entry for the password must have the AS_ADMIN_ prefix followed by the password name in uppercase letters.
For example, to specify the domain administration server password, use an entry with the following format: AS_ADMIN_PASSWORD=password, where password is the actual administrator password. Other passwords that can be specified include AS_ADMIN_MAPPEDPASSWORD, AS_ADMIN_USERPASSWORD, and AS_ADMIN_ALIASPASSWORD.
All remote commands must specify the admin password to authenticate to the domain administration server, either through ––passwordfile or asadmin login, or interactively on the command prompt. The asadmin login command can be used only to specify the admin password. For other passwords, that must be specified for remote commands, use the ––passwordfile or enter them at the command prompt.
If you have authenticated to a domain using the asadmin login command, then you need not specify the admin password through the ––passwordfile option on subsequent operations to this particular domain. However, this is applicable only to AS_ADMIN_PASSWORD option. You will still need to provide the other passwords, for example, AS_ADMIN_USERPASSWORD, as and when required by individual commands, such as update-file-user.
For security reasons, passwords specified as an environment variable will not be read by asadmin.
Displays the help text for the command.
Absolute path to the filename on the client machine. The filename must end with a .jar extension. This option is mandatory in both the local and remote mode.
A text file describing customer's information such as customer name, customer point of contact, error description. Contents of this file are appended to the diagnostic report.
One or more IDs of known bugs similar to customer issue, separated by comma.
Use the mm/dd/yy format to specify the date from which server.log files for server instances are captured (if log rotation is enabled). If the date is not specified, number of entries from server.log file as specified by max-no-of-entries matching min-log-level in diagnostic service are collected.
Date in mm/dd/yy format. If specified, takes precedence over max-no-of-entries from diagnostic-service configuration.If you specify a ––logenddate, you will need to specify a ––logstartdate also. If specified, entries between ––logstartdate and ––logenddate matching min-log-level are captured. If this option is not specified, max-no-of-entries from diagnostic-service is used to limit the server.log content being captured.
If set to true, the generate-diagnostic-report command runs in local mode and collects a limited set of information. When the command is run locally for a domain, data for the default server instance, that is, the DAS for the domain, is collected. In local mode, this command can generate report for a DAS, a server instance, or a node agent.
This option is required only if the command is run locally. If target is a domain name, this value is parent directory of the domain upon which the command will operate. This is a mandatory field in local mode.
allowed values are domain, cluster, nodeagent and instance.
generates report for all clustered and non clustered instances administered by the DAS, including default admin server instance. This command when executed locally, collects information for default server instance only.
generates report for every server instance in the cluster.
generates report for a particular physical node; that is, for instances belonging to the node.
generates report for a particular server instance.
asadmin> generate-diagnostic-report --user admin --port 4848 --outputfile /export/software/sjsas/diagnostic-reports/domain1.jar domain1 Please enter the admin password> Following attributes from domain.xml are masked with **** in the generated report. domain/configs/config=server-config/jms-service/jms-host=default_JMS_host/admin-password="admin" If you want to mask additional properties, use create-password-alias and set com mand before continuing the report generation. Press 'y' to continue or 'n' to exit : y Command generate-diagnostic-report executed successfully.
asadmin> asadmin generate-diagnostic-report --user admin --local=true --outputfile /export/software/sjsas/diagnostic-reports/domain1.jar --targetdir /export/software/sjsas/domains domain1 Following attributes from domain.xml are masked with **** in the generated repor t.domain/configs/config=server-config/jms-service/jms-host=default_JMS_host/admin- password="admin" If you want to mask additional properties, use create-password-alias and set com mand before continuing the report generation. Press 'y' to continue or 'n' to exit : y Report File : /export/software/sjsas/diagnostic-reports/domain1.jar Command generate-diagnostic-report executed successfully.