Re: SAGE RTU - How do I add ISaGRAF files to my RTU using the secure firmware?
ISaGRAF programs are considered part of the RTU configuration, as there are other parts of the configuration (RLL mapping) that must be set up in order for the ISaGRAF program to interface with the RTU I/O points it needs to read and/or write.
Therefore adding an existing ISaGRAF program into an RTU configuration is accomplished using the Configuration Converter utility shipped with each new version of Secure Firmware.
When the Configuration Converter utility is launched, the "Basic" tab is active by default. The most commonly performed configuration conversion items are located in this tab - selecting an existing secure configuration (Configuration Package), selecting a non-secure configuration (RTU Configuration), Primary and Secondary IP addresses, and Gateway IP address.
Less performed items, such as adding an ISaGRAF program to the configuration, are accessed by selecting the "Advanced" tab. In the Advanced tab, Templates, Firewall rules, IPSEC (VPN) configuration, startup vxWorks scripts, and RTU HTTPS certificates/Keys can also be added to the configuration.
To add an ISaGRAF program, the secure firmware package to be updated with the ISaGRAF program must first be selected on the "Basic" tab. This firmware package can be either an earlier version, or it can be the same revision as the Configuration Converter, in the following example, we are using the K5 Configuration Converter to add an ISaGRAF program to an existing K5 configuration:
Then click the Advanced Tab to reveal the ISaGRAF block, click on the Add/Replace radio button in the ISaGRAF block and click the Browse button to navigate to the folder on your computer containing the saved ISaGRAF programs that you wish to upload. If the ISaGRAF program is located within a secure firmware configuration package, extract the contents of the configuration package to a folder on your computer first to simplify the process of finding the ISaGRAF package:
Then click the Convert button to start the conversion process. When conversion is complete, the Configuration Converter utility will ask where you would like to save the resulting Configuration Package, navigate to the folder you wish to place the converted configuration into, and click the OK button. The newly converted configuration update package will now contain the ISaGRAF program, and when the configuration package is uploaded to the RTU using the Up/Download GUI page, the GUI will automatically place the ISaGRAF files into the correct location on the RTU compact flash card.
After rebooting the RTU, the ISaGRAF program will be loaded into memory and begin running.
Note: The ISaGRAF program will assume the correct I/O points have been already mapped in the RLL section of the GUI. Failure to configure the RLL section with correct I/O mapping may result in the RTU crashing, or the RLL program not appear to be operating, depending upon the severity.
Correct RLL mapping configuration is required whether the ISaGRAF program is downloaded by the ISaGRAF development system or whether uploaded using the Up/Download GUI page.