NMC-RX 7.2.x User Guide, Vol. 1 > Configuring NMC-RX Application Settings > Configuring Config Sync Services

Configuring Config Sync Services

Config Sync Services provide device discovery services, software download services, and task scheduling services. For a Config Sync Service to discover a device on your network, you must create the device in the NMC-RX application using the network IP address of the device. When you create a new device using the NMC-RX application, the Config Sync Service goes out to the device and obtains information about it.

The NMC-RX application uses a distributed processing model to provide greater scalability and control of discovery and update processes for E-series devices (see Figure 13).

Figure 13: Sample Config Sync Services Distribution

A Config Sync Services pool allows multiple Config Sync Services to be active simultaneously, thus providing a wealth of processing power that is available to multiple Config Sync Services locations. During installation, a system administrator can choose to install one or more Config Sync Services on a workstation without having to install the other NMC-RX components.

You can run multiple Config Sync Services on a single platform or utilize multiple platforms as part of the same NMC-RX Config Sync Services pool. You can oversee and manage the distributed Config Sync Services pool using the NMC-RX client application.

NOTE: An FTP user must be set up and running correctly for the NMC-RX application to use the Config Sync Services.

 NOTE: Only users with a security privilege can configure Config Sync Services. For more information, see Chapter 9, Configuring Security Settings.



 

To configure Config Sync Services:

1. From the Configuration menu in either the Network Workshop or the Device Workshop, choose NMC-RX Application Settings, and then click Config Sync Services.

The Config Sync Services tab appears.

When you select a service in the Config Sync Services table, the values for the Config Sync Service parameters are automatically populated. The parameters are disabled for a Config Sync Service whose status is Not Installed.

The RMI Registry Port, Scheduler MAX Operations, and FTP Destinations values are applied to all Config Sync Services on the location of the currently selected service. If you modify any of these values, a warning dialog box appears asking if you want to continue. The SNMP Settings User Profile is applied to all Config Sync Services, regardless of their location. If you set SNMP settings as a Config Sync Services user, the settings are used by all Config Sync Services when communicating by means of SNMP.

2. Set the Config Sync Services parameters (Table 8).
   

   NOTE: You can edit the RMI Registry Port value of the selected Config Sync Service when the status is Not Run Yet or Not Responding for all Config Sync Services on the location of the selected service. The new setting takes effect when the Config Sync Services on that location are started. When you set the FTP Destinations parameter to Same for Discovery & Staging, only one set of FTP Destination parameters appears for both discovery and staging. When you set the parameter to Separate Destinations, two different sets of FTP Destinations parameters appear. When you change the FTP Destinations parameter from Separate Destinations to Same for Discovery & Staging, a dialog box appears prompting you for the settings to use. Click either Discovery or Staging.

   
   

 Table 8:  Config Sync Services Parameters 

 Parameter
 Default
 Range/Options
 Description

 SNMP Settings User Profile

 admin

 User profile name

 User profile that the Config Sync Service uses when communicating by means of SNMP.


 Config Sync Service

 RMI Registry Port

 Set during installation

 0-65535

 Port with which the Config Sync Service registers. The standard default for the port is 1099; if 1099 is in use, you can change the port number.


 Scheduler Max Operations

 Set during installation

 0-2147483647

 Total number of operations that can be active in the Config Sync Service at one time; zero indicates no limit.


 FTP Destinations

 Set during installation

 Separate Destinations, Same for Discovery and Staging

 Indicator that determines whether Discovery and Staging uses the same set of values for the FTP destination or whether separate sets of values are used.


 FTP Discovery Destination and FTP Staging Destination: FTP Settings

 Login

 Set during installation

 32-character alphanumeric string

 Login name for FTP; if you change the Login, the change does not take effect until the next startup.


 Password

 Set during installation

 1024-character alphanumeric string

 Password for FTP; if you change the Password, the change does not take effect until the next startup.


 Re-enter Password

 Set during installation

 1024-character alphanumeric string

 Validation of Password.


 IP Address

 Set during installation

 Valid IP address

 IP address of the FTP destination.


 Sub Directory

 Set during installation

 255 characters maximum

 Subdirectory within the FTP area that is used for Discovery and/or Staging; the subdirectory is case sensitive.


 FTP Timeout (sec)

 Set during installation

 1-2147483 seconds

 Amount of time, in seconds, when an FTP request is made and is considered unresponsive.


 Local Root Directory

 Set during installation

 255 characters maximum

 Directory on the Config Sync server machine that is the FTP root; when you send an FTP request to the target machine, this is the directory you reach; the local root directory is case sensitive.
 NOTE: The local root directory needs write permission and anonymous access.


 Local Sub Directory

 Set during installation

 255 characters maximum

 Subdirectory in the local root directory that is used for Discovery and/or Staging; the local subdirectory is case sensitive.



 

 NOTE: If FTP is configured properly, the following URL brings up an FTP connection when placed in a Web browser address line: 
ftp://your IP address:21




 

3. When you are done, click Save.

Getting Status Information

You can view the status for every Config Sync Service that is running from the Status field in the Config Sync Services tab. Each Config Sync Service is assigned a Service ID during installation.

Table 9 lists the status indicators and their meanings.

Table 9: Config Sync Services Status Indicators

Status	Meaning
Available	Config Sync Service is running and is not performing an operation.
Busy	Config Sync Service is running and is performing an operation.
Not Responding	Config Sync Service was running previously but is not running currently.
Not Run Yet	Config Sync Service is installed but was never running.
Not Installed	Config Sync Service is not installed.

Locating the Config Sync Services Log

All Config Sync Services maintain a log, which details discovery activities. Consult this log file for more information when you are diagnosing an error condition.

The log file (CfgSyncSvc<serviceID>/CfgSyncSvc<serviceID>.log) is located in the log directory of the NMC-RX home directory of the system on which the Config Sync Service is installed. For example:

<NMC-RX installation directory>/log/CfgSyncSvc<serviceID>/CfgSyncSvc<serviceID>.log

Uninstalling Config Sync Services

You can uninstall individual Config Sync Services. When you uninstall a Config Sync Service, you remove all files associated with that service from your machine, as well as its entry in the NMC-RX database.

Before you uninstall, be sure that the NMC-RX database is running and the Config Sync Service that you want to uninstall is not running.

Uninstalling in Windows

To uninstall a Config Sync Service in Windows:

1. Choose Start > Settings > Control Panel.
2. Double-click Add or Remove Programs.

The Add or Remove Programs dialog box appears.

3. Select the Config Sync Service that you want to uninstall (for example, Juniper Networks CfgSyncSvc6), and then click Remove.
4. Click Uninstall, then Done.

In the Config Sync Service tab, the status for the Service ID of the Config Sync Service that you uninstalled is Not Installed, and the Config Sync Service and its entry are removed from the NMC-RX database.

Uninstalling in Solaris

To uninstall an individual Config Sync Service from <NMC-RX installation directory>/UninstallerData/CfgSyncSvc<serviceID>, run:

./CfgSyncSvcUninstaller

To remove an entire NMC-RX installation from this workstation, run:

./NMC-RX_Uninstaller

Removing Config Sync Services from the NMC-RX Database

When the status of a selected Config Sync Service is either Not Responding or Not Run Yet, the Remove button in the Config Sync Services tab is enabled. When you remove a Config Sync Service, you clear it from the NMC-RX database.

NOTE: Perform this action only if you uninstalled the Config Sync Service and the uninstaller had a problem clearing the service from the database. For more information about uninstalling a Config Sync Service, see Uninstalling Config Sync Services.

To remove a Config Sync Service:

1. From the Configuration menu in either the Network Workshop or the Device Workshop, choose NMC-RX Application Settings, and then click the Config Sync Services tab.
2. Select the Config Sync Service that you want to remove, then click Remove.

A warning dialog box appears indicating that if you remove the service, you cannot use it until it is reinstalled.

3. Click Yes to remove the Config Sync Service.

The IP address of the workstation on which the Config Sync Service was installed is removed from the Config Sync Services table, but the service ID remains. You cannot use this service ID until you reinstall the Config Sync Service.