+

Search Tips   |   Advanced Search

Administration and administrative console troubleshooting

Troubleshoot problems with administrative functions.

This topic references one or more of the application server log files. As a recommended alternative, we can configure the server to use the High Performance Extensible Logging (HPEL) log and trace infrastructure instead of using SystemOut.log , SystemErr.log, trace.log, and activity.log files on distributed and IBM i systems. We can also use HPEL in conjunction with the native z/OS logging facilities. If we are using HPEL, we can access all of the log and trace information using the LogViewer command-line tool from the server profile bin directory. See the information about using HPEL to troubleshoot applications for more information on using HPEL.

In WebSphere Application Server products, administrative functions are supported by:

The process must be running to use the administrative console. The wsadmin command-line utility has a local mode that we can use to perform some administrative functions, even when the server process is not running.

What kind of problem are you seeing?


Server status and messages in the console view are not current

When connecting to an Application Server that uses a SOAP connection for a long time, the following problems begin to occur:

This problem persists even once you restart the server or you start another server that uses the SOAP connection port.

The problem occurs because the SOAP connector does not support connection pooling. If the Application Server has many ongoing operations that use the SOAP connector, the Application Server quickly opens and closes many ports. Due to the nature of the underlying TCP/IP protocol, these ports remain in the TIME_WAIT state for some time prior to the operating system can reclaim them. The number of ports that WebSphere Application Server opens can exceed the limit that the operating system imposes. Under this condition, the opening of additional ports fails through the SOAP connector until the operating system reclaims ports.

Use the following options to work around the problem:


Role-based authorization fails

When we make a Java Management Extension (JMX) call such as getAttribute, setAttribute, invoke, and so on in the application, the caller requires an administrative role with sufficient permissions. The required role depends on the MBean attribute or method that the JMX caller calls and can be one of administrator, configurator, monitor, or operator. If one of the administrative roles is not assigned to the caller, or if the role is assigned, but the caller does not have the required permissions, the application receives a role-based authorization failure, for example:

SECJ0305I: Role based authorization check failed for securityname server.domain.name:3890/user.id, 
accessId user:server.domain.name:3890/uid=user.id,ou=xxxx,dc=yyy,dc=zzz while invoking method getNodeName on resource Server and module Server.
If the caller of the application cannot be assigned one of the administrative roles, the application can log in with one of the roles on behalf of the caller. For example:
 try 
 {
  // Create a LoginContext to authenticate a user ID and password.
    javax.security.auth.login.LoginContext 
    lc = new javax.security.auth.login.LoginContext("WSLogin", 
   new com.ibm.websphere.security.auth.callback.WSCallbackHandlerImpl("adminuser", 
    "adminpassword"));

  // perform the login   lc.login(); 

  // Get the authenticated subject.
  javax.security.auth.Subject adminSubject = lc.getSubject();

  // Define the action that will take place using the authenticated Subject
  // We can define this action anywhere in the code, the action
   // is reference in the WSSubject.doAs that follows.
  java.security.PrivilegedAction adminAction = new java.security.PrivilegedAction() 
  {
   public Object run() 
   {
    try 
    {
     // Get the WebSphere AdminService.                                  
     AdminService adminservice = AdminServiceFactory.getAdminService();      

     // Get the WebSphere Admin Local Server MBean instance.             
     ObjectName objectname = adminservice.getLocalServer();                  

     // Get the Node name.                                               
     String nodeName = (String)adminservice.getAttribute(objectname, "nodeName");

     // Get the Application Server name.                                 
     String serverName = (String)adminservice.getAttribute(objectname, "name");     
    
     // Get the Application Server Process ID.                           
     String serverPid = (String)adminservice.getAttribute(objectname, "pid");       

     // Return a result, for this example, just return the serverPid.
     return serverPid;
    } 
    catch (Exception e) 
    {
     e.printStackTrace();
    }
    return null;
   }
  });

  // Invoke an AdminClient resource using the authenticated subject.  
     // This example demonstrates the action of creating an 
     // administrative client and returning a String value to use outside 
     // the doAs block.
  String myData = (String) 
     com.ibm.websphere.security.auth.WSSubject.doAs(adminSubject, adminAction);

  // use "myData" later on....
 } 
 catch (javax.security.auth.login.LoginException e) 
 {
  e.printStackTrace();
 }


When starting or stopping a server using a wsadmin interactive scripting session, you receive an exception indicating read timed out

When starting or stopping a server using a wsadmin interactive scripting session, you receive an exception indicating read timed out, for example:

WASX7015E: Exception running command: "$AdminControl startServer server1 Node1"; 
exception information:  com.ibm.websphere.management.exception.ConnectorException 
org.apache.soap.SOAPException: [SOAPException: faultCode=SOAP-ENV:Client; msg=Read 
timed out; targetException=java.net.SocketTimeoutException: Read timed out]

(dist)(zos) This exception occurs because the timeout value is too small. Increase the timeout value specified by the com.ibm.SOAP.requestTimeout property in the soap.client.props file in the profile_root/properties directory for a single server edition or in the profile_root/properties directory for a network deployment installation. The value you choose depends on a number of factors such as the size and the number of the applications installed on the server, the speed of the machine, and the level of usage of the machine. The default value of the com.ibm.SOAP.requestTimeout property is 180 seconds.

(iseries) This exception occurs because the timeout value is too small. To fix this, increase the timeout value specified by the com.ibm.SOAP.requestTimeout property in the soap.client.props file in the profile_root/properties directory for a single server edition or in the profile_root/properties directory for a network deployment installation. The value you should choose depends on a number of factors such as the size and the number of the applications installed on the server, the speed of the machine, and the level of usage of the machine. The default value of the com.ibm.SOAP.requestTimeout property is 180 seconds.


Problems starting or using the administrative console or wsadmin utility

If we have problems starting or using the administrative console or wsadmin utility, verify that the supporting server process is started and that it is healthy.


The AdminConfig.parents method cannot be used to obtain the valid parent types of some configuration types

When using the AdminConfig.parents method to obtain the allowed parent types for a specific configuration type, for example, "JavaVirtualMachine", an informational message may be returned instead of the desired value.

The following informational message is returned:

.

The following function demonstrates one possible work around for the AdminConfig.parents() method that deals with the issue previously mentioned:

#---------------------------------------------------------------------
# Name: parentTypes()
# Role: To search for configuration types that may contain objects of #       the specified type should the result of calling #       AdminConfig.parents( Type )
#       be:
#       WASX7351I: The parents command cannot be used to find the parents of type ...
# Note: Unlike the AdminConfig.list() command, this routine will not #       raise an InvalidConfigDataTypeException for an unknow datatype
#---------------------------------------------------------------------
def parentTypes( Type ) :
    import os
    WSAStypes = AdminConfig.types().splitlines() 
    if Type in  WSAStypes :
        result = AdminConfig.parents( Type )
        if result.startswith( 'WASX7351I' ) :
            result = []
            for thisType in WSAStypes :
                if AdminConfig.attributes( thisType ).find( Type ) > -1 :
                    result.append( thisType )
            result = (os.linesep).join( result )
    else :
        print 'parentTypes error: unknown / unrecognized type:', Type
        result = None     return result

(dist)(zos) If none of these steps solves the problem, see if the specific problem you are having is addressed in the Installation completes but the administrative console does not start topic. Check to see if the problem has been identified and documented using the links in the Diagnose and fix problems: Resources for learning topic. If we do not see a problem that resembles yours, or if the information provided does not solve your problem, contact IBM support for further assistance.

(iseries) If none of these steps solves the problem, see if the specific problem you are having is addressed in the Installation completes but the administrative console does not start topic. Check to see if the problem is identified and documented using the links in the Diagnose and fix problems: Resources for learning topic.

For current information available from IBM Support on known problems and their resolution, see the following topics on the IBM support page:

IBM Support has documents that can save you time gathering the information needed to resolve this problem. Prior to opening a PMR, see the following topics on information gathering on the IBM support page:


Related tasks

  • Troubleshooting administration