Administration and admin console troubleshooting


 

+

Search Tips   |   Advanced Search

 

In WAS products, admin functions are supported by:

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

What kind of problem are you seeing?

  1. Server status and messages in the console view are not current
  2. Role-based authorization fails
  3. When starting or stopping a server using a wsadmin interactive scripting session, you receive an exception indicating read timed out
  4. Problems starting or using the admin console or wsadmin utility

 

Server status and messages in the console view are not current

When connecting to an appserver 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 appserver has many ongoing operations that use the SOAP connector, the appserver 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 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...

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 appserver name.                                     
          String serverName = (String)adminservice.getAttribute(objectname, "name");     
        
          
// Get the appserver 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 
     
// admin 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...

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 property...

...in...

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 property...

...is 180 seconds.

 

Problems starting or using the admin console or wsadmin utility

If we have problems starting or using the admin console 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 we are having is addressed in the Installation completes but the admin 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: Links topic. If we do not see a problem that resembles yours, or if the information provided does not solve the 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:




 

Related tasks

Troubleshooting administration