Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Portal Server 6 Enterprise Sample Installation Guide 

Chapter 1
Install the Enterprise Sample

Overview

Installation of the Enterprise Sample can be completed in stages:

Installation Prerequisites

Before installing the Enterprise Sample, ensure that the following software is installed and running:

The Enterprise Sample requires that all Sun Java System products (with the possible exception of the Directory Server) reside on the same machine. The Directory Server can reside either on the same machine or on a separate machine.

Note

The examples in this chapter use the following fictitious specifications:

  • Host name: company22.example.com.
  • Base DN or root suffix (for the Directory Server): dc=example, dc=com
  • Organization DN (for the User Management Utility): o=company22.example.com

Wherever you see these specifications in responses to prompts or in command lines, substitute the corresponding values that are appropriate for your installation.

Obtain and Run the Installation Script

Afetr you obtain a copy of the Enterprise Sample software kit, set up the installation as follows:

  1. Unzip the software kit using a command similar to the following:

    2. unzip enterprise_sample.zip

  2. Change directory into the enterprise_sample directory:

    3. cd enterprise_sample

  3. Run the setup program:

    4. ./setup

Install the Enterprise Sample

When you run the Enterprise Sample setup script prior to installation, and after you accept the license agreement, the script displays the following:

Welcome to the Sun Java System Portal Server

Enterprise Sample Installer

The logfile for the installer:

system_log_dir/Sun_Java_System_Portal_Enterprise_Sample_install.log_id

Please select one of the following options:

1) Install Enterprise Sample

2) Quit

  1. Select option 1 to install the Enterprise Sample.
  2. Provide General Setup information by responding to the following prompts:

    3. General Setup
    -------------

    What is the Identity Server administrative password? Again?

    What is the Identity Server internal ldap user password? Again?

    What is the Directory Manager password? Again?

    What is the Web Container administrative password? Again?

    Please specify the organization to create? [adventuresportscafe.com]

    Note

    If the organization exists, the setup script notifies you and asks you to enter a different organization name.

  3. Specify General Settings information or accept the default values.

    4. General Settings
    ----------------

    Directory server host : company22.example.com

    Directory server port : 389

    Identity server host : company22.example.com

    Identity server port : 80

    Organization naming attribute : o

    User naming attribute : uid

    People container : ou=People

    Role naming attribute : cn

    Accept defaults? [y]

  4. Provide Portal Setup information or accept the default values.

    5. Portal Setup
    ------------

    Desktop Default Channel Name : WirelessDesktopDispatcher

    Default Authentication-less uid :

    uid=authlessanonymous,ou=People,dc=example,dc=com

    Accept defaults? [y]

  5. Review the installation information for details pertaining to the modifications that will be made to the system.

    6. Installation Information
    ------------------------

    Please be advised that modifications will occur on this system.

    The organization adventuresportscafe.com will be created and it

    will be configured with the following:

    Services

      * Identity Server Configuration

        - Administration

        - Authentication

          + Core

          + Membership

        - Policy Configuration

        - User

      * Portal Server Configuration

        - Portal Desktop

        - SSO Adapter

    Roles

    * AustraliaExpansionRole

    * NewCustomerToursRole

    Users

    * Chris Content-Editor (chris/ascsample) is a member of

    the role AustraliaExpansionRole

    * Ed Employee (ed/ascsample) is a member of the role

    NewCustomerToursRole

    * Mary Manager (mary/ascsample) is a member of the roles

    AustraliaExpansionRole and NewCustomerToursRole

    Portal Desktop

    * the default Channel name is ASCTabContainer

    * templates for the desktop are found under

    /etc/opt/SUNWps/desktop/asc

  6. Answer y to start the installation:

    7. Start installation? [y]

When the installation is complete, the setup script displays instructions for accessing the Welcome Page for the Enterprise Sample. For details, see Access the Enterprise Sample Welcome Page. Note that it is not necessary to restart the web container.

Configure Communication Channels

After the Enterprise Sample has been installed, you can rerun the setup script to configure support in the Enterprise Sample for the following Communication channels:

You can run the Configure Communication Channels option as often as required.

Before configuring support for the Communication channels, you must ensure that the required Sun Java Enterprise Server components are installed and configured with the ASC sample data (as described in Chapter 2, "Install and Configure Communication Services").

  1. After the Enterprise Sample is installed, the setup script presents the following options (note the addition of the Configure Communication Channels option):

    2. Welcome to the Sun Java System Portal Server

    Enterprise Sample Installer

    Please select one of the following options:

    1) Configure Communication Channels

    2) Uninstall Enterprise Sample

    3) Quit

  2. To configure communication channels, select option 1.
  3. Provide Messaging and Calendar Privileges information or accept the default values:

    4. Messaging and Calendar Privileges
    ---------------------------------

    The installer has detected that the organization, adventuresportscafe.com, has not been granted Messaging and Calendar privileges.

    The User Managment Utility (commadmin) is used to grant privileges,

    please specify the following settings.

    Directory server host : company22.example.com

    Directory server port : 389

    Identity server host : company22.example.com

    Identity server port : 80

    Organization naming attribute : o

    User naming attribute : uid

    People container : ou=People

    Role naming attribute : cn

    Accept defaults? [y]

    Sample portal organization name : adventuresportscafe.com

    Messaging server host : company22.example.com

    User management utility admin : admin

    User management utility admin domain : example.com

    Accept defaults? [y]

    What is the User management utility admin password? Again?

At this point, the setup script grants mail and calendar privileges to the Enterprise Sample organization, adventuresportscafe.com. The script displays the following:

Enabling Mail and Calendar privileges for organization

OK

OK

Note

If you have previously run the Communication Channels Configuration option, then the script output states that privileges have been detected. For example:

Messaging and Calendar Privileges
---------------------------------

The installer has detected that the organization, adventuresportscafe.com, has been granted Messaging and Calendar privileges. Please verify that the following information is correct.

  1. Provide General Questions information or accept the default values:

    2. General Questions
    -----------------

    What is the Identity Server administrative password? Again?

    What is the Directory Manager password? Again?

    What is the Web Container administrative password? Again?

  2. Provide Messaging Server information or accept default values

    3. Messaging Server Settings

    -------------------------

    Server host : company22.example.com

    Server client port : 81

    Server imap port : 143

    Server smtp port : 25

    Accept defaults? [y]

  3. Provide Address Book information or accept the default values:

    4. Address Book Settings
    ----------------------

    Admin uid :

    uid=msg-admin-company22.example.com-20040521153152Z, ou=People,

    o=company22.example.com,dc=example,dc=com

    Search base : o=pab

    User search base : o=adventuresportscafe.com,dc=example,dc=com

    Accept defaults? [y]

  4. Provide Calendar Server information or accept the default values:

    5. Calendar Settings
    -----------------

    Server host : company22.example.com

    Server client port : 82

    Server protocol : http

    Accept defaults? [y]

  5. Provide Instant Messaging information or accept the default values:

    6. Instant Messaging Settings
    --------------------------

    Server host : company22.example.com

    Server port : 49999

    Multiplexor host : company22.example.com

    Multiplexor port : 49909

    Codebase : http://company22.example.com:80/im

  6. Answer y to start the configuration:

    7. Start configuration? [y]

When the Enterprise Sample installation is finished, the setup script displays instructions for accessing the Welcome Page for the Enterprise Sample. For details, see Access the Enterprise Sample Welcome Page.

Uninstall the Enterprise Sample

To uninstall the Enterprise Sample:

  1. Run the setup program:

    2. ./setup

    Please select one of the following options:

    1) Configure Communication Channels

    2) Uninstall Enterprise Sample

    3) Quit

  2. To uninstall the Enterprise Sample, select option 2.

    Note

    Uninstalling the Enterprise Sample does not remove the adventuresportscafe.com organization from the Directory Server if you have compliance deletion enabled (found in the Identity Console Administration Service). The entries are marked deleted but not actually removed from the directory and cannot be recreated.

  3. Provide the requested information:

    4. Please specify the organization to remove?

    [adventuresportscafe.com]

    What is the Identity Server administrative password? Again?

    What is the Directory Manager password? Again?

    What is the Web Container administrative password? Again?

  4. Answer y to remove the Enterprise Sample.
  5. Restart the web container.

Access the Enterprise Sample Welcome Page

To access the Enterprise Sample Welcome page:

  1. If you configured any of the communication channels, restart the web container.
  2. Launch a Web browser.
  3. Enter the URI for the Enterprise Sample welcome page in the form:

    4. http://host/portal_deployment_URI/welcome

    For example:

    http://company22.example.com/portal/welcome

The Welcome page provides a link to the Adventure Sports Café anonymous page.



Previous      Contents      Index      Next     

Part No: 817-7621-10 .   Copyright 2004 Sun Microsystems, Inc. All rights reserved.