6.9 Updating config.MAC_address and Hardware Configuration Files

If the configuration information changes for a scPosImage or scCashRegister object, you can run posAdmin with the --updateconfig option. This command notifies Branch Servers to update the hardware configuration and config.MAC_address files for specified terminals in their subnet.

When this command is executed, the Administration Server uses the RSYNC service to send an update notification file (/opt/SLES/POS/rsync/update/update) to all Branch Servers that service terminals designated in the --dnList. It also sets the scConfigUpdate attribute to TRUE for every scWorkstation object designated (either directly or indirectly) in the --dnList. When posleases2ldap encounters the update notification file on the Branch Server, it connects to the LDAP directory, checks the scConfigUpdate attribute in the scWorkstation objects, and refreshes the terminals’ hardware configuration and config.MAC_address files.

IMPORTANT:For the --updateconfig option to work, the Branch Server object in LDAP (scBranchServer) must have an scNetworkCard object with an IP address (ipHostNumber attribute) that is visible to the Administration Server. Multiple scNetworkCard objects can exist under an scBranchServer object

Table 6-18 summarizes the posAdmin options for updating configuration information.

Table 6-18 Command options for updating configuration files

Option

Type

Description

--base

must

The base option sets the base in which to search for objects. On the Administration Server, the default base is the organization (o=mycorp,c=us).

--dnList

must

A list of distinguished names that indicates which terminals should receive updated config.MAC_address files. Valid object types are scPosImage, scCashRegister, scConfigFileTemplate, scConfigFileSyncTemplate and scWorkstation.

This list is delimited by colons ( : ). For example: --dnList cn=crtype3,cn=global,o=mycorp,c=us:cn=CR001, cn=branch,ou=boston,o=mycorp,c=us

The following examples illustrate how the --updateconfig command can be used.

Example 1

Update all configuration files on clients that use the scCashRegister object cn=crtype3,cn=global, o=mycorp,c=us:

posAdmin.pl --user cn=admin,o=mycorp,c=us --password secret 
--base ou=boston,o=mycorp,c=us --updateconfig 
--dnList cn=crtype3,cn=global,o=mycorp,c=us

Example 2

Update all configuration files on clients that use the image object cn=browser,cn=global, o=mycorp,c=us and the client cn=CR001,cn=branch,ou=boston,o=mycorp,c=us:

posAdmin.pl --user cn=admin,o=mycorp,c=us --password secret 
--base ou=boston,o=mycorp,c=us --updateconfig  
--dnList cn=browser,cn=global,o=mycorp,c=us:
  cn=CR001,cn=branch,ou=boston,o=mycorp,c=us