ncp_password_update.pl

Description

These passwords are used by the Network Manager back-end processes to access the NCIM database and the ObjectServer. The script does not change the NCIM or ObjectServer passwords themselves. However, if your database administrator changes the NCIM or ObjectServer password, then in order to enable the Network Manager back-end processes to access the NCIM database (or the ObjectServer) you must run this script to update the passwords configured in Network Manager to match the new NCIM database (or ObjectServer) passwords.

Note that this script does not change the passwords that are used by the Network Manager GUI components to access the NCIM database and the ObjectServer.

As the ncp_password_update.pl script runs, this script requires user confirmation. The following configuration files are affected by the script.

DbLogins.cfg
MibDbLogin.cfg
NcoLogin.cfg

Original versions of the configuration files are backed up in the directory $NCHOME/etc/precision/backup/. All passwords are encrypted when written to the configuration files.

Note: The set_db_details.pl script performs similar database configuration tasks. See the set_db_details.pl documentation topic for more information.

There are different reasons why the passwords might be changed. For example, if the encryption key on the backup Network Manager domain was updated. In a failover setup, the backup Network Manager domain is installed on a separate server to the primary Network Manager domain. After the installation, the encryption key $NCHOME/etc/security/keys/conf.key must be copied from the primary domain to the backup domain. Any existing encrypted passwords for NCIM access or ObjectServer access are no longer readable.

Running the script

To run the script, complete the following steps.

Run the script, with the appropriate command-line options.
- To update both the NCIM and ObjectServer passwords, use the following command.
```
$NCHOME/precision/bin/ncp_perl
$NCHOME/precision/scripts/perl/scripts/ncp_password_update.pl -domain NCOMS
```
- Alternatively, to update only the NCIM password, use the -ncim command-line option.
```
$NCHOME/precision/scripts/perl/scripts/ncp_password_update.pl -domain NCOMS -ncim
```
To update the passwords in the GUI, click the Administration icon and select Network > Database Access Configuration.
If you are using DB2 as the NCIM database, you can send a sighup signal to the ncp_model process for the updated password to take effect without restarting Network Manager. To do this, run the utility ncp_sighup_model.pl using the following command.
```
$NCHOME/precision/bin/ncp_perl
$NCHOME/precision/scripts/perl/scripts/ncp_sighup_model.pl -domain NCOMS
```
If you are using Oracle as the NCIM database, do not run the ncp_sighup_model.pl script. Instead, restart Network Manager.

Command-line options

The following table describes the command-line options for the ncp_password_update.pl script.

Table 1. ncp_password_update.pl command-line options
Command-line option	Description
-domain `DomainName`	Mandatory. The passwords for NCIM or ObjectServer, or both, are updated for this domain and other domains that have the same credentials.
-ncim	Optional. No value is needed. Updates the NCIM passwords in the `DbLogins` and `MibDbLogin` configuration files.
-objectServer	Optional. No value is needed. Updates the ObjectServer password in the `NcoLogin` configuration file.
-help	Optional. Displays help information about the Perl script.