Sun ONE logo      Previous      Contents      Index      Next     

Sun ONE Portal Server 6.1 Installation Guide

Chapter 2
Installing Sun ONE Portal Server

This chapter includes instructions for installing the Sun™ ONE Portal Server software and its supporting components.

If you are migrating from iPlanet™ Portal Server 3.0 (Service Pack 3a or 4) to Sun ONE Portal Server 6.1, back up your system before installing the Sun ONE Portal Server 6.1 software. This safety precaution eliminates the possibility of customizations being overwritten.

This chapter contains the following sections:

Note

To perform a new installation of the Sun ONE Portal Server software, ensure that the requirements discussed in Chapter 1, "Planning the Installation" have been met.

Installing the Sun ONE Portal Server

This section describes the steps for installing the Sun ONE Portal Server software. As part of the installation, the Sun ONE Portal Server software will install:

Note

The My Yahoo! Provider is automatically installed with the Sun ONE Portal Server product. It is no longer necessary to perform a separate installation of the My Yahoo! Provider.

To install the Sun ONE Portal Server software over an existing Sun ONE Identity Server running as user nobody, change the Sun ONE Identity Server to run as root. To change Sun ONE Identity Server to run as root:

  1. Log in to the server running Sun ONE Identity Server and become suppresses.
  2. Modify the following files:
    1. Change the line User nobody to User root in S1PSBaseDir/SUNWam/servers/https-hostname.domain/config/magnus.conf file.
    2. Change the line nsslapd-localuser: nobody to nsslapd-localuser:root in DSBaseDir/slapd-hostname/config/dse.ldif file.
  3. Change the ownership of the following directories from nobody to root. That is, type:

    4.   chown -R root:other /etc/opt/SUNWam

      chown -R root:other DSBaseDir

      chown -R root:other /tmp/https*

      chown -R root:other /opt/SUNWam

      chown -R root:other /var/sadm/pkg/SUNWamsvc

      chown -R root:other /var/sadm/pkg/SUNWamws

      chown -R root:other /var/sadm/pkg/SUNWamds

  4. Restart the directory server as the root user.
  5. Run /etc/init.d/amserver stop.
  6. Ensure that all of the processes are stopped. To verify, type:

    7.   ps -ef | grep SUNWam

      ps -ef | grep DSBaseDir

    Kill off any processes that did not get shutdown.

  7. Run /etc/init.d/amserver start.

To install the Sun ONE Portal Server software:

  1. Log in to the machine and become superuser.

    2. You will need root access to install the Sun ONE Portal Server.

  2. Change directories to where the installation program is located.
  3. Type:

    4.   ./pssetup

  4. Specify if you accept the license agreement. To accept, type yes.

Note

Although this product will run without a license, you must either purchase a Binary Code License from, or accept the terms of a Binary Software Evaluation license with Sun Microsystems, to legally use this product.

  1. Select the option to install the Sun ONE Portal Server.
  2. Select the Deployment type. If installing on an application server, see the appropriate appendix.

Tip

Anytime during the installation, you can view the installation log at /var/sadm/install/logs/pssetup.pid/install.log for a status on the installation. To view the log file during installation, for example, enter:

tail -f /var/sadm/install/logs/pssetup.pid/setup.log

Here, pid is the process id for pssetup process. After installation, check this log for errors during installation.

Another way to view the contents of the install log is by setting the DISPLAY environment variable to run an xterm window.

For example, if you are on one machine (server1.sesta.com) and are performing an installation of Sun ONE Portal Server on another machine (server2.sesta.com), you can do the following to view the log file during installation:

In a terminal window on server, type the command xhost + server2. Next login to server2 and set the DISPLAY environment variable to server1:0.0.

When the pssetup script is run, an xterm window will appear with the contents of the setup.log for the installation on server2.

Installing the Sun ONE Directory Server

To install the Sun ONE Directory Server software:

  1. Log in to the machine and become superuser.

    2. You will need root access to install the Sun ONE Directory Server.

  2. Change directories to where the installation program is located.
  3. Type:

    4.   ./pssetup

  4. Specify if you accept the license agreement. To accept, type yes.

Note

Although this product will run without a license, you must either purchase a Binary Code License from, or accept the terms of a Binary Software Evaluation license with Sun Microsystems, to legally use this product.

  1. Select the option to install the Sun ONE Directory Server only.

    2. See the section "Checklist for Sun™ ONE Directory Server" in Chapter 1 to install the software.

Tip

Anytime during the installation, you can view the installation log at /var/sadm/install/logs/pssetup.pid/install.log for a status on the installation. To view the log file during installation, for example, enter:

tail -f /var/sadm/install/logs/pssetup.pid/setup.log

Here, pid is the process id for pssetup process. After installation, check this log for errors during installation.

Note

When performing multiple installations of the Sun ONE Portal Server product, each installation must be on a separate machine. Multiple Sun ONE Portal Server instances on a single machine, however, are supported. For instructions on creating multiple instances on the server, see Chapter 3, "Post Installation Configuration."

Configuring an Existing Directory Server

To install the Sun ONE Portal Server software using an existing Sun ONE Directory Server, the Sun ONE Portal Server 6.1 pssetup script provides an option to configure the Directory Server. This option provides a way for you to configure a Sun ONE Directory Server installation that was not originally installed using the pssetup script to work with the Sun ONE Identity Server.

To configure an existing Sun ONE Directory Server installation:

  1. Log in to the system as superuser.
  2. Change directories to where the installation program is located.
  3. Type:

    4.   ./pssetup

  4. Specify if you accept the license agreement. To accept, type yes.

Note

Although this product will run without a license, you must either purchase a Binary Code License from, or accept the terms of a Binary Software Evaluation license with Sun Microsystems, to legally use this product.

  1. Select the option to configure the Directory Server.

    2. See the section "Checklist for Sun™ ONE Directory Server" in Chapter 1 to install the software.

Upgrading Sun ONE Portal Server

The Sun ONE Portal Server installation script allows you to upgrade the software from Sun ONE Portal Server 6.0 to Sun ONE Portal Server 6.1. This process includes some migration procedures. See the Sun ONE Portal Server 6.1 Migration Guide for more information on upgrading the software.

Installing the Migration Tools

The Sun ONE Portal Server software includes migration utilities for migrating from iPlanet Portal Server 3.0 (Service Pack 3a or 4) to this release of the software.

To install the migration tools:

  1. Log in to the system become superuser.

    2. The migration utilities can be installed on a system that has an existing version of iPlanet Portal Server 3.0 (Service Pack 3a or 4) already installed. If you are migrating from an iPlanet Portal Server 3.0 (Service Pack 3a or 4) system to a separate Sun ONE Portal Server 6.1 system, you need two installations of the iPlanet Portal Server 3.0 Data Migration Tool Suite, one on each system. You can install Sun ONE Portal Server 6.1 on an iPlanet Portal Server 3.0 (Service Pack 3a or 4) system for single-system migration. You will need root access to install the migration utilities.

  2. Change directories to where the installation program is located.
  3. Type:

    4.   ./pssetup

  4. Accept the default installation location or specify the directory where you want to install the migration utilities.

    5. By default, the software will install the utilities in /opt. If you are installing the migration utilities on the system hosting Sun ONE Portal Server 6.1 software, the tools will be installed in S1PSBaseDir/SUNWps/migration.

  5. Select the option to install the Migration Tools only.

    6. The installation program will install the migration tools in the specified location. That is, the tools are installed in S1PSBaseDir/SUNWps/migration/bin directory.

See the Sun ONE Portal Server 6.1 Migration Guide for more information on migrating from iPlanet Portal Server 3.0 Service Pack 3a or 4 to Sun ONE Portal Server 6.1 using the migration utilities.



Previous      Contents      Index      Next     

Copyright 2003 Sun Microsystems, Inc. All rights reserved.