Script options
Following are the required
and optional command
line script parameters:
Avoid using the following
special characters when entering text strings
for <OldGroupName> and <NewGroupName>: $ / \
Option | Purpose |
|---|---|
--install-service or -i | Indicates that the service needs to be installed.
|
--old-group="<OldGroupName>" or -o "<OldGroupName>" | A required value
that specifies the old group name to be changed.
|
--new-group="<NewGroupName>" or -n "<NewGroupName>" | A required value that specifies the new group name.
|
--basedir=<BASEDIR> or -b <BASEDIR> | A required value which specifies the installation base directory.
|
--show or -s | Indicates that you want to see the current
group names, services and Domain Manager names.
|
--help or -h | --help or -h shows command line parameters
and examples. This parameter is used alone. |
The order of the parameters
is not important.
Always include the BASEDIR of the installed
services in the command line. The only instances where you do not
have to include it is when using the Help (-h) option.
Following are the steps that the script performs
once invoked:
- If the local directoryBASEDIR/smarts/local/conf/mpls-tmadoes not already exist, it is created and a copy of the original mpls-tma.conf file from theBASEDIR/smarts/conf/mpls-tmadirectory is copied to it.
- If a service corresponding to the <OldGroupName> is installed, the following process is initiated:
- If the service is running and the user command line argument is not -s or --show, the script displays an error message and exits. You must stop the services before you can rename them.
- If the service is not running and the Service Daemon is running, then the script uninstalls the service for the current <OldGroupName>, installs the service for the <NewGroupName>, then continues to step 4.
- If the service is not running and the Service Daemon is not running, then the script displays a warning that there is potential for mismatch, uninstalls the service for the current <OldGroupName>, installs the service for the <NewGroupName>, then continues to step 4.
- If a service corresponding to the <OldGroupName> is not installed, the following process is initiated:
- If the installation option (--i or -install-service) is not specified, the scripts does not install the service.
- If the installation option (--i or -install-service) is specified and if the Service Daemon is running, the script installs the service corresponding to the <NewGroupName>.
- If the installation option (--i or -install-service) is specified and if the Service Daemon is not running, the script warns you that you must start it and exits without further action.
- The script then replaces the <OldGroupName> with <NewGroupName> inBASEDIR/smarts/local/conf/mpls-tma/mpls-tma.confand terminates.