The following topics are described in this section:
You can get the Sun Java System Messaging Server 6.3 64–bit Edition software as a Web download.
You can download a compressed archive of all installation files from the Sun Download Center at http://www.sun.com/downloads. The Messaging Server installation files are available in zip images: one for SPARC and one for x86 platforms.
The commpkg command enables you to run the Messaging Server 6.3 64–bit Edition installer. This command lays down the Messaging Server installation bits on your machine, but it does not configure Messaging Server. To configure Messaging Server after installation, see Chapter 1, Post-install Tasks and Layout, in Sun Java System Messaging Server 6.3 Administration Guide in the Sun Java System Messaging Server 6.3 Administration Guide.
commpkg [general options] verb [verb-specific options] |
The general options for this command are:
Option |
Description |
---|---|
-? or —help |
Displays Help |
-V or —version |
Displays Version of Messaging Server |
The verb is one of the following:
Verb |
Description |
---|---|
install |
Performs Messaging Server installation |
uninstall |
Performs Messaging Server uninstallation |
Automatic Upgrade is not available at this time. You can perform a manual upgrade by following the procedures in Upgrading Messaging Server.
The verb-specific options can be one or more of the following:
verb-specific options |
Description |
---|---|
—excludeOS |
Do not apply Operating System patches during product installation |
—excludeSC |
Do not install, upgrade, or patch any Shared Components |
—acceptLicense |
Accept the license conditions in the LICENSE.txt file |
—altroot |
Specify 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. |
—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 Messaging Server. . Note – The subdirectories for individual Communications Suite products (which will be a part of this installer at later releases) will be under the INSTALLROOT. |
—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 —dryrun to test silent installation. |
—dry-run or -n |
Does not install Messaging Server. Performs checks. |
—upgradeSC [y|n] |
Indicate whether or not to upgrade shared components as required. Warning: Upgrading Shared Components is irreversible. However, if you do not upgrade required shared components, products might not work as designed. Note: If the [y|n] is not specified, you will be prompted for each shared component that needs to be upgraded. Default: n 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. |
—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. |
Log on as root to become a superuser.
Start the text-based installer. Use the commpkg usage as described in commpkg usage. When commpkg is invoked, a log file will record the installation parameters.)
# ./commpkg install -- LOGFILE: /tmp/CommsInstaller_20070501132825.log |
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, hit Enter to continue, then enter n to skip reading the agreement, and enter yes to accept the terms.
Specify Installation Location where server files will be installed (also known as the INSTALLROOT) or accept the default location.
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)
After specifying the INSTALLROOT, notices for Operating System and Shared Components patches may appear if previous versions of patches are installed on the machine.
Select Products to Install
In this release, there are four products: Messaging Server 6.3, Messaging Server 6.3 (Localized Version), Messaging Server 6.3 64–bit, and Messaging Server 6.3 64–bit (Localized Version).
Generate List of Items to Install
In this step, the installer lists all the products as well as shared components that will be installed or upgraded. If items need to be upgraded, the installer will give you the choice to upgrade.
Remember, upgrading shared components is an irreversible process. However, if you do not install the correct version of the shared components, the product may not work as designed. So, proceed carefully when installing and upgrading shared components and products.
Once you determine what you are going to install and upgrade, the installer will create a summary.
Ready to Install
Once you specify the components you're installing and upgrading, the installer is ready to install Messaging Server files into INSTALLROOT.
If everything installs properly, you will see All tasks PASSED in the summary panel.
Log Files
Once installation has completed, time-stamped log files are created like in the following example:
To undo your installation, go to your undoCommsInstall script like the following example:/var/opt/CommsInstaller/logs/undoCommsInstall_20070501135358
To run silent installation for multiple installations, use the silent installation file like in the following example:/var/opt/CommsInstaller/logs/silent_CommsInstaller_20070501135358
The installer creates a log file of the installation process in the following location. For example:/var/opt/CommsInstaller/logs/CommsInstaller_20070501135358.log
Undo Installation
If you want to remove the installation that you just ran, you can undo your installation by running the undoCommsInstall script like the following example:/var/opt/CommsInstaller/logs/undoCommsInstall_20070501135358.
Undo reverses the specific steps taken during installation. It will also undo Shared Component installations. If, however, you want to pick and choose specific components to uninstall, use the commpkg uninstall command: Uninstalling Messaging Server. The uninstaller does not uninstall shared components.
Directory Layout
In the INSTALLROOT (default: /opt/sun/comms), you may see the following directories:
CommsInstaller, where a copy of the Installer resides.
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.
messaging, the 32–bit Messaging Server version
messaging64, the 64–bit Messaging Server version
If you run the installer in Silent mode, you are running a non-interactive session. The installation inputs are taken from a silent installation file (also known as a state file), from command line arguments, or defaults.
To run a silent installation, follow these steps:
Run an interactive installation session. (See To Begin Installation.) A state file similar to /var/opt/CommsInstaller/logs/silent_CommsInstaller_20070501135358 is automatically created.
Copy the state file to each host machine and edit the file as needed. See Silent Mode File Format.
Run the silent installation on each host. See the silent installation usage in commpkg usage.
Command-line arguments override the values and arguments in the state file.
The silent mode file (also known as a state file) is formatted like a property file: blank lines begin with a number sign (#) and properties are key/value pairs separated by an equals (=) sign. You can change the following parameters:
VERB— indicate which function to perform. For example VERB=install
You can add CLI arguments described in commpkg usage, however the —dry-run argument cannot be added to the install function in the state file.
ALTDISTROPATH— indicate an alternate distro path if —distro is not specified. For example, ALTDISTROPATH=SunOS5.10_i86pc_DBG.OBJ/release
PKGOVERWRITE— set this flag if you want to overwrite the existing installation packages. For example, PKGOVERWRITE=YES
INSTALLROOT— specify installation root. For example, INSTALLROOT=/opt/sun/comms
ALTROOT— set this flag if you want to use an alternate root. For example, ALTROOT=yes
EXCLUDEOS— set this flag if you don't want to upgrade Operating System patches. For example, EXCLUDEOS=YES
COMPONENTS— list the components you want to install. For example:
COMPONENTS=MS64 for 64–bit Messaging Server.
COMPONENTS=MS64_L10N for localized 64–bit Messaging Server.
COMPONENTS=MS for 32–bit Messaging Server.
COMPONENTS=MS_L10N for localized 32–bit Messaging Server.
ACCEPTLICENSE- indicate whether or not to accept license. For example, ACCEPTLICENSE=yes.
This property must be specified either in the state file or as a command line argument.
UPGRADESC– indicate whether all shared components should or should not be upgraded without prompting. For example, UPGRADESC=no
For handling shared components, you have two options:
Don't install shared components. To do this, run the installer program with the —excludeSC flag. See commpkg usage.
Install the shared component dependencies such as in the Non-global sparse root zone scenario. This option installs only the shared components that are necessary for the products you are installing. To do this, add a ~ (tilde) to the component number you want to install in the sparse zone. For example, if you plan to install Messaging Server 64–bit in the sparse zone, you select ~3 during the global zone installation. The installer will know to only install dependencies and not the product itself.
Unlike the previous version of the installer, this version allows multiple installations of the same product version on the same machine by using different INSTALLROOTS.
To do so, install the product in the alternate root with the —altroot flag:
Install OS patches and Shared Components in the default INSTALLROOT. See To Begin Installation. To only install the shared components, add a ~ (tilde) to the component number you want to install in the alternate root. For example, if you plan to install Messaging Server 64–bit in the alternate root, you select ~3 during the default installation. The installer will know to only install dependencies and not the product itself.
OS patches are always applied in the default INSTALLROOT, never in the alternate root.
Install Shared Components and Messaging Server in the Alternate Root like the following example:
commpkg install —altroot —installroot /opt/sun/comms2
Be sure to use —installroot with —altroot to specify the alternate root.
You may create as many alternate roots as you would like. However, you should manually keep track of all the alternate roots you have created.