Commpkg Install Usage

The commpkg install command enables you to install the Communications Suite products and shared components. It is one of the commands available with the Communications Suite installer, commpkg.

This command lays down the Communications Suite components' installation bits on your machine, but it does not configure these components. To configure the components after installation, see Initial Configuration.

For information about the commpkg general syntax, other commands and options, see:

• Communications Suite Installer: General Syntax and Commands

Tip Installing Only Shared Components: To install just the shared components for a component product, launch the Communications Suite installer then prefix your product selection with a tilde (~). For example, to install only the shared components for Messaging Server 32-bit, at the Product Selection prompt, you would type ~1. You can type multiple selections, using a comma to separate your entries.

Commpkg Install Command: Syntax

Using the installroot|name Command-Line Argument

If you specify installroot|name on the command line, it is equivalent to specifying the --altroot and --installroot options. That is, the command-line argument implies an altroot installation. For example, specifying

commpkg install /opt/sun/comms2

is equivalent to specifying

--altroot --installroot /opt/sun/comms2 

For details about these options, see Commpkg Install Command: Options.

Specifying an installroot of / is same as specifying the default root. It is the same as using neither the --installroot nor the --altroot option, or of not specifying the installaroot|name command-line argument at all.

If you specify the --installroot option in addition to the installroot|name command-line argument, they must match.

Using the name Argument (Instead of installroot)

If you specify the name command-line argument and it exists in the software list, the corresponding installroot is used and --altroot is implied.

If you also specify the --installroot option, it must correspond to the entry in the software list. If you specify name and it does not exist in the software list, it will be added to the software list.

Specifying any name other than "" implies an --altroot. A value for name of "" is reserved for the default root. Therefore, "" cannot be used with --altroot.

Commpkg Install Command: Options

The following options are used by the commpkg install command:

You can use this option to install multiple instances of Communications Suite products on the same host or Solaris zone. You use this option to perform a side-by-side upgrade of Communications Suite products.|

--distro path	Specify the path to packages/patches for the products Default: Location of commpkg script
--installroot path	Specify the path of INSTALLROOT, the top level installation directory for Communications Suite products and shared components. Default INSTALLROOT on Solaris and Linux: opt/sun/comms The 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	Run silent installation, taking the inputs from the INPUTFILE and the command line arguments. The command line arguments override entries in the INPUTFILE. Installation proceeds without interactive prompts. Use --dry-run to test silent installation without actually installing the software. When running a silent installation, 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 installation uses default values. For more information about running a silent installation, see Installing Communications Suite in Silent Mode.
--dry-run or -n	Does not install Communications Suite components. Performs checks.
--upgradeSC [y|n]	Indicate whether or not to upgrade shared components as required. Note: If this option is not specified, you will be prompted for each shared component that needs to be upgraded. Default: n Caution Upgrading shared components is irreversible. However, if you do not upgrade required shared components, products might not work as designed. The --excludeSC flag has precedence over this flag.
--auditDistro	Audit the installation 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	Overwrite 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 ...>	A space delimited set of component products. Each product has mnemonic associated with it. Use commpkg info --listPackages to see the mnemonic for a product. In most shells you need to escape the space between each mnemonic, that is, by adding double quotes around all the components.