Installing GTD Excel Report Server as Windows NT Service

On Windows, the recommended way to run GTD Excel Report Server is to install it as a Windows service, whereby GTD Excel Report Server starts and stops automatically when Windows starts and stops. A GTD Excel Report Server installed as a service can also be controlled from the command line using NET commands, or with the graphical Services utility. Generally, to install GTD Excel Report Server as a Windows service you should be logged in using an account that has administrator rights.

The Services utility (the Windows Service Control Manager) can be found in the Windows Control Panel (under Administrative Tools on Windows 2000, XP, Vista, and Server 2003). To avoid conflicts, it is advisable to close the Services utility while performing server installation or removal operations from the command line.

Supported Platforms


win32 - Windows NT, 2000, XP, 2003, and vista.

Also known to run on Windows 98 and ME, however due the lack of support for services in the OS, the Wrapper can only be run in console mode.

Installing GTD Excel Report Server as Windows NT Service


Testing is best done from a command prompt in a console window (or “DOS window”). In this way you can have the server display status messages in the window where they are easy to see. If something is wrong with your configuration, these messages make it easier for you to identify and fix any problems.

Provided you are able to run GTD server in console mode, if not, please try to run the server in console mode first.

[Learn More: Testing GTD server in console mode]

1. Logon windows server as Administrator.
2. Run the following command


3. Check the log file created by Installer.


Open the file above with Notepad, the content looks like:

STATUS | wrapper | 2008/04/14 09:56:47 | GTD Excel Report Server installed.

See Advanced section if you want to change the location of the log file.

3. Open Services

Click START, RUN, type services.msc, click OK.

Congratulations! The GTD Server has been installed as service.


Q: The service is installed, but the service can not be started.
I check the log file, see the message:
WrapperStartStopApp: Unable to locate the class com.gtdreport.excelreport.wrap.StartStop: java.lang.UnsupportedClassVersionError: com/gtdreport/excelreport/wrap/StartStop (Unsupported major.minor version 49.0)

A:The message means you are using JRE 1.4.2. However our product requires JRE 1.5.
Please edit the file ${GTD_HOME}\win-service\conf\wrapper.conf
Specify the path of java.exe. For example:\gtdserver\jre\bin\java

or if you are using the “J-Rep2excel With JRE”, you can set\..\jre\bin\java



1. Logon windows server as Administrator.
2. Run the following command line





Please change wrapper.conf to meet your requirements.


For example, you can change the location of the log file.

# Log file to use for wrapper output logging.