Sun Java Enterprise System 2003Q4 Installation Guide |
Chapter 5
Installing Software Using the Graphical InterfaceThis chapter describes how to use the installer’s interactive graphical interface to install the Java Enterprise System software. Before starting the tasks in this chapter, you should have already completed the tasks in Chapter 2, "Preparing for Installation".
This chapter includes the following sections:
For an introduction to the Java Enterprise System installer, read "How Does the Java Enterprise System Installer Work?"
Preinstallation ChecklistThe following table lists the tasks that should be performed before beginning Java Enterprise System installation. The left column lists the general order in which you should perform the tasks, the middle column describes the task action, and the right column contains useful information and the location of instructions.
Table 5-1 Preinstallation Tasks
Order
Task
Instructions and Helpful Information
1
Verify that system requirements are met.
Java Enterprise System Release Notes, http://docs.sun.com/doc/816-6876
2
Upgrade any existing component products that are incompatible with Java Enterprise System.
prodreg or pgkinfo command (for further information, refer to their man pages)
"Identifying Component Upgrade Needs"
3
Plan how to install product components.
4
Gather configuration information for component products.
Chapter 3, "Gathering Installation and Configuration Information"
5
Make a copy of the product registry file, /var/sadm/install/productregistry
The backup copy of the product registry is helpful in recovering from a failed installation.
6
Create the necessary system accounts.
For Directory Server or Administration Server to run as a non-root user, you must create the accounts before configuring.
if Identity Server will be running as nobody or root, and will be running as part of a group such as nobody or system, those system accounts must already be set up.
7
If you are installing with Sun Cluster software, plan your installation sequence.
8
If you are installing components that depend on servers or services that are already installed, ensure that the existing servers and services are running and accessible.
For example, If you are installing Portal Server, Secure Remote Access subcomponents, the Portal Server, Secure Remote Access core must be running and accessible.
9
If you are installing Application Server or Directory Server, verify that Perl is installed.
Perl packages (SUNWpl5*) can be found on the Solaris 8 and Solaris 9 media. Use pkgadd to add the packages.
10
If you are installing Identify Server, verify that the domain name of the machine on which the Identity Server is going to be installed is set.
To set the domain name, do one of the following:
# domainname domain_name
For additional information, see Chapter 2 of the Sun ONE Identity Server 6.1 Installation and Migration Guide, http://docs.sun.com/doc/816-6771-10.
11
If you are installing Web Server, verify that UID 80 and GID 80 are not already allocated for Web Server use.
If 80 is already allocated to Web Server, errors will occur and Web Server installation will fail.
12
If this is a reinstallation, verify that the Web Server directory is empty.
When you uninstall Web Server, the following directories are not removed during uninstallation and must be manually deleted: .../docs, .../https-admserv, .../https-instance_server
13
If you are installing Messaging Server:
Stop sendmail before running the installer.
/etc/init.d/sendmail stop
Verify that the second column in the /etc/hosts file contains the fully-qualified domain name (FQDN) rather than a simple host name.
For example:
192.18.99.999 mycomputer.company.com loghost
14
If you are installing Calendar Server, verify that the second column in the /etc/hosts file contains the FQDN rather than a simple host name.
For example:
192.18.99.999 mycomputer.company.com loghost
15
If you are upgrading the J2SE software, verify that you have stopped other products that depend on the J2SE component you are upgrading.
Refer to "J2SE Platform Upgrade Information" for more J2SE information.
Identifying Component Upgrade NeedsFor software that has been installed using a package-based installation, you can use the installer to perform a pre-installation check of the Java Enterprise System-related software packages that are already on your system. The benefit of doing this is that you can identify any component incompatibilities in advance and take care of them before installation. This allows your installation session to run more efficiently.
To Use the Graphical Installer for Identifying Component Upgrade Needs
- Provide access to your local display.
The Java Enterprise System installers may need access to your local display. If you are logging in to a remote machine, or using the su command to become superuser on a local machine, use the xhost command on the local machine to allow access to your local display. For example, use the following command to grant access to all users:
xhost +
If you are logging in to a remote machine, make sure your DISPLAY environment variable is properly set to the local display. If the DISPLAY variable is not set properly, the installer runs in text-based mode. For example, if your machine name is myhost:
(C Shell) % setenv DISPLAY myhost:0.0
(Korn Shell) $ DISPLAY=myhost:0.0- Start the installer using the -no option to indicate that this is not an active installation:
./installer -no
- Proceed through the installer pages to the Component Selection page.
- Change the drop-down list at the upper left corner to Select Components.
- Click View Currently Installed at the top of the page.
The Previously Installed Products report lists the installed component products, specifying the level of Java Enterprise System compatibility for each component.
- Click Next to continue.
If the machine has shared components that are incompatible with Java Enterprise System, the Shared Components Upgrades Required page is displayed.
- For each shared component, review the Installed Version against the Required Version to determine what upgrading needs to be done.
- Exit the installer and do one or both of the following:
- For component products—Follow the instructions in Chapter 4, "Upgrading System Components" to upgrade component products.
- For shared components—Determine whether the newer Java Enterprise System version is compatible with other installed applications on the host.
After you have verified that it is safe to upgrade shared components on the host, do one of the following:
- Repeat the process until the installer indicates that components meet Java Enterprise System requirements.
Instructions for using the text-based installer, refer to "To Use the Text-Based Installer for Identifying Upgrade Needs".
Running the Installer in Graphical ModeThis section contains the following procedures:
To Start the Graphical Installer
- Obtain the product by one of the following methods:
- Provide access to your local display.
If you are logging in to a remote machine, or using the su command to become superuser on a local machine, use the xhost command on the local machine to allow access to your local display. For example, use the following command to grant access to all users:
xhost +
If you are logging in to a remote machine, make sure your DISPLAY environment variable is properly set to the local display. If the DISPLAY variable is not set properly, the installer runs in text-based mode. For example, if your machine name is myhost:
(C Shell) % setenv DISPLAY myhost:0.0
(Korn Shell) $ DISPLAY=myhost:0.0- If you are not logged in as root, become superuser.
- Navigate to the correct directory:
- If you downloaded the software, navigate to the directory where you downloaded it.
cd installer-directory
- If you are using a CD, navigate to the correct directory for your installation, either to the Solaris_sparc or Solaris_x86 directory. For example:
cd /cdrom/Solaris_sparc
- If you are using a DVD, navigate to the directory whose name matches your platform, either to the Solaris_sparc or Solaris_x86 directory.
- Start the graphical installation interface:
./installer
You can use the optional -no parameter to run the installer without installing any software. This is useful to familiarize yourself with the installer and for creating state files for a subsequent silent install.
A full description of the installer options is contained in "Installer Command Line Options".
- The installer starts and the Software License Agreement page is displayed. You must accept the license to continue.
To Select Languages for Installation
The languages you choose will be installed for all the components you select. Each language causes additional packages to be installed, which adds to the disk space required for installation. English is always installed.
Note
If the language of the host system locale is not English, the language on the host system is selected by default.
To Select Components
- To install all components (the default), click Next on the Component Selection page and skip to "To Allow the Installer to Check Your Selections".
- To choose components, change the drop-down list at the upper left corner from Install All Components to Select Components.
A list of components is displayed, organized in groups of related services.
- Click a component name to see a brief description of component in the information panel at the bottom of the following Component Selection page.
Note
If a version of a component product you select is already installed, the Component Selection page disables your ability to install that component product.
Disabled options require that you take action under these circumstances:
- To see a report on the products that are already installed (and thus grayed out), click View Currently Installed at the top of the page.
The Previously Installed Products window lists each installed component product detected by the installer, and specifies its level of Java Enterprise System compatibility.
- If all components are compatible with Java Enterprise System, close the Previously Installed Products window and continue.
- If you need to upgrade a component to another version, proceed to "To Upgrade a Component Product".
- In the Component Selection page, select the component products you want to install.
As you make selections, the installer automatically selects additional components on which your selections have dependencies.
Next to each component product is a number that represents the disk space it requires. At the top of the page, the Disk Space Required number increments as you select component products, providing an approximate total of the disk space required for all your selected component products.
- Click Next to proceed.
To Allow the Installer to Check Your Selections
The installer performs a dependency check of the component products you have selected. If there are problems with dependencies, the Product Dependency Checks window is displayed.
- Review the contents of this page carefully.
The dependency relationships among component products are as follows:
- Compatible. The components that you selected are compatible with each other and with the components detected on the machine. The installer accepts your selections and proceeds to the next question.
- Incompatible. The components you selected are not compatible with each other or with the components detected on the machine. The installer cannot proceed. An error message describes the problem.
To resolve the incompatibility, proceed to one or both of the following procedures:
- Remote component might work. The selected components rely on a component that is not selected but for which a remote copy would be acceptable. The installer can proceed, but a warning is displayed in the Product Dependency Checks window.
- Perform any upgrading required by the dependency check. When issues are resolved, the installer will be able to proceed.
To Upgrade a Component Product
- Click Cancel to close the installer.
- Refer to Chapter 4, "Upgrading System Components" for instructions on performing the necessary upgrades.
- Restart the installer and page through the installer until you arrive at the Component Selection page.
- Click View Currently Installed and verify that all installed products are now compatible with Java Enterprise System.
To Upgrade Shared Components
Shared components that are included in Java Enterprise System, such as J2SE, might already be installed on this host. If installed versions of shared components must be upgraded for Java Enterprise System compatibility, a list of those components is displayed when you click Next on the Component Selection page.
- If any shared components have compatibility issues, the Shared Components Upgrade Required page is displayed.
- If an incompatible version of the J2SE component is detected, the following message window is displayed on top of the Shared Components Upgrades Required page.
For information about these options, see "J2SE Platform Upgrade Information".
- Select an option and click OK. (You may need to resize the window if you cannot see the second option.)
- To have the installer upgrade the shared components listed on the Shared Components Upgrades Required page, click Next.
To Specify Installation Directories and Initiate the System Check
The Installation Directories page displays the default directories for the component products you have selected.
- Examine the default installation directories and verify that they are correct for your deployment before accepting them.
- If the directory defaults are not acceptable, browse for alternative paths and change as needed.
- Click Next to initiate the system check.
The installer checks the following system requirements, based on the directories you provided:
- Available disk space
- Installed memory
- Operating system patches
The left column of the following table lists the possible results of the system check. The right column specifies what you should do for each type of result.
- When the system check is complete and you are satisfied with the state of the system, click Next.
To Specify a Configuration Type
If you have chosen components that can be configured at installation time, the Configuration Type page displays the configuration types that are relevant to the components you selected.
Note
The following component products cannot be configured at installation time: Calendar Server, Instant Messaging, Message Queue, Messaging Server, and Sun Cluster software.
- Decide which configuration type you want:
- Custom. Allows you to configure component products that permit configuration at installation time.
Your tasks include specifying the common server settings, then specifying the configuration information for the components products you selected.
- Minimal. You enter only the minimum values that are necessary for installing the packages.
If you are installing Identity Server, you specify the common server settings and then configure Identity Server and the products upon which it depends.
If you are not installing Identity Server, the installer proceeds without doing further configuration. Skip to "To Confirm Installation Readiness".
- Select a configuration type and click Next.
To Specify the Common Server Settings
If you chose a configuration type and component set that require configuration during installation, the configuration pages are displayed. Descriptions of the information on each configuration page of the installer are contained in Chapter 3, "Gathering Installation and Configuration Information", organized according to component.
Before beginning this phase of the installation, verify that you have gathered the configuration information needed for the component products you selected.Worksheets for collecting your configuration data can be found in Appendix A, "Worksheets for Gathering Information".
For a custom configuration or a minimal configuration that includes Identity Server, the Common Server Settings page is displayed.
- To specify these shared values, fill in the information described in Table 3-2.
Values that you enter here appear as default values on the component product configuration pages.
Tip
Write down any non-default information you enter here as well as passwords. You might need this information for subsequent tasks.
- Click Next to proceed to the component products configuration pages.
To Configure the Individual Component Products
After you have specified the Common Server Settings, the installer presents one or more configuration pages for the component products you selected.
Some of the fields in a component product page display default values from the Common Server Settings page. These values can be edited. For example, the following sample screen shot shows the initial Directory Server configuration page. The fields whose default values are set by the Common Server Settings page are Administrator User ID and Administrator Password. These fields are marked with an asterisk.
- As the individual configuration pages are displayed, you are asked to specify information for the settings.
The following table provides cross-references to specific pages in Chapter 3, "Gathering Installation and Configuration Information," where you can find detailed information on the configuration settings.
- Click Next to proceed to the next component product configuration page.
When you click Next on the final configuration page of the final component product, installation configuration is done. The installer is now ready to install the software packages.
To Confirm Installation Readiness
Before transferring the software to your system, the installer displays a summary page, showing the component products that you selected on the Component Selection page. Shared components are not explicitly listed, but they will be installed if they are needed.
- Review the components listed on the Ready to Install page.
- Make necessary changes on the Component Selection page.
To return to the Component Selection page, click the Back button and continue to click Back on successive pages until the Component Selection page is again displayed.
- Click Next to move forward through the installer again. You do not need to enter previously-entered values.
- Click Next when you are satisfied with the Ready to Install list.
To Register Products and Begin Installing Software
The Product Registration page provides the option of registering your products while software is being installed.
To Cancel Installation
You can cancel installation by clicking Cancel. This starts the uninstaller and removes software that has already been installed.
To Complete the Installation Session
When installation is complete, the Installation Complete page is displayed. Any issues from the installation, such as insufficient memory, are noted on this page. In addition, you are provided with access to the installation summary and logs.
- Click Installation Summary or Installation Log to examine information about the installation. This information is saved in files located in /var/sadm/install/logs so that you can refer to it after you exit the installer.
- If you do not want the What to Do Next page to appear automatically, deselect the default option.
The What to Do Next page provides an introduction to Java Enterprise System documentation, including links to component product documentation sets and a link to the product registry page.
- Click Close to exit the installer.
Your installer session is done. Component products that were installed will need to be started after you have completed the post-installation tasks.
- Proceed to "Next Steps" for instructions on how complete the Java Enterprise System installation.
To Register Your Products With Sun at a Later Time
Adding ComponentsTo install additional components, you can run the installer again. The installer detects the newly-installed components and uses them to satisfy the dependencies of other components. The Component Selection page disables choices that represent the installed components.
For example, suppose you have installed Identity Server and its dependencies during this installation. Later, you decide to install Portal Server. The existing instance of Identity Server will be used to meet Portal Server’s dependency, and you will not be asked to reinstall Identity Server.
Next StepsAt the end of this chapter you should have completed the installer portion of your Java Enterprise System installation. Proceed to "Postinstallation Configuration and Startup" for final instructions on configuring the component products for your environment.
If you want to make an installation image available to other administrators in your enterprise, refer to "Setup Instructions for Network Installation".