... h1. 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|Communications Suite 6 Update 2 Initial Configuration].
For information about the {{commpkg}} general syntax, other commands and options, see:
* [Communications Suite Installer: General Syntax and Commands|commpkg - General Syntax and Commands]
{info:title=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.{info}
h2. {anchor:commpkginstallsyntax} Commpkg Install Command: Syntax
|{{commpkg install \[_options_\] \[_installroot_\|_name_\]}}|
h4. 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
{noformat}
commpkg install /opt/sun/comms2
{noformat}
is equivalent to specifying
{noformat}
--altroot --installroot /opt/sun/comms2
{noformat}
For details about these options, see [Commpkg Install Command: Options|#commpkginstalloptions].
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.
h4. 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}}.
h2. {anchor:commpkginstalloptions} Commpkg Install Command: Options
The following options are used by the {{commpkg install}} command:
||{{commpkg install}} options||Description||
|{{\-\-help}} or {{-?}}|Prints help information|
|{{--version}} or {{-V}}|Prints version information|
|{{--excludeOS}}|Do not apply operating system patches during product installation|
|{{--excludeSC}}|Do 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) will be the alternate root.\\
\\
If you specify a _name_, it will be a friendly name associated with the {{altroot}} that will be registered in the software list. The _name_ option is supported on Solaris OS only (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 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}}\\
\\ |
... \\
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|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}}\\
{warning:title=Caution}
Upgrading shared components is irreversible. However, if you do not upgrade required shared components, products might not work as designed.{warning}\\
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.| |