Oracle® Explorer Data Collector User's Guide Release 6.8 for Oracle Solaris Part Number E21076-03 |
|
|
PDF · Mobi · ePub |
This chapter provides details for using Oracle Explorer Data Collector and how to submit output files to Oracle Support.
Follow the procedure below to install and use Oracle Explorer Data Collector from an alternate path after you have downloaded the latest installer (see "Download Oracle Explorer Data Collector"):
Complete steps 1 through 7 in "Extracting Individual Packages".
Note:
The Remote Diagnostic Agent (RDA) needs to be installed, too, in order for Oracle Explorer to be able to collect all information.As superuser, install Explorer. Run:
pkgadd -R <alternate root> -d . SUNWexplo SUNWexplu
Create default configuration file for alternate root instance as <alternate root>/etc/opt/SUNWexplo/default/explorer running <alternate root>/opt/SUNWexplo/bin/explorer -g
To run Explorer from alternate path, use the -d option to locate the alternate default configuration file:
<alternate root>opt/SUNWexplo/bin/explorer -d <alternate root>/etc/opt/SUNWexplo/default/explorer
Installing Oracle Explorer on multiple servers can be a time-consuming task. To reduce the installation time, install Oracle Explorer on one system and then use NFS mount to share the install directory with other systems.
Create an Oracle Explorer Data Collector defaults file for the NFS client by performing the following substeps on the NFS server with the tool installed:
Note:
Most values in the NFS server's Oracle Explorer Data Collector defaults file are valid for all servers in the environment.Record the NFS client's host name and host ID.
Become superuser.
Go to the Oracle Explorer default directory.
cd /etc/opt/SUNWexplo/default
Copy and rename the defaults file to associate it with the host (for example, explorer.hostname).
cp explorer nfs_dir/explorer.hostname
Edit the new explorer.hostname file to reset the following variable (where hostid is the client's hostid):
EXP_SERIAL_$hostid="Client's serial number"
Reference the client's Oracle Explorer Data Collector defaults file.
Note:
When using the explorer command on an NFS client, you must specify the Oracle Explorer Data Collector defaults file as input, and you must specify the output directory location. If you do not specify the client's Oracle Explorer defaults file, the NFS server's defaults file is used. If you do not specify the output directory location, an attempt is made to write the output to the NFS server's explorer_install_dir/output directory. The NFS mounted file system might not allow writing over the NFS mount.Use the following Oracle Explorer options:
Specify the defaults file with -d nfs_client_accessible_dir/explorer.host-name
Specify the directory in which to write the output with -t /var/tmp (which is a local writable directory)
Direct output to a local, writable directory by performing the following substeps on the NFS client:
Become superuser.
Mount the explorer_install_dir directory from the NFS server
Change directories into the mount point.
Execute the following command to send output to the client's /var/tmp/output directory:
# explorer -d nfs_dir/explorer.hostname -t /var/tmp
Do the following to schedule Oracle Explorer Data collector to run on an NFS client using cron:
Verify that the NFS server is available.
Verify that the explorer_install_dir directory is mounted on the NFS server.
Do not send messages to standard output or to standard error.
Redirect to specific files or /dev/null
This section describes the procedure to manually submit a Oracle Explorer output file to the Oracle Explorer database (ConfigDB).
Open a terminal window and type: ftp supportfiles.sun.com
Type the following user name and password to log in:
Username: anonymous Password: your_email_address
Type the following commands at the ftp prompt:
ftp> cd /explorer ftp> bin ftp> hash ftp> put explorer.filename
Note:
The title explorer.filename is the name of the file to upload. Use explorer as the file name prefix.For example: explorer.80a711xy.abcdf-2002.04.01.12.40-tar.gz
Open a terminal window and type: ftp sunsolve.sun.co.uk
Type the following user name and password to log in:
Username: anonymous Password: your_email_address
Type the following commands at the ftp prompt:
ftp> cd cores/uk/incoming ftp> bin ftp> hash ftp> put explorer.filename
Note:
The title explorer.filename is the name of the file to upload. Use explorer as the file name prefix.For example: explorer.80a711xy.abcdf-2002.04.01.12.40-tar.gz
This section describes the procedure to manually submit an Oracle Explorer Data Collector output file to the database (ConfigDB).
For HTTP, the upload link is: http://supportfiles.sun.com/upload
For HTTPS, the upload link is: https://supportfiles.sun.com/upload
Oracle Explorer Data Collector files need to be uploaded to the following destinations for automatic submission to the correct configdb.
AMER - explorer-amer
APAC - explorer-apac
EMEA - explorer-emea
Explorer can be run for the following modules/groups:
explorer -w all
Runs all modules.
explorer -w all,interactive
If the modules tagged to the group all require user interaction, the user is prompted for input.
explorer -w default
Runs modules tagged to default
explorer -w default,interactive
Runs modules tagged to default group. If the modules tagged to the group default require user interaction, the user is prompted for input.
explorer -w extended
Runs modules tagged to extended group.
explorer -w extended, interactive
Runs all modules tagged to extended group using interactive mode if the corresponding *input.txt file is not populated.
explorer -w <module name>
If the <module name> requires user interaction, it runs in interactive mode.
explorer -w default,<module name>
Modules tagged under the group default and module_name are executed. Even if the modules tagged under the group default require user interaction, the user is NOT prompted for input. If the module_name requires user input (the corresponding configuration file *input.txt is not populated with relevant information), the user is prompted for input; if the module_name does not require user input, it is executed if hardware compatibility is met.
This section addresses known issues and workaround solutions for the Oracle Explorer Data Collector.
Oracle Explorer Data Collector Release 6.6 may truncate the ACT output on certain Solaris 10 systems that has ACT versions between 8 and 8.14 installed. This truncation is done to avoid file system overflow described in ACT bug 6897128.
Work around: Download and install the latest version of ACT into the system.
If you attempt to run Oracle Explorer Data Collector as a background process in a terminal without -SR, -esc, or -case options, then the tool may wait for you to input (on Explorer type) at the background. In such cases, the tool will not complete its execution and will wait on your input.
Work around: You may note a stopped message on the terminal indicating the suspended process at the background. You will need to bring the suspended process to foreground and then provide the appropriate response to all the Oracle Explorer Data Collector to continue its run.