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]
${GTD_HOME}\win-service\bin\InstallApp-NT.bat
3. Check the log file created by Installer.
${GTD_HOME}\win-service\logs\wrapper.log
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.
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:
wrapper.java.command=C:\gtdserver\jre\bin\java
or if you are using the “J-Rep2excel With JRE”, you can set
wrapper.java.command=..\..\jre\bin\java
| Uninstallation |
${GTD_HOME}\win-service\bin\UninstallApp-NT.bat
| Advanced |
Please change wrapper.conf to meet your requirements.
${GTD_HOME}\win-service\conf\wrapper.conf
For example, you can change the location of the log file.
# Log file to use for wrapper output logging.
wrapper.logfile=../logs/wrapper.log