Configuring the management server as a Windows service

If you deploy the management server to WebSphere® Application Server Community Edition on Microsoft Windows, you can configure the management server as a Windows service. You can set the management server service to restart automatically whenever the computer is restarted.

Before you begin, install and deploy the management server to WebSphere Application Server Community Edition.

The computer must have Microsoft .NET Framework 2.0 or higher installed.

To configure the management server as a Windows service:
  1. If WebSphere Application Server Community Edition is not installed to the default location at C:\Program Files\IBM Optim\shared\WebSphere\AppServerCommunityEdition, complete the following steps:
    1. Open the folder in which you installed WebSphere Application Server Community Edition.
    2. Open the bin folder, and then open the mgmtServerService.xml file in that folder by using a text editor such as Notepad.
    3. Change the value of the wasceLocation entity to the folder in which you installed WebSphere Application Server Community Edition, and save the changed mgmtServerService.xml file.
    4. Open the optimService.bat file in that folder by using a text editor such as Notepad.
    5. Change the WASCE_BIN value to server_location\bin, where server_location is the folder in which you installed WebSphere Application Server Community Edition, and save the changed optimService.bat file.
    For example, you install WebSphere Application Server Community Edition to D:\Applications\IBM Optim\WASCE. In this case, use Notepad to open D:\Applications\IBM Optim\WASCE\mgmtServerService.xml and change the wasceLocation value to D:\Applications\IBM Optim\WASCE. Next, open D:\Applications\IBM Optim\WASCE\optimService.bat and change the WASCE_BIN value to D:\Applications\IBM Optim\WASCE\bin. On computers that run a 64-bit version of Windows, WebSphere Application Server Community Edition is installed to C:\Program Files (x86)\IBM Optim\shared\WebSphere\AppServerCommunityEdition by default. You must therefore always edit the mgmtServerService.xml file on computers that run a 64-bit version of Windows.
  2. If you configure WebSphere Application Server Community Edition to use a non-default user name, password, and port number, configure the service to use these values. By default, WebSphere Application Server Community Edition is configured to use system as the user name, manager as the password, and 1099 as the port number. Complete the following steps:
    1. Open the folder in which you installed WebSphere Application Server Community Edition.
    2. Open the bin folder, and then open the optimService.bat file in that folder by using a text editor such as Notepad.
    3. Change the USER, PASSWORD, and PORT values to the values that you configured for WebSphere Application Server Community Edition.
  3. Open the command prompt by clicking Start > Run and entering the command cmd.
  4. Enter the following commands at the command prompt, where server_location is the location in which WebSphere Application Server Community Edition is installed:
    cd server_location
    mgmtServerService.exe install
    mgmtServerService.exe start
You can check on the progress of the management server by looking at the contents of log files. There are 3 log files:
  • server_location/log/mgmtServerService.err.log
  • server_location/log/mgmtServerService.out.log
  • server_location/log/mgmtServerService.wrapper.log
To stop and uninstall the management server service, enter the following commands at the command prompt.
cd server_location
mgmtServerService.exe stop
mgmtServerService.exe uninstall