To troubleshoot an installation problem, identify your problem in the following list, and follow the link to a description of the solution.
If you cannot find your problem described in the list, and cannot resolve it yourself, contact Customer Support Services as described in Information You Should Have and Customer Support.
If you have a troubleshooting suggestion that is not described in the list, and you think others will find it helpful, we invite you to send it to us, as described in How to Add Your Problem to the Troubleshooting Guide. We will consider including your problem in a future release of this manual.
Problems:
See Problem: Java Listener Fails to Start With JVM not found Messages Written to the Log.
This means that the underlying glibc libraries are not high enough for isetup (nor the server) to run. Examine the error message to determine which version is missing, and then install that GLIBC RPM version (or higher), and any GLIBC dependencies, before proceeding.
Many UNIX environments intentionally limit the ability to read core files in setuid applications for security reasons. On some platforms, the feature is configurable, but the commands to activate it vary by platform or may not be implemented in earlier OS releases. If the crash can be reproduced in an unsecured server, the core information will be produced. This is the best route to producing a complete save diagnostic. If the server cannot be run unsecured to produce the crash:
See Problem: Forcing Core Dump Information on Solaris.
See Problem: Forcing Core Dump Information on HP-UX.
Problem: The server starts in safe mode. The Web Console home page displays a message stating that the server is in safe mode and describing what triggered it.
Cause: A common cause for the server starting in safe mode is a problem with the server administrator ID password. For example, the password may have been updated on the operating system but not on the server, so that the encrypted copy of the password stored by the server is out of synchronization with the password on the operating system.
Solution: The server administrator can click the fix hyperlink, which is displayed under the problem description, to display the relevant pane and resolve the problem.
For example, if the problem is that the server administrator password is out of synchronization:
The Access Control pane is displayed on the right.
The Security Mode pane opens on the right.
Problem: The listener start request fails with JVM not found messages written to the edaprint.log file.
Cause: If the server cannot find the Java Virtual Machine (JVM), the JSCOM Listener will not be able to start, and messages will be written to the server log stating that the JVM cannot be found.
The server log is
On Windows:
drive:\ibi\srv77\server_type\edaprint.log
On UNIX:
ibi/srv77/server_type/edaprint.log
On IBM i:
/home/iadmin/ibi/srv77/server_type/edaprint.log
where:
Is the hard drive on which the directory resides (on Windows).
Designates the type of server. The default values are:
FFS | for a Full-Function Server |
DM | for a DataMigrator Server |
WFS | for a WebFOCUS Reporting Server |
WFM | for a Shared Application Server for WebFOCUS Maintain |
Solution: Set up the JVM as described in JVM Requirements for the Listener for Java.
The ulimit value of a process controls how large (in blocks) a core can grow. If the value is set to zero, no dump is produced, and the dump information is not read.
To check the current value, issue:
ulimit -c
To set a ulimit so that dump information can be produced, stop the server, set a value, and restart:
bin/edastart -stop ulimit -c 99999 bin/edastart -start
The actual size value is in blocks and will vary by need, Since the need is unpredictable, select a number and then check the dump information. If the information is incomplete, increase the value.
Solaris uses the coreadm command to control the ability to produce core files.
To see the current value, issue:
coreadm
For secured servers, before the server starts, issue:
coreadm -e proc-setid
No reboot of OS or service daemons is required, but core files must have a non-zero ulimit –c value.
As of HP-UX 11.31, the coreadm command controls the ability to produce core files. Sites with an operating system prior to HP-UX 11.31 can only use the unsecure server method to produce a complete save diagnostic for a crash.
To see the current value, issue:
coreadm
For secured server purposes (on HP-UX 11.31 or higher), before the server starts, issue:
coreadm -e proc-setid
No reboot of OS or service daemons is required, but core files must have a non-zero ulimit –c value.
AIX uses the chdev command to control the ability to produce core files. This command is on by default, so it only needs to be adjusted if it has been turned off.
To see the current value, issue:
lsattr -El sys0 -a fullcore
For secured server purposes, before the server starts, issue:
chdev -l sys0 -a fullcore=true
While Linux has options to activate core dumps, none currently work in the context of the server. Linux sites can only use the unsecure server method to produce a complete save diagnostic for a crash.
The full message indicates the need to review edapth traces for r1shmop* entries with errors. If the server was not started with traces, start it with traces, and then view the edapth trace.
One of the r1shmop* entries in the edapth trace will show a specific error, but a common error is "size is greater than system shared memory limit." This particular message indicates that the system kernel value for shared memory needs to be increased. The actual required value is generally a multiple of machine page size (typically 4K, but it can vary). The number of agents a server runs, and other installed software can also be a factor, and the required value may vary (slightly) from release to release.
There are tools, such as size and ps that will allow an experienced administrator to narrow down the precise shared memory size requirements, considering all of the software in use. However, a good rule of thumb is to increase memory in 10% increments until a working value is found.
Error messages other than "shared memory size" can occur, in which case, the system message is displayed. These other messages may provide an administrator with enough information to determine the appropriate action. If not, call Customer Support Services for a review. Actual kernel change commands/steps vary by vendor, so they are not explicitly outlined here.
A server will implicitly attempt to start unsecured if proper authorization steps have not been completed. Starting the server normally clears edatemp. If prior edatemp files exist (and authorization has not been done), start up will fail due to an inability to clear the directory. However, if an edastart -cleardir command was issued just before the upgrade, there is nothing to clear, no error occurs, and the server starts. If the server starts and is not inspected after the initial start up, the server being in the wrong mode may go unnoticed.
The proper solution is to add proper authorizations after an upgrade, as described in How to Configure Security Mode OPSYS, and restart the server. A new safety measure has also been added. If the environment variable EDAEXTSEC is set to OPSYS explicitly, and a server lacks authorization, it will not start (see Preventing Unsecured Server Starts After Upgrades for details).
If you have troubleshooting suggestions that you think others will find helpful, we invite you to send them to us so that we can consider including them in a future release. You can:
Please include your name, phone number, e-mail address, and postal address.
If instructed by Customer Support Services, you can install and activate a debuggable version of the server to help troubleshoot a problem.
Caution: Do not activate the debuggable version unless explicitly requested to by Customer Support Services.
To activate the debuggable version of the server:
edastart -stop edastart -dbgon edastart -start (run until repro is completed) edastart -stop edastart -dbgoff edastart -start
Customer Support Services will provide you with additional instructions as your situation requires.
iWay Software |