How to install an I/A Series R2 JAR File

[Product_Support]

Issue

I cannot find any published instructions giving the procedure to install an updated version of one of the JAR files on my I/A Series (Niagara) system.

Product Line

TAC IA Series

Environment

I/A Series (Niagara) R2 software (any version) installed on a Windows computer

Cause

An updated version of one of the JAR files installed in an I/A Series (Niagara) R2 system has been published.  The updated file has been downloaded to my computer but there are no instructions on how to install it.

Resolution

For the purpose of this explanation of the procedure, the following steps reference an update to the "programlib" jar file for release 2.301.522.   Substitute the name of the jar file being updated and release number in the following steps.

* NOTE: Before attempting to update a jar file, verify that Windows Explorer is configured to display file type extensions. (See * below for more information).

The JAR file update is published, currently on the  as a .zip file containing two files. 

1. Copy the file programLib-2.301.522c.v1.jar.emb to the \niagara\r2.301.522\emb folder.
2. Rename the existing file  from programLib-2.301.522.v1.jar to programLib-2.301.522.v1.jar.old.
3. Rename new file from programLib-2.301.522c.v1.jar.emb to programLib-2.301.522c.v1.jar (removing the .emb extension).
4. Copy the file programLib-2.301.522.v1.jar.nt to the \niagara\r2.301.522\nt folder.
5. Rename the existing file  from programLib-2.301.522.v1.jar to programLib-2.301.522.v1.jar.old.
6. Rename new file from programLib-2.301.522c.v1.jar.nt to programLib-2.301.522c.v1.jar (removing the .nt extension).
7. Copy the file programLib-2.301.522.v1.jar.nt  to the \niagara\r2.301.522\nre\modules folder
8. Rename the existing file  from programLib-2.301.522.v1.jar to programLib-2.301.522.v1.jar.old.
9. Rename new file from programLib-2.301.522c.v1.jar.emb to programLib-2.301.522c.v1.jar (removing the .nt extension).

To install the new jar file into a UNC, perform the following procedure after completing steps 1 through 9, above.

10. Start the Niagara 522 version of the Admin Tool.
11. Open a connection to the UNC
12. Select the "Installation" tab then click the [Installation Wizard] button.
13. Select the "emb" folder in the "Select Distribution Directory" window then click [Install]
14. In the "Niagara Remote Installation" window, select the "Configure Modules Only" radio button then click the [Next >] button.
15. Verify that there is a checkmark in the "Upgrade/Add" column for the updated jar file.
16. Click the [Next >] button to continue. Make sure that on the "Database Backup" screen that you do backup the existing database.
17. Continue through the remaining steps and allow the upgrade to install and the station to restart.

---

* To properly rename the files as described in this procedure, Windows Explorer must be configured to show file type extensions.  To configure this setting or verify it, proceed as follows:

1. Open Windows Explorer by clicking on the My Computer (or Computer) icon on the computer's desktop or by making the selection from the Windows start menu.
2. From the Windows Explorer "Tools" menu, select "Folder Options"
3. Select the "View" tab.
4. Scroll down through the "Advanced Settings" list to locate the entry "Hide extensions for know file types".  Verify that this entry is unchecked.
5. Click the [OK] button to save the change, if any, and exit the Folder Options screen.