IBM Support

Troubleshoot: wsadmin General Errors

Troubleshooting


Problem

This is a problem determination document to assist in the analysis of problems with the wsadmin utility in IBM® WebSphere® Application Server. This should help address common issues with this component before calling IBM support and save you time.

Resolving The Problem

Tab navigation

Troubleshooting topics:

Tab navigation

Overview

This topic contains error messages and common issues that do not require a wsadmin trace to determine the root cause of the problem. Additional troubleshooting steps that require wsadmin and server traces can be found on the Trace analysis tab.

How do I enable runtime trace for server processing using scripting?



    ts = AdminControl.completeObjectName('type=TraceService,process=dmgr,*')

    AdminControl.setAttributes(ts, '[[traceSpecification *=info:com.ibm.ws.management.*=all:com.ibm.websphere.management.*=all] [traceRuntimeConfig ] ]')

How do I enable config trace for a server using scripting?

    server = AdminConfig.getid("/Cell:mycell/Node:mynode/Server:myserver/" )

    ts = AdminConfig.list("TraceService", server )

    AdminConfig.modify(ts, [["startupTraceSpecification", "*=info:com.ibm.ws.management.*=all:com.ibm.websphere.management.*=all"]] )

    AdminConfig.modify(ts, [["enable", "true"]] )

    trclog = AdminConfig.list("TraceLog", ts )

    AdminConfig.modify(trclog, [["maxNumberOfBackupFiles", 20], ["rolloverSize", 200]] )

    AdminConfig.save( )

WASX7023E: Error creating "SOAP" connection to host "<name>"

    When you get this error when running a wsadmin script, there are several possible issues that you should check for:
    • The server to which wsadmin is attempting to connect is not running.
    • The port and hostname that wsadmin is attempting to use is incorrect.
    • If wsadmin is not supposed to connect to a running server, then it needs to start with option:
    • -conntype NONE
WASX7022E: Problem running command "import sys" -- exception

    You may see an error like this when you attempt to run a Jython script:

    WASX7022E: Problem running command "import sys" -- exception
    information: com.ibm.bsf.BSFException: unable to load language: jython;
    org.python.core.PyObject
    WASX7017E: Exception received while running file
    "[install_root]/bin/securityProcs.py"
    If you get an error like the one shown, make sure following file exists:
    [install_root]/optionalLibraries/jython/jython.jar
org.apache.soap.SOAPException: [SOAPException: faultCode=SOAP-ENV:Client; msg=Read timed out; targetException=java.net.SocketTimeoutException: Read timed out]

    If your wsadmin script fails with this error, try increasing the SOAP request timeout by changing the value for the com.ibm.SOAP.requestTimeout custom property in [install_root]/profiles/profile_name/properties/soap.client.props. The default value for com.ibm.SOAP.requestTimeout is 180 seconds.

ImportError: no module named AdminUtilities

    If you get this error when trying to use command from scriptLibraries, do the following:
    1. Check files under [install_root]/scriptLibraries and compare them with the working environment.
    2. Copy the Python files from the working environment if they are missing.

wsadmin hangs

    Problem: Your wsadmin script hangs and hung thread shows the following stack:

    at java.net.SocketInputStream.socketRead0(Native Method)
    at java.net.SocketInputStream.read(SocketInputStream.java:155)
    at com.ibm.jsse2.a.a(a.java:19)
    ...
    at com.ibm.ws.management.connector.soap.SOAPConnectorClient.queryNames (SOAPConnectorClient.java:511)
    Recommendation:
    In a large cell environment, if a wsadmin script calls AdminControl.queryNames() with a too broad scope, it will cause delays because the queryNames() call will be sent out to all the JVMs. This can take a long time and cause issues.

    For instance, instead of following command:
    nodeSyncObjects = AdminControl.queryNames("type=NodeSync,*")

    Use following query string, so that queryNames call will only be sent to nodeagent processes which saves time:
    nodeSyncObjects = AdminControl.queryNames("type=NodeSync,process=nodeagent")

[{"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Administrative Scripting Tools (for example: wsadmin or ANT)","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"9.0;8.5.5;8.5;8.0;7.0","Edition":"Network Deployment","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
15 June 2018

UID

swg21992238