How do I configure auto-assigned service ID ranges and uniqueness checking?

Purpose
CAUTION 

CAUTION

Service Disruption

Modifying the NFM-P system configuration can have serious consequences that include service disruption.

Contact technical support before you attempt to modify the server configuration.

CAUTION 

CAUTION

Misconfiguration risk

You must configure each main server in the NFM-P system using the same values, as described in the procedure; otherwise, a potentially service-affecting configuration mismatch exists.

If you perform the procedure, ensure that you perform the procedure on each main server station.

By default, the NFM-P performs uniqueness checking to verify that a service ID that is to be auto-assigned is not currently associated with a service in the NFM-P managed network. Service creation using auto-assigned service IDs can take considerable time, and consume system resources unnecessarily, if the NFM-P manages a large number of services.

To avoid such a scenario, you can configure a range of service IDs for auto-assignment, and disable the uniqueness checking for the specified range.

Perform this procedure to :

  • configure the system-wide default minimum and maximum values for auto-assigned service IDs

  • disable or enable the uniqueness checking of service IDs during service creation

Note: When uniqueness checking is disabled for a range, a value in the range cannot be used as a service ID for the following. or an error is logged and the service creation fails:

  • manually created service

  • service created using a range policy, if the ranges in the range policy and server configuration overlap to any extent

Note: The order in which you configure the main servers is unimportant, but you must perform the procedure on each main server before you attempt automatic service creation using the specified service ID range.

Steps
 

Log in to the main server station as the nsp user.


Open a console window.


Navigate to the /opt/nsp/nfmp/server/nms/config directory.


Create a backup copy of the nms-server.xml file.


Open the nms-server.xml file using a plain-text editor such as vi.


Locate the section that begins with the following line:

  <idManager>

The section describes the ID ranges for which you can configure the minimum and maximum values.


Add a serviceId range entry with uniqueness checking disabled to the <idManager> section, for example:

    <range

            name="serviceId"

            min="minimum_value"

            max="maximum_value"

            skipIdCheck="true" />

Note: The skipIdCheck parameter can have one of the following values:

  • true—disables the uniqueness check

  • false—enables the uniqueness check

Note: Before you set skipIdCheck to true for a service ID range, you must ensure that no existing service in the NFM-P managed network has a service ID in the range.


Save and close the file.


On a standalone main server, or the primary main server in a redundant system, enter the following:

bash$ /opt/nsp/nfmp/server/nms/bin/nmsserver.bash read_config ↵

The NFM-P puts the configuration change into effect.


10 

Close the console window.

End of steps