Communications Suite InformationCommpkg Upgrade Usage
The commpkg upgrade command, which is available with the Communications Suite installer, commpkg, enables you to upgrade the Communications Suite products and shared components.
This command upgrades the Communications Suite components' software installation on your machine, but it does not configure these components. To configure the components after installation, see Initial Configuration.
For information about upgrading components, see the Communications Suite 6 Update 2 Upgrade Guide.
For information about the commpkg general syntax, other commands, and options, see:
Commpkg Upgrade Command: Syntax
| commpkg upgrade [options] [installroot|name] |
Using the installroot|name Command-Line Argument
Specify installroot|name on the command line to use an alternate root to use for the upgrade. That is, it is equivalent to specifying the --altroot and --installroot options.
If you specify the name command-line argument, it must exist in the software list. If it is not, an error is returned. The name is looked up in the software list and is used for the corresponding installroot.
For details about these options, see Commpkg Install Command: Options.
Commpkg Upgrade Command: Options
The following options are used by the commpkg upgrade command:
| commpkg upgrade Options | Description | ||
|---|---|---|---|
| --excludeOS | Does not apply operating system patches during product upgrade. | ||
| --excludeSC | Does not install, upgrade, or patch any shared components. | ||
| --acceptLicense | Accepts the license conditions in the LICENSE.txt file. | ||
| --altroot [name] | Specifies an alternate root directory during a multi-host installation. The INSTALLROOT (the top-level installation directory for all products and shared components) is the alternate root. If you specify a name, it is a friendly name associated with the alternate root that is registered in the software list. The name option is supported only on Solaris OS (not on Red Hat Linux). You can use this option to install multiple instances of Communications Suite products on the same host or Solaris zone. You can use this option to perform a side-by-side upgrade of Communications Suite products. |
||
| --distro path | Specifies the path to packages and patches for the products. Default: Location of commpkg script |
||
| --installroot path | Specifies the path of INSTALLROOT, the top-level installation directory for Communications Suite products and shared components. Default INSTALLROOT on Solaris OS and Red Hat Linux: /opt/sun/commsThe subdirectories for individual Communications Suite products are installed under the INSTALLROOT. For example, Messaging Server (32-bit) software is installed by default in /opt/sun/comms/messaging. |
||
| --silent INPUTFILE | Runs silent upgrade, taking the inputs from the INPUTFILE and the command-line arguments. The command-line arguments override entries in the INPUTFILE. Upgrade proceeds without interactive prompts. Use --dry-run to test silent upgrade without actually installing the software. When running a silent upgrade, you must use the --acceptLicense option in the command line or set ACCEPTLICENSE=YES in the INPUTFILE. Specify NONE for INPUTFILE if you want to run in silent mode without using an input file. When you specify NONE, the upgrade uses default values. For more information about running a silent upgrade, see Upgrading Communications Suite in Silent Mode. |
||
| --dry-run or -n | Does not upgrade Communications Suite components. Performs checks. This option creates a silent upgrade file in the /tmp directory. |
||
| --upgradeSC [y|n] | Indicates whether or not to upgrade shared components as required. Note: If this option is not specified, you are prompted for each shared component that needs to be upgraded. Default: n
The --excludeSC flag has precedence over this flag. |
||
| --auditDistro | Audits the distribution to verify that the required patches and packages are present and that the packages have the correct versions. Compares the installed distribution to the product files internal to commpkg. | ||
| --pkgOverwrite | Overwrites the existing installation package. You might use this option when you are installing a shared component in a global zone where either the shared component does not exist in a global zone, or the shared component exists in the whole root zone. The default is not to override the existing package. In general, shared components should be managed in the global zone. | ||
| --components comp1 comp2 ... | Specifies the Communications Suite component products to be upgraded. Separate each component product with a space. (Thus, the list is a space-delimited set.) To specify each component product, use the mnemonic associated with that product. For example, Messaging Server (32-bit) uses MS, Messaging Server (64-bit) uses MS64, Calendar Server uses CS, and so on. To display a list of the mnemonics for all the component products, use the commpkg info --listpackages command. |
||
| --usePkgUpgrade | For Communications Suite products, if the upgrade can be performed by using a patch or an in-place package upgrade, this option uses the in-place package upgrade. The default is to use a patch to upgrade, if possible. Note: patches are only used on Solaris OS. |
commpkg upgrade Sample Session
Here is a sample session of commpkg upgrade.
Sign up or Log in to add a comment or watch this page.