Tech Tips

Installing Brava! as an NT Service

You must have Administrator privileges on the NT Workstation to setup and configure a service. The Brava! server must be installed on the machine where you are creating the service. Brava! requires JDK 1.1.7 or higher. If 1.1.7 is being used, the executable will be jre.exe. If 1.2 is being used, the executable will be java.exe. The following is based upon an install of JRE 1.2.

1. Install the Brava! server. See the Brava! Install Guide for installation details.

2. Download/Install Invoker by accessing this FTP site: ftp://ftp.infograph.com/general/Autodesk60.exe

3. From a DOS prompt, change directories to the location to which you installed the invoker.exe, then type the following command (see below for descriptions of the variables used):

Format:

invoker install <Name> "<Label>" "<Path to JRE>\java.exe" <Startup Type>

Example:

invoker install Brava "Brava" "c:\program files\javasoft\jre\1.2\bin\java.exe" manual

<Name> The internal name that the NT Services Control Manager will use to call the service on Startup. This does not have to be the same as the Label Name.

<Label> The name of the service displayed in the Services dialog box under Control Panel. This does not have to be the same as the Service Name.

<Path to JRE> The full path to Java.exe.

<Startup Type> The service startup type:

Automatic - Service starts every time system starts

Manual (default) - Service can be started by user or dependent service

Disabled - Service cannot be started

4. Open your registry (from the Windows Start Menu, select Run..., type regedit in the Open text box, then click on OK). Navigate to the key for the service you just created (shown below).

Key:

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\<Brava Service>

<Brava Service> The label you entered for Step 2.

Example:

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Brava

Check the Data value for the Imagepath key name. Verify that it is an absolute (not UNC) path. If it is not an absolute path, right-click on ImagePath, select Modify, and change the Data value.

5. Navigate to the Parameter key for your new Brava service and enter the arguments required to run your executable (BravaServer.jar). You can close your registry editor when you are finished.

Key:

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\<Brava Service>\Parameters.

Right-click on the AppParameters key name and select Modify. In the Value text box, enter the arguments required to run the Brava jar file (BravaServer.jar).

Format:

-classpath "<JRE Path>\lib\<Runtime Lib>;<Brava Path>\BravaServer.jar" com.infograph.jmyriad.server.MYRIADServer

Example:

-classpath "c:\Program Files\Javasoft\Jre\1.2\lib\rt.jar;c:\Program Files\IGC\Brava! Server\BravaServer.jar" com.infograph.jmyriad.server.MYRIADServer

<JRE Path> The path to your JRE installation.

<Runtime Lib> The runtime library used by your JDK (e.g., dt.jar, rt.jar, or classes.zip)

<Brava Path> The path to your Brava! executable (BravaServer.jar).

***IMPORTANT NOTE FOR WINDOWS 2000 USERS***

The argument for AppParameters key needs to be modified to Win2000 platforms.

There needs to be a semicolon added after the path defining the location of the

BravaServer.jar file. See following example.

Example:

-classpath "c:\Program Files\Javasoft\Jre\1.2\lib\rt.jar;c:\Program Files\IGC\Brava!Server\BravaServer.jar;" com.infograph.jmyriad.server.MYRIADServer

6. Right-click on the AppDirectory key name and select Modify. In the Value text box, enter the arguments required to run the Brava jar file (BravaServer.jar).

Example :

C:\Program Files\Brava! Server

7. Open the Services dialog box in the Windows' Control Panel (from the Windows' Start menu, go to Settings and select Control Panel. In the Control Panel, double-click on Services). Click once on the newly created service to highlight it (do not start it), then click on the Startup... button.

In the Log On As section, choose the account you wish to log on under and enter the appropriate password, then click on OK. If you chose an Automatic Startup Type, you will need to stop it to enable the Log On As section, then restart it when you are finished.

Note: If you choose System Account, you may not be able to access some file systems.

8. In the Services dialog box, click on the Start button to start your new Brava service. And click on Close to close the dialog box.

Removing the Brava Service

From a DOS prompt, change directories to the location to which you installed the invoker.exe, then type the following:

Format:

invoker remove <Service Name>

Example:

invoker remove Brava