Network Deployment (Distributed operating systems), v8.0 > Reference > Administrator best practices


Administration and administrative console troubleshooting


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 after 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 before the operating system can reclaim them. The number of ports that WAS 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 you make a Java Management Extension (JMX) call such as getAttribute, setAttribute, invoke, and so on in your 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]

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 your machine, and the level of usage of your 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 or wsadmin utility, verify that the supporting server process is started and that it is healthy.

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 Diagnosing and fixing problems: Resources for learning topic. If you do not see a problem that resembles yours, or if the information provided does not solve your problem, contact IBM support for further assistance.

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 that is needed to resolve this problem. Before opening a PMR, see the following topics on information gathering on the IBM support page:


Troubleshoot administration

+

Search Tips   |   Advanced Search