StoreGazer Configuration Help

Note: Users with multiple StoreGazer servers should examine the advanced configuration file sample below.

Address
The IP address or host name of the StoreGazer Server that EDJAgent will communicate with. In order for a host name to be used and accepted, it must be defined in the 4690 hosts file.

Alert Minutes (Default Value: 30)
The default interval (in minutes) between sending multiple copies of the same alert. This value can be overridden in the alert file, using the 'Interval' option.

Audit (Default Value: false)
If this option is set to 'true', EDJAgent will log all controller-initiated actions to file (EDJGazer:SGAudit.dat). By default, all auditing information will be sent to the StoreGazer Server and made available within the application database. This option may come in useful if you experience transmission problems between the controller and another machine.

BackupAddress
The IP address or host name of the backup StoreGazer Server (if available) that EDJAgent will communicate with. If EDJAgent is unable to communicate with the primary server (see Address), it will attempt to communicate with the server located at the backup address.

BackupPort
The port of the backup StoreGazer Server (if available) that EDJAgent will communicate with.

Buffer (Default Value: (Disabled))
If this option is provided, EDJAgent will write all 4690 messages to file (EDJGazer:PipeMsgs.dat). This parameter takes a numeric value that indicates the number of messages to buffer before writing to file. For example, when set to 1, all 4690 messages will be written to the file immediately (inefficient, but accurate). Likewise, if Buffer is set to 10, the EDJAgent process will collect 10 messages before writing to the file (efficient, but possibly inaccurate).

CorpID (Default Value: (DFLT))
The corporate identifier used to represent the company that owns this controller. This field may be used if a single StoreGazer database is used to house multiple companies.

Debug (Default Value: Off)
This option determines what type of program state information is written to the debug file (EDJGazer:EDJAgent.log). The following values are recognized:

• Off - Do not write any debug information to file.
• Min - Write minimum debug information to file. This includes brief program status details. EDJAgent performance should not be impacted by this setting.
• Max - Write maximum debug information to file. This option should only be used when an easily reproducable problem is detected. Unless requested by EDJ, you should not enable the 'Max' debug option. EDJAgent performance will be impacted by this setting.

DefineNode
This command can be used multiple times to map node IDs to IP addresses. Alternatively, the node may map to a hostname that is defined in the hosts file. This should be done when the store already has a hostname defined for each controller. There are two symbols you can place in the hostname definition to designate store and node-specific variables:

• %s = Store Number (Default length - 4)
• %n = Store Node ID (Default length - 2)

The default lengths for each wildcard symbol are displayed above. However, if the percent sign is immediately followed by a number (which will precede the wildcard symbol), that length can be changed. For instance, '%3s' will only display the right-most three digits of the store number.

For the example above,

Assuming we are in store '0001', the CC controller will be mapped to hostname 'st0001CC'. The DD controller will be mapped to hostname 'st0001DD'.

DefinePort
This command can be used multiple times to configure the EDJServr listening port for each node ID. During a typical StoreGazer installation, each controller will be configured to listen on port 1236. However, in some cases, your router/firewall configuration may require each controller to use a unique port. When using a port other than 1236, the DefinePort command should be used. This will allow EDJAgent to properly register with the StoreGazer Server and communicate with other controllers. Example:

EnableLargeDiskSupport (Default Value: true)
If this option is set to 'true', EDJAgent will report the correct size of disks larger than 4GB. Note that there is an issue reporting the available free space. This issue should be fixed in future 4690 OS updates.

EnableProcessUptime (Default Value: true)
If this option is set to 'true', EDJAgent will track and report process uptime information. The StoreGazer Client Controller Monitor can display all currently running processes. When this option is enabled, the 'Uptime' column will display the time since the program was started.

EnableUserActivity (Default Value: false)
If this option is set to 'true', EDJAgent will send user activity (controller login/logout) details to the StoreGazer Server.
Note: The StoreGazer COPS optional feature must be installed to collect user activity.

Encrypt (Default Value: Dynamic)
The type of encryption to use when communicating with a StoreGazer Client or Server. StoreGazer uses the Blowfish encryption algorithm. The following values are recognized:

• None - Do not use encryption.
• Dynamic - Use a initialization vector (IV) built from the local/remote ports.
• Constant - Use a constant/fixed initialization vector (IV).

FTPHours (Default Value: 1)
The number of hours that the Agent will retain FTP requests when unable to communicate with the FTP server.

Heartbeat (Default Value: 60)
The EDJAgent process frequently requests a heartbeat of the 4690 controller. This includes capturing real-time CPU, Memory, and Disk utilization. The 'Heartbeat' option allows the user to configure the number of seconds to wait between each heartbeat.

LogCount (Default Value: 10)
The number of heartbeats that are taken before EDJAgent logs controller statistics to file. EDJAgent updates this file so that vital details are retained between separate instances of the application (program restart, controller IPL, etc).

MSGHours (Default Value: 1)
The number of hours that the Agent will retain messages when unable to communicate with the StoreGazer Server.

Name
The local name assigned to a StoreGazer Server. This value should be unique within the configuration file. The name field is used internally by EDJAgent.

PipeDebug (Default Value: false)
This option determines what type of program state information is written to the debug pipe. The EDJAgent process can write to the debug pipe much faster than writing to the debug file. However, this is a typical time/space tradeoff, as there is limited space available on the debug pipe. EDJAgent will overwrite old data when the pipe is full.

• Off - Do not write any debug information to pipe.
• Min - Write minimum debug information to pipe. This includes brief program status details. EDJAgent performance should not be impacted by this setting.
• Max - Write maximum debug information to pipe. This option should only be used when an easily reproducable problem is detected. Unless requested by EDJ, you should not enable the 'Max' debug option. EDJAgent performance may be impacted by this setting.

Port
The port of the StoreGazer Server that EDJAgent will communicate with. In a typical StoreGazer environment, the port should be set to 1235.

PreferredFTPUser (Default Value: None)
The preferred FTP user for the StoreGazer Client to use when initiating file transfers to/from the 4690. The '*' and '?' wildcards are accepted (i.e. "ftp*" will match "ftpuser"). If this user is not provided (or defined), StoreGazer will use the most-privileged user.

ResolveIPsByFile (Default Value: false)
If this option is set to 'true', EDJAgent will parse the 4690 IP configuration files when performing controller-to-controller actions. This option is primarily used for 4690 configurations with dynamic IP addressing via a BOOTP server. If using static IP addresses, we recommend using the 4690 hosts file and/or the DefineNode command.

SendAlert (Default Value: true)
If this option is set to 'true', alerts are enabled and a message will be sent to the StoreGazer server whenever an alert is raised.

SendChain (Default Value: true)
If this option is set to 'true', a daily status report will be sent to the StoreGazer Server at the end of each day.

SendCheckin (Default Value: true)
If this option is set to 'true', a checkin message will be sent to the StoreGazer Server every 15 minutes.

SendEmail (Default Value: true)
If this option is set to 'true', email actions are enabled and a message will be sent to the StoreGazer server whenever an email is performed.

SendFTP (Default Value: true)
If this option is set to 'true', FTP user/password information will be sent to the StoreGazer Server upon startup.

SendLog (Default Value: true)
If this option is set to 'true', log actions are enabled and a message will be sent to the StoreGazer server whenever a log is performed.

SendMonitoredFiles (Default Value: true)
If this option is set to 'true', the Agent will retrieve a list of files to monitor from the StoreGazer Server each day. The size/timestamp/checksum of the file(s) will then be sent to the StoreGazer Server.

SendSNMP (Default Value: true)
If this option is set to 'true', SNMP actions are enabled and a message will be sent to the StoreGazer server whenever an SNMP action is performed.

SendUser (Default Value: true)
If this option is set to 'true' and user activity logging is enabled, user activity details will be sent to the StoreGazer server.

SendVPD (Default Value: true)
If this option is set to 'true', a daily VPD (vital product data) report will be sent to the StoreGazer Server at the end of each day.