IBM Support

Using wasservicehelper utility to create Windows services for WebSphere Application Servers

Troubleshooting


Problem

The wasservicehelper utility is a friendly interface for the WASService utility. Both utilities are provided with the WebSphere Application Server. The WASService utility is used for adding, updating, and removing WebSphere Services in Windows.
The wasservicehelperutility is provided in WebSphere Application Server v8 and higher and resides in the WAS_HOME\bin directory.

Symptom

Creating and removing a Windows WebSphere service is confusing and error prone.

Cause

The WASService utility requires several parameters that can be confusing to the user and often involve several long path strings that increase the probability of configuration errors.

Environment

Windows

Resolving The Problem

Launch the utility: wasservicehelper
The wasservicehelper utility prompts you to select specific options and settings from a list and then invokes the WASService.exe command with all the necessary parameters. The time required to create a Windows service for WebSphere Application Server and the opportunity for user errors are reduced.

Video - The wasservicehelper utility was previously named WASServiceCmd. The Video shows the wasservicehelper version of the utility. Only the utility name changed.

The utility shows the WASService command syntax that is used. The information is also stored in the log file, WASServiceCmd.rep in the current directory.

Example of a log entry:
[Fri Aug 14 12:22:01 -0500 2009]  WASService.exe -add "Deployment Mgr01" -serverName "dmgr"
-profilePath "C:\Program Files\IBM\WebSphere\AppServer\profiles\Dmgr01"  
-logRoot "C:\Program Files\IBM\WebSphere\AppServer\profiles\Dmgr01\logs\dmgr"
 -logFile "C:\Program Files\IBM\WebSphere\AppServer\profiles\Dmgr01\logs\dmgr\WS_startdmgr.log" -encodeParams -stopArgs "-username vanno -password ****** "
-startType manual
-restart false
As-is download. Provided for use when the wasservicehelper utility is not available.
WASServicecmd.zip
Place the WASServiceCmd.exe utility in the WAS_HOME\bin directory. This version of the utility creates a log file of WASServiceCmd.log instead of WASServiceCmd.rep log.
Notice: If the browser downloads the file as docview.wss, rename the file with a ".zip" extension (for example, docview.zip or WASServiceCmd.zip).

[{"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"System Management\/Repository","Platform":[{"code":"PF033","label":"Windows"}],"Version":"9.0;8.5;8.0;7.0","Edition":"Base;Developer","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
21 June 2023

UID

swg21397335