The namespace for each Plugin Dll is defined within the associated CSV file. The files are 'flat' text files and can be edited using text editors, MS Excel etc. Each file contains example sections showing the layout of the file that the particular Plugin Dll expects.
Note: The above is true for all Plugin Dll's bar the script plug in, the namespace for which is taken from the output file the script generates when it is executed.
To add new items to the Plugin Dll's namespace, append new rows to the file. Similarly items can be removed from the namespace by deleting the appropriate line from the file.
Note: The user must be careful to maintain the structure of the file when adding, removing or modifying items in the CSV file.
Changes made to the CSV file (and thus to the namespace) will only be reflected when the Sapphire Collector is told to refresh it's copy of the namespace by clicking the "Refresh..." button on the Browse for items dialog.
Example CSV file for SNMP data:
# OID,Host,Community String,Item Name,Description,Engineering Units,SNMP Ver
#
# OID - Object Identifier of the data to fetch from the device. Comes from the
# MIB for the device in question.
# Host - hostname (or IP address) of the device to read SNMP data from. Can use
# localhost to specify reading data from the PC on which the Sapphire
# Collector is running.
# Comunity String - community string that will allow access to the device for
# purposes of reading data.
# Item Name - name of the item as it will appear in the OPC browse tree for the
# data source. Use forward slashes as tree delimiters. e.g. Example/Up time
# will put the item under the 'Example' branch of the browse tree. These
# names MUST be unique - duplicated ones will be ignored.
# Description - Description of the item as seen in stManager.
# Engineering Units - Optional. Unit of measurement for data being read.
# SNMP Ver - Optional. Specify the version of SNMP supported by the device. Options
# are '1' or '2c', '2c' being the default. If this setting does not match
# the version supported by the device, then the SNMP plugin will fail
# to read data.
#
1.3.6.1.2.1.1.3.0,localhost,public,Example/UpTime,UpTime,100ths sec,2c
1.3.6.1.2.1.4.3.0,localhost,public,Example/IP Datagrams Recvd,IP Datagrams Recvd, ,2c
1.3.6.1.2.1.11.15.0,localhost,public,Example/SNMP Get Requests,SNMP Get Requests, ,2c
1.3.6.1.2.1.25.1.6.0,localhost,public,Example/Num Processes,Num Processes, ,2c
1.3.6.1.2.1.5.8.0,localhost,public,Example/ICMP Echos,ICMP Echos, ,2c
1.3.6.1.2.1.2.2.1.16.1,localhost,public,Example/Interface 1 Octets Tx,Interface 1 Octets Tx, ,2c
Note: If the default install path is chosen, the Plugin Dll CSV files will be located in the following folder - C:\Program Files\Jemmac Software Ltd\Sapphire\config\plugins