System and web server information MustGather tool¶
[If you have not yet downloaded and installed the ihsdiag
tool, then
refer to 'Downloading and installing the diagnostic
tools' for the steps to do that.]
This ServerDoc
tool provided with ihsdiag
gathers information about
the operating system and the IBM HTTP Server installation. It can be
used in a variety of circumstances, and is intended to replace the
traditional list of instructions for manually gathering basic
information about the IBM HTTP Server and IBM Global Security Kit (GSKit) versions. It will gather
the traditional information and more, in order to avoid some requests
for additional data.
ServerDoc
automates the work of gathering this information. The user
runs ServerDoc
and provides the IHS installation directory as a
parameter; ServerDoc
creates a new directory to hold the required
documentation, and stores the gathered information in that new
directory.
Once the ServerDoc
tool has completed, the user should copy any
remaining log files and configuration files used by the web server and
the plug-in into the new directory along with any data gathered for
other MustGather documents which point to this one, and then send a
packed copy of that data directory to IBM support.
Running the tool¶
This tool may be used to gather documentation when there are problems
with the ikeyman
, gsk5cmd
, or gsk7cmd
programs. Ensure that PATH
and JAVA_HOME are set to the same values when running this tool as they
are when encountering problems with the ikeyman
, gsk5cmd
, or
gsk7cmd
programs.
On Unix and Linux platforms, run the tool as root
to avoid any
permissions problems with reading files or system information.
ServerDoc is passed in two parameters for gathering this information:
the task to be performed (i.e.
DescribeConfig
)the pathname of the IHS installation directory (e.g., /usr/HTTPServer)
# java -jar ServerDoc.jar DescribeConfig /path/to/IHS
The tool creates a new directory which contains a timestamp in the name, and the gathered information will be saved in that directory.
a sample run on Unix¶
For this example, IHS is installed in /usr/IHS20422-PQ85834
and
ihsdiag was unpacked into directory /root/ihsdiag-1.4.1
.
# cd /tmp
# java -jar /root/ihsdiag-1.4.1/ServerDoc.jar DescribeConfig /usr/IHS20422-PQ85834
Web server version: 2.0.42.2-PQ85834
Available IBM Global Security Kit (GSKit) version: 5.0.5.92
Available IBM Global Security Kit (GSKit) version: 7.0.3.9
Reports, log files, and configuration files have been saved to directory
ServerConfig.200505111519
If you have additional log files or configuration files, copy them there
before packing up the directory.
Web server log and conf files other than the default will have to be
copied manually.
WebSphere plug-in conf and log files will have to be copied manually.
Hint for packing up the directory:
tar -cf ServerConfig.200505111519.tar ServerConfig.200505111519
gzip ServerConfig.200505111519.tar
# ls -l ServerConfig.200505111519/
total 4680
-rw-r--r-- 1 root system 1886 May 11 15:19 US_export_policy.jar
-rw-r--r-- 1 root system 1613349 May 11 15:19 access_log
-rw-r--r-- 1 root system 5389 May 11 15:19 apachectl
-rw-r--r-- 1 root system 1278 May 11 15:19 error_log
-rw-r--r-- 1 root system 544058 May 11 15:19 httpd
-rw-r--r-- 1 root system 29345 May 11 15:19 httpd.conf
-rw-r--r-- 1 root system 3373 May 11 15:19 ikeyman
-rw-r--r-- 1 root system 2360 May 11 15:19 local_policy.jar
-rw-r--r-- 1 root system 169317 May 11 15:19 log
-rw-r--r-- 1 root system 285 May 11 15:19 report
-rwxr-xr-x 1 root system 20 May 11 15:19 showulimit.sh
#
a sample run on Windows¶
For this example, IHS is installed in D:\HTTPServer
and ihsdiag
is
located in directory C:\ihsdiag-1.4.14
.
(If you don't have a public Java available on the system, you can use
the Java jre installed under the IHS install directory, as shown in this
example).
C:\>cd C:\ihsdiag-1.4.14
C:\ihsdiag-1.4.14>java -jar ServerDoc.jar DescribeConfig D:\HTTPServer
No public JRE.
C:\ihsdiag-1.4.14>D:\HTTPServer\java\jre\bin\java -jar ServerDoc.jar DescribeConfig D:\HTTPServer
Web server version: 7.0.0.13
Available local IBM Global Security Kit (GSKit) version: 7.0.4.28 (32-bit)
Reports, log files, and configuration files have been saved to directory
ServerConfig.201101141130
If you have additional log files or configuration files, copy them there
before packing up the directory.
Web server log and conf files other than the default will have to be
copied manually.
WebSphere plug-in conf and log files will have to be copied manually.
Hint for packing up the directory:
zip -r ServerConfig.201101141130.zip ServerConfig.201101141130
(or use any other program to create a .zip)
C:\ihsdiag-1.4.14>dir /s ServerConfig.201101141130
Volume in drive C has no label.
Volume Serial Number is F80A-9DAA
Directory of C:\ihsdiag-1.4.14\ServerConfig.201101141130
01/14/2011 11:30 AM <DIR> .
01/14/2011 11:30 AM <DIR> ..
01/14/2011 11:30 AM <DIR> files
01/14/2011 11:30 AM 67,331 log
01/14/2011 11:30 AM 341 report
2 File(s) 67,672 bytes
Directory of C:\ihsdiag-1.4.14\ServerConfig.201101141130\files
01/14/2011 11:30 AM <DIR> .
01/14/2011 11:30 AM <DIR> ..
01/14/2011 11:30 AM <DIR> HTTPServer
0 File(s) 0 bytes
Directory of C:\ihsdiag-1.4.14\ServerConfig.201101141130\files\HTTPServer
01/14/2011 11:30 AM <DIR> .
01/14/2011 11:30 AM <DIR> ..
01/14/2011 11:30 AM <DIR> bin
01/14/2011 11:30 AM <DIR> conf
01/14/2011 11:30 AM <DIR> logs
01/14/2011 10:25 AM 24 version.signature
1 File(s) 24 bytes
Directory of C:\ihsdiag-1.4.14\ServerConfig.201101141130\files\HTTPServer\bin
01/14/2011 11:30 AM <DIR> .
01/14/2011 11:30 AM <DIR> ..
01/14/2011 10:25 AM 455 ikeyman.bat
1 File(s) 455 bytes
Directory of C:\ihsdiag-1.4.14\ServerConfig.201101141130\files\HTTPServer\conf
01/14/2011 11:30 AM <DIR> .
01/14/2011 11:30 AM <DIR> ..
01/14/2011 10:22 AM 5,672 admin.conf
01/14/2011 10:25 AM 5,672 admin.conf.default
01/14/2011 10:21 AM 0 admin.passwd
01/14/2011 10:22 AM 30,623 httpd.conf
01/14/2011 10:25 AM 30,623 httpd.conf.default
01/14/2011 10:21 AM 8,336 ldap.prop.sample
01/14/2011 10:22 AM 13,340 magic
01/14/2011 10:21 AM 13,340 magic.default
01/14/2011 10:22 AM 15,612 mime.types
01/14/2011 10:21 AM 15,612 mime.types.default
10 File(s) 138,830 bytes
Directory of C:\ihsdiag-1.4.14\ServerConfig.201101141130\files\HTTPServer\logs
01/14/2011 11:30 AM <DIR> .
01/14/2011 11:30 AM <DIR> ..
01/14/2011 11:29 AM 1,976 access.log
01/14/2011 11:29 AM 1,573 error.log
2 File(s) 3,549 bytes
Total Files Listed:
16 File(s) 210,530 bytes
17 Dir(s) 31,381,282,816 bytes free
C:\ihsdiag-1.4.14>
Gathering additional files (web server and plug-in files + system information)¶
The next step is to copy and save additional web server or plug-in
configuration files and logs, and system information into the new
ServerConfig.timestamp
directory.
Some of this may require first running commands and gathering
information specified by other Mustgather documents which point to this
one.
Here is a list of typical files to copy if they exist:
any IHS configuration file other than
httpd.conf
any additional web server error or access log files, such as log files specific to each virtual host or log files created by rotatelogs
the WebSphere plug-in configuration file
the WebSphere plug-in log file
(Windows only) Windows system information:
Run 'Start / All Programs / Accessories / System Tools / System Information'
Highlight the top level item in the tree (
'System Summary'
or'System Information'
)If the top level in the tree was
'System Summary'
, then select'File->Export...'
, else
if the top level in the tree was'System Information'
, then right mouse click and select'Save as Text File'
Enter
"system_info"
for the filenameSave to the '
ServerConfig.timestamp
' directory(It may take a few minutes to save the file)
Saving the documentation directory¶
The last step is to pack up and compress the ServerConfig.timestamp
documentation data directory using zip, tar followed by gzip, or tar
followed by compress. The easiest way is to cut and paste the portion of
the ServerDoc output which showed the commands to use. The suggested
commands will vary by platform. On z/OS, for example, compress will be
suggested instead of gzip.
If you were pointed to these directions by another Mustgather document (i.e. for crashes or hangs) then complete all steps for gathering data in those Mustgather documents before returning here to complete this step of packing the directory.
a sample run on Unix¶
# tar -cf ServerConfig.200505111519.tar ServerConfig.200505111519
# gzip ServerConfig.200505111519.tar
The resulting compressed file is the file to send to IBM support.
a sample run on Windows¶
C:\ihsdiag-1.4.14>zip -r ServerConfig.201101141130.zip ServerConfig.201101141130
adding: ServerConfig.201101141130/ (stored 0%)
adding: ServerConfig.201101141130/files/ (stored 0%)
adding: ServerConfig.201101141130/files/HTTPServer/ (stored 0%)
adding: ServerConfig.201101141130/files/HTTPServer/bin/ (stored 0%)
adding: ServerConfig.201101141130/files/HTTPServer/bin/ikeyman.bat (deflated 40%)
adding: ServerConfig.201101141130/files/HTTPServer/conf/ (stored 0%)
adding: ServerConfig.201101141130/files/HTTPServer/conf/admin.conf (deflated 61%)
adding: ServerConfig.201101141130/files/HTTPServer/conf/admin.conf.default (deflated 61%)
adding: ServerConfig.201101141130/files/HTTPServer/conf/admin.passwd (stored 0%)
adding: ServerConfig.201101141130/files/HTTPServer/conf/httpd.conf (deflated 66%)
adding: ServerConfig.201101141130/files/HTTPServer/conf/httpd.conf.default (deflated 66%)
adding: ServerConfig.201101141130/files/HTTPServer/conf/ldap.prop.sample (deflated 66%)
adding: ServerConfig.201101141130/files/HTTPServer/conf/magic (deflated 65%)
adding: ServerConfig.201101141130/files/HTTPServer/conf/magic.default (deflated 65%)
adding: ServerConfig.201101141130/files/HTTPServer/conf/mime.types (deflated 71%)
adding: ServerConfig.201101141130/files/HTTPServer/conf/mime.types.default (deflated 71%)
adding: ServerConfig.201101141130/files/HTTPServer/logs/ (stored 0%)
adding: ServerConfig.201101141130/files/HTTPServer/logs/access.log (deflated 86%)
adding: ServerConfig.201101141130/files/HTTPServer/logs/error.log (deflated 70%)
adding: ServerConfig.201101141130/files/HTTPServer/version.signature (stored 0%)
adding: ServerConfig.201101141130/log (deflated 82%)
adding: ServerConfig.201101141130/report (deflated 28%)
The resulting ServerConfig.201101141130.zip
file is the file to send
to IBM support.