h3. {anchor:GFWDQ} To Run the Communications Suite Installer
# Become superuser.
# Start the text-based installer by running the {{commpkg}} command.
See [commpkg install Usage] for more information. Running {{commpkg}} creates a log file that records the installation parameters.
{code}
# ./commpkg install
-- LOGFILE: /tmp/CommsInstaller_20090401132825.log
{code}
# Accept the License Agreement.
If you have already read the agreement in its entirety, you have the option of skipping the agreement and accepting the terms. To accept the terms of the agreement without viewing the entire license agreement, press Enter to continue, then type *{{n}}* to skip reading the agreement, and type *{{yes}}* to accept the terms.
# Specify Installation Location where server files will be installed (also known as the {{INSTALLROOT}}) or accept the default location.
{info:title=Note}
Starting with Communications Suite 6, the default {{INSTALLROOT}} has changed from {{/opt/SUNWmsgsvr}} to {{/opt/sun/comms/messaging}} (for 32-bit installations) and {{/opt/sun/comms/messaging64}} (for 64-bit installations).
{info}
After specifying the {{INSTALLROOT}}, notices for operating system and shared components patches appear if previous versions of patches are installed on the machine.
# Select the products you want to install.
The following products are included in this release:
Messaging Server 7 Update 2
Messaging Server (64-bit) 7 Update 2
Comms DSsetup 6.4
Calendar Server 6.3 (with upgrade patch installed by {{commpkg}})
Instant Messaging 8 Update 1
Convergence 1 Update 2
Delegated Administrator 7 (with upgrade patch installed by {{commpkg}})
Communications Express 6.3 (with upgrade patch installed by {{commpkg}}).
Messaging Server Sun Cluster HA agent 7.0
Calendar Server Sun Cluster HA agent 6.3
# The installer generates the list of items to install.
In this step, the installer lists all the products as well as shared components to be installed or upgraded. If items need to be upgraded, the installer gives you the choice to upgrade.
{warning:title=Caution}Upgrading shared components is an irreversible process. However, if you do not install the correct version of the shared components, the product might not work as designed. Thus, proceed carefully when installing and upgrading shared components and products.{warning}
Once you determine what products you want to install and upgrade, the installer creates a summary.
# The installer prompts you to confirm that you are ready to install.
Once you specify the components you are installing and upgrading, the installer is ready to install Messaging Server files into {{INSTALLROOT}}.
If everything installs properly, you see {{All tasks PASSED}} in the summary panel.
# Log files are created.
Once installation has completed, time-stamped log files are created.
#* To undo your installation, use the {{undoCommsInstall}} script, which has a location similar to the following example:{{/var/opt/CommsInstaller/logs/undoCommsInstall_20090401135358}}
#* To run silent installation for multiple installations, use the silent installation file, which has a location similar to the following example:{{/var/opt/CommsInstaller/logs/silent_CommsInstaller_20090401135358}}
#* The installer creates a log file of the installation process in the {{/var/opt/CommsInstaller/logs}} directory, for example:{{/var/opt/CommsInstaller/logs/CommsInstaller_20090401135358.log}}
# If you want to remove the installation that you just ran, you can undo your installation by running the {{undoCommsInstall}} script, for example:
{{/var/opt/CommsInstaller/logs/undoCommsInstall_20090401135358}}
Undo reverses the specific steps taken during installation. It also undoes shared component installations. If, however, you want to pick and choose specific components to uninstall, use the {{commpkg uninstall}} command. See [commpkg uninstall Usage|commpkg uninstall Usage] for more information. The uninstaller does not uninstall shared components.
# The installer creates the following directory layout.
In the {{INSTALLROOT}} (default: {{/opt/sun/comms}}), you might see the following directories:
#* {{CommsInstaller}}, where a copy of the Installer resides.
{info:title=Note}
The log files listed in the previous step are located in the {{/var/opt/CommsInstaller/log}} directory. If you install Messaging Server in an alternate root, the logfiles are located in the alternate root~s {{INSTALLROOT/var/opt/CommsInstaller/log}} directory.
{info}
#* {{messaging}}, the 32-bit Messaging Server version
#* {{messaging64}}, the 64-bit Messaging Server version
# Become superuser.
# Start the text-based installer by running the {{commpkg}} command.
See [commpkg install Usage] for more information. Running {{commpkg}} creates a log file that records the installation parameters.
{code}
# ./commpkg install
-- LOGFILE: /tmp/CommsInstaller_20090401132825.log
{code}
# Accept the License Agreement.
If you have already read the agreement in its entirety, you have the option of skipping the agreement and accepting the terms. To accept the terms of the agreement without viewing the entire license agreement, press Enter to continue, then type *{{n}}* to skip reading the agreement, and type *{{yes}}* to accept the terms.
# Specify Installation Location where server files will be installed (also known as the {{INSTALLROOT}}) or accept the default location.
{info:title=Note}
Starting with Communications Suite 6, the default {{INSTALLROOT}} has changed from {{/opt/SUNWmsgsvr}} to {{/opt/sun/comms/messaging}} (for 32-bit installations) and {{/opt/sun/comms/messaging64}} (for 64-bit installations).
{info}
After specifying the {{INSTALLROOT}}, notices for operating system and shared components patches appear if previous versions of patches are installed on the machine.
# Select the products you want to install.
The following products are included in this release:
Messaging Server 7 Update 2
Messaging Server (64-bit) 7 Update 2
Comms DSsetup 6.4
Calendar Server 6.3 (with upgrade patch installed by {{commpkg}})
Instant Messaging 8 Update 1
Convergence 1 Update 2
Delegated Administrator 7 (with upgrade patch installed by {{commpkg}})
Communications Express 6.3 (with upgrade patch installed by {{commpkg}}).
Messaging Server Sun Cluster HA agent 7.0
Calendar Server Sun Cluster HA agent 6.3
# The installer generates the list of items to install.
In this step, the installer lists all the products as well as shared components to be installed or upgraded. If items need to be upgraded, the installer gives you the choice to upgrade.
{warning:title=Caution}Upgrading shared components is an irreversible process. However, if you do not install the correct version of the shared components, the product might not work as designed. Thus, proceed carefully when installing and upgrading shared components and products.{warning}
Once you determine what products you want to install and upgrade, the installer creates a summary.
# The installer prompts you to confirm that you are ready to install.
Once you specify the components you are installing and upgrading, the installer is ready to install Messaging Server files into {{INSTALLROOT}}.
If everything installs properly, you see {{All tasks PASSED}} in the summary panel.
# Log files are created.
Once installation has completed, time-stamped log files are created.
#* To undo your installation, use the {{undoCommsInstall}} script, which has a location similar to the following example:{{/var/opt/CommsInstaller/logs/undoCommsInstall_20090401135358}}
#* To run silent installation for multiple installations, use the silent installation file, which has a location similar to the following example:{{/var/opt/CommsInstaller/logs/silent_CommsInstaller_20090401135358}}
#* The installer creates a log file of the installation process in the {{/var/opt/CommsInstaller/logs}} directory, for example:{{/var/opt/CommsInstaller/logs/CommsInstaller_20090401135358.log}}
# If you want to remove the installation that you just ran, you can undo your installation by running the {{undoCommsInstall}} script, for example:
{{/var/opt/CommsInstaller/logs/undoCommsInstall_20090401135358}}
Undo reverses the specific steps taken during installation. It also undoes shared component installations. If, however, you want to pick and choose specific components to uninstall, use the {{commpkg uninstall}} command. See [commpkg uninstall Usage|commpkg uninstall Usage] for more information. The uninstaller does not uninstall shared components.
# The installer creates the following directory layout.
In the {{INSTALLROOT}} (default: {{/opt/sun/comms}}), you might see the following directories:
#* {{CommsInstaller}}, where a copy of the Installer resides.
{info:title=Note}
The log files listed in the previous step are located in the {{/var/opt/CommsInstaller/log}} directory. If you install Messaging Server in an alternate root, the logfiles are located in the alternate root~s {{INSTALLROOT/var/opt/CommsInstaller/log}} directory.
{info}
#* {{messaging}}, the 32-bit Messaging Server version
#* {{messaging64}}, the 64-bit Messaging Server version