brandLogo: alt="EnergyLogo"

Installing shortBrandName

---

The Niagara software must be a version that is compatible with the shortBrandName software release and be licensed with the features as indicated in "Licensing Information".

The installation process may be broken down into the following tasks:

• Install the eas module
• Install the updated wbApplet (NiagaraAX 3.0 only)
• Install and start EasService
• Configure EasService

In addition to these tasks, if you don’t have the Java plug-in installed, the first time you run shortBrandName you need to install the Java plug-in, as described in: "Start shortBrandName and install the Java Plug-in.".

Install the eas module

1. Using Windows Explorer, navigate to the directory that contains the eas.jar file. See figure Figure 2-4.

Figure 2-4 eas.jar and easdemo.jar files.

2. Select and copy the eas.jar file.

   Note: Copy both the eas.jar file and the easdemo.jar file if you want to have the ability to generate demo data.

3. Paste the copied jar file(s) into your NiagaraAX installation directory, under the /modules folder, as shown in Figure 2-5.

Figure 2-5 Pasting jar files into the “modules” folder.

4. Restart any running stations and instances of workbench to complete the module installation.

   Note: The module will not appear in the station directory until the station is restarted.

Install the updated wbApplet (NiagaraAX 3.0 only)

This procedure applies only to installations of shortBrandName for users of NiagaraAX 3.0. Users of NiagaraAX 3.1 do not need to perform this procedure.

1. Using Windows Explorer, navigate to the directory on your installation CD that contains the wbapplet.jar file.
2. Select and copy the wbapplet.jar file.

   Note: If you already have a wbapplet.jar file in your /lib folder, rename it before pasting the new one in the folder if you want to save it. Otherwise, simply allow the new file to overwrite the old one in the following step.

3. Paste the wbapplet.jar file into /lib directory, under the NiagaraAX installation folder, as shown in Figure 2-6.

Figure 2-6 wbapplet.jar file pasted into the “lib” folder.

4. Restart the updated station or workbench application.

Install and start EasService

You must put the eas.jar module into the modules directory, as described in "Install the eas module", before you can install and start the service in your station.

The following notes apply to installing the EasService:

• The host must be licensed for the service.
• A station should have only ONE service of a particular type. Do not add a service that already exists.
• You can verify that the EasService is installed and begin configuring it by double-clicking on the service to display the EasService property sheet
• The EasService is intended only for Web Supervisor stations. It has no use in a JACE station.
• In workbench, open the eas palette.

  The EasService module appears in the palette.

• Copy and paste the EasService module into the station Services directory, as shown in Figure 2-7.

Figure 2-7 Installing the EasService under the Station Services directory.

The EasService is installed.

Configure EasService

Before configuring the EasService, you need to have a database installed and you must have a user name and password that provides administrative privileges to the database. Refer to "Installing MSDE 2000 Release A" for information about installing a database.

1. In the station nav tree, under the Config>Services node, double-click on the EasService icon.

   The EasService property sheet displays.

2. In the EasService property sheet, expand the Database Configuration node.

   The Database Configuration properties display.

3. In the Database Type field, select the type of database you are using. Choices are:
   • Sql (use this option for SQL or for MSDE)
   • Oracle
4. In the Host Address field, select the type of connection (IP or dialup) and enter the IP address of the database host.
5. In the port field, enter the desired port number (default port is 1433 for SQL and it is 1521 for Oracle).
6. In the Database User and Password fields, type in a username and password that provides administrative privileges for access to the database.
7. In the Sql Server Create New Database field, choose true if you want to create a new database with this installation. Choose false if you want to connect to an existing database.

   Note: The Sql Server Create New Database property only works for local instances of Sql Server. If you set this property to true for a remote instance of Sql Server, it will have no effect (it will not create a new database).

8. In the Sql Server Database Name field, type in a database name, as follows:
   • If you are creating a new database, enter the desired name of your new database. If no name is entered, a database name is created that is the same as the station name.
   • If you are connecting to an existing database, type in the name of the existing database. If you don’t enter a name, the connection will look for a name that matches the station name. If no match is found, the connection fails.
9. If the station is not connected already, right-click on the Database Configuration component, in the property sheet, and select Actions > Open Database from the popup menu.

   The Database should connect (Database Connected property displays true).

   Note: If any problems are encountered while opening the database, the EasService “Fault Cause” property should display a reason for the fault. If the EasService is in fault (for example, if the database is closed) then shortBrandName will not operate properly.