Reassigning role files

When creating your Nuance Network in Management Station, you assign role files to your managed hosts to specify the services to run on them. You can reassign role files, for example, if you need to re-add a host or to apply changed role files.

When you complete the reassigning procedure, each service in the role files has a pair of corresponding configuration files: a backup configuration (generated when you unassign the role file) and a new configuration (generated when you reassign the role file). Use a text editor to compare their contents. Do this to detect any property values in the backup that you want to apply in the new configuration.

1. Log in to Management Station.

2. Select Monitoring & Control > System View.

3. Expand Nuance Network to display the hosts.

4. Select a host and then click Network Design.

5. Make a note of the name of the assigned role file, so that you know which one to reassign.

6. Select Services and then click Shutdown All to stop all services on the selected host.

7. Click Remove Host to unassign the role file from the selected host.

   Note: Management Station writes the properties to each service's configuration file in the role file. The configuration files are located in $NUANCE_DATA_DIR/system/config. When you unassign a role file, Management Station renames the configuration files for backup purposes by appending .prv_<time_service_unassigned> to each name (where prv is an abbreviation for "previous").

8. Select the Nuance Network icon and then re-add the host:

   1. Select Host from the Type menu.

   2. Select the same role you unassigned from the Role menu.

   3. Select the host you removed under Resource.

   4. Click Add Network Element. Management Station creates a new configuration file for each service included in the role file.

9. Log in to the Management Station host as root (Linux) or Administrator (Windows).

10. Navigate to $NUANCE_DATA_DIR/system/config to review the service configuration files.

11. For each service in the reassigned role file, use a text editor to compare the contents of the new configuration file with its corresponding backup. Do this to detect any non-default property settings in the backup that you want to duplicate in the new configuration. Edit the new configuration files to include any of those settings, and then save the file.

12. Log into Management Station and start all services on the host.