Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java Enterprise System 2004Q2 Installation Guide 

Chapter 7
Postinstallation Configuration and Startup

This chapter provides instructions for configuring the component products that have been installed and verifying that they are operational.

This chapter has the following sections:

Overview of Postinstallation Configuration

When the Java Enterprise System installer finishes installation, several component products require that you perform additional configuration tasks. The extent of the tasks depends on what configuration type you selected (Configure Now or Configure Later), and whether or not your component products will be configured with the Sun Cluster software.

A number of component products come with configuration tools for completing a Configure Later installation. After running the configuration tools, you can make any additional changes by following the instructions in this guide and in the product documentation for each component product.

The following topics are addressed in this section:

Configure Now Mode

When you select the Configure Now mode, you are asked to specify configuration values for component products during installation. At the end of the installation process, a summary report containing the values that were set during installation is available. You can view this file from the directory where it is saved, in /var/sadm/install/logs on Solaris and in /var/opt/sun/install/logs on Linux.

Note

The Java Enterprise System installer supports configuration of all component products except the Calendar Server, Instant Messaging, Messaging Server, and Sun Cluster components. Configuration for these products can only be done after installation.

Configure Later Mode

When you select the Configure Later mode during installation, the Java Enterprise System installer places the component product package files in their respective directories. No parameter setting is done, and most component products are not operational because runtime services are not available.

You must do additional configuration for most of the component products before the Java Enterprise System environment is operational.

Verification of Installation and Configuration

Even if you have already done much of the configuration, check the sections in this chapter to see whether any additional configuration is required for your component products. If no additional configuration is required, proceed to Starting and Stopping Component Products to verify that the component products are operational.

Sun Cluster Configuration Tasks

The following component products can be specified for use with the Sun Cluster software:

For a description of a Sun Cluster installation sequence, refer to High Availability Using Sun Cluster Software.

The Java Enterprise System installer performs a simple pkgadd installation of Sun Cluster packages. You can use the pkginfo command to verify that the Sun Cluster packages have been installed. A list of the packages associated with the Sun Cluster component can be found in Sun Cluster Software and Agents.

During installation, the Java Enterprise System installer installs the Sun Cluster packages and sets up the /usr/cluster/bin directory. No configuration is done. After package installation, you must establish the cluster, but before establishing the cluster, the following component products must be configured:

    To Configure Sun Cluster Software After Installation

Configure and start the cluster, as described in the Sun Cluster Software Installation Guide for Solaris OS (http://docs.sun.com/doc/817-4229). When these instructions direct you to run the scinstall program, use the copy located at /usr/cluster/bin/scinstall.

During this phase, the scinstall utility verifies the Sun Cluster packages. If packages are missing, an error message indicates that packages on the CD are not available. If this happens, you must verify that the correct Sun Cluster packages were installed by the Java Enterprise System installer.

    To Configure Data Services for the Component Products

After the cluster has been configured, you are ready to configure data services.

Note

You must establish the cluster and install both the Sun Cluster Core and Sun Cluster Agents for Sun Java System software components before you can configure data services for the component products.

Instructions on configuring data services for component products is available at the following locations:

Until you have fully configured the data services and all the supporting layers (volume manager, cluster file system, resource group information), Sun Cluster installation for Java Enterprise System is not complete.

Configuring Component Products

This section addresses the following topics:

Path Names Used in Configuration Procedures

The default installation locations of Java Enterprise System component products are different on the Solaris operating system and the Linux operating system. Due to this difference, the procedures in the following sections use placeholders to repesent these locations.

Administration Server Configuration

    To Configure Administration Server After a Configure Now Installation

Note

Before you can configure Administration Server, Directory Server must already be configured. Refer to To Configure Directory Server After a Configure Later Installation.

After a Configure Now configuration installation, Administration Server is fully configured and ready to use, with one exception. If Administration Server will be used with the Sun Cluster software, refer to Sun Cluster Configuration Tasks for instructions on how to complete this configuration.

    To Configure Administration Server After a Configure Later Installation

After a Configure Later configuration installation, the packages are installed and you are ready to perform the configuration tasks for the Administration Server component product.

Note

If Administration Server was installed with Identity Server, most of the configuration in Step 3 was completed during installation.

  1. Start the configuration utility. For example, on Solaris:

    2. /usr/sbin/mpsadmserver configure

    Follow the instructions on each screen.

  2. Ensure that access permissions for the files under <server root>/alias have been set to prevent access by all user accounts other than those of the servers installed there.
  3. Verify the common server settings as described in Common Server Settings and the Administration Server settings as described in the tables in Administration Server Configuration.

    4. Update the settings as needed. Information on these setting can be found in the Sun Java System Administration Server 5 2004Q2 Administration Guide, http://docs.sun.com/doc/817-5215.

  4. If applicable, configure Administration Server for use with the Sun Cluster software. Refer to Sun Cluster Configuration Tasks.
  5. To verify configuration, proceed to Starting and Stopping Administration Server.

Application Server Configuration

    To Configure Application Server After a Configure Now Installation

After a Configure Now configuration installation, Application Server is fully configured and ready to use, with one exception. If Application Server will be used with the Sun Cluster software, refer to Sun Cluster Configuration Tasks for instructions on how to complete this configuration.

To verify configuration, proceed to Starting and Stopping Application Server.

    To Configure Application Server After a Configure Later Installation

After a Configure Later configuration installation, the Application Server packages are installed and you are ready to begin configuration.

  1. Add app_svr_base/bin to your PATH environment variable. To verify, type the following:

    2. which asadmin

  2. Add app_svr_base/man to your MANPATH environment variable. To verify this is working, type the following:

    3. man asadmin

    The asadmin man page should be displayed.

  3. Create an initial domain for Application Server using the following asadmin command:

    4. asadmin create-domain --path domain_path --sysuser sys_user --passwordfile file_name --adminport port_number --adminuser admin_user --adminpassword password domain_name asadmin

    For example:

    asadmin create-domain --adminport 4848 --adminuser MyAdmin --adminpassword MyPassword MyDomain

    For additional information on administering the Application Server, refer to the Sun ONE Application Server 7 Administrator’s Guide, http://docs.sun.com/doc/817-3652-10.

  4. If applicable, configure Application Server for use with the Sun Cluster software. Refer to Sun Cluster Configuration Tasks.
  5. To verify configuration, proceed to Starting and Stopping Application Server.

Calendar Server Configuration

    To Configure Calendar Server After Installation

The Calendar Server component product cannot be configured by the Java Enterprise System installer.

  1. Configure Directory Server for communications services (Calendar Server, Messaging Server and the User Management Utility) by running the comm_dssetup.pl script.

    2. Note

    Skip this step if you have already run the comm_dssetup.pl script on the same Directory Server during configuration of Messaging Server or the User Management Utility.

    1. Verify that Directory Server is running. Refer to Starting and Stopping Directory Server if needed.
    2. If Directory Server is on the same system as Calendar Server, run the comm_dssetup.pl script:

      3. cd cal_svr_base/cal/sbin
      perl comm_dssetup.pl

      Otherwise, copy the comm_dssetup.pl script and its related files to the Directory Server system. To do so, copy the file cal_svr_base/cal/install/dssetup.zip to the Directory Server system. Then, unzip the file and run the comm_dssetup.pl script.

    3. When prompted by the running script, select Schema 2 Native Mode as the schema type unless you need to retain compatibility with previous versions of Calendar Server, Messaging Server, or custom applications. For more information about making the appropriate choice, see Chapter 2, “Configuring Your LDAP Directory,” in the Sun Java System Calendar Server 6 2004Q2 Administration Guide (http://docs.sun.com/doc/817-5697).
  2. 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:

    3. 192.18.99.999   mycomputer.company.com   loghost

  3. Perform this step only if your installation includes Identity Server and LDAP Schema 2 and if this step was not done during Messaging Server configuration: Configure for Calendar Server provisioning by running the User Management Utility, cs_umu_base/sbin/config-iscli.

    4. Note

    Before you run config-iscli, Identity Server must be installed and configured.

    Instructions for running the utility are contained in the Sun Java System Communications Services 6 2004Q2 User Management Utility Administration Guide, http://docs.sun.com/doc/817-5703.

  4. Configure Calendar Server by running the Calendar Server configuration program, cal_svr_base/cal/sbin/csconfigurator.sh.

    5. For information on configuring Calendar Server, refer to the Sun Java System Calendar Server 6 2004Q2 Administration Guide, http://docs.sun.com/doc/817-5697.

  5. If applicable, configure Calendar Server for use with the Sun Cluster software. Refer to Sun Cluster Configuration Tasks for information on completing this configuration.
  6. To verify configuration, proceed to Starting and Stopping Calendar Server.

Communications Express Configuration

    To Configure Communications Express After Installation

The Communications Express component product cannot be configured by the Java Enterprise System installer.

Instructions for using the Communication Express configuration program, cm_xprs_base/sbin/config-uwc, are contained in the "Installing and Configuring Communications Express" chapter in the Sun Java System Communications Express 6 2004Q2 Administration Guide, http://docs.sun.com/doc/817-5416.

Directory Server Configuration

    To Configure Directory Server After a Configure Now Installation
  1. Run the idsktune command to obtain a list of recommendations for using Directory Server.
  2. If applicable, configure Directory Server for use with the Sun Cluster software. Refer to Sun Cluster Configuration Tasks.
  3. To verify configuration, proceed to Starting and Stopping Directory Server and Starting and Stopping Administration Server.
    To Configure Directory Server After a Configure Later Installation

After a Configure Later configuration installation, you are ready to perform the configuration tasks for the Directory Server component product. Create an initial configuration for Directory Server by performing the following steps.

  1. Start the configuration utility. For example:

    2. directoryserver -u 5.2 configure

    Follow the instructions on each screen.

  2. (Recommended) Update the system configuration to enable core file generation. For example:

    3. coreadm -e proc-setid

    If you have installed Directory Server to run as a user other than super user, Directory Server may not be able to generate a core file during a crash. It is strongly recommended that you plan enough space for core files, and that you allow Directory Server to generate them during a crash.

  3. (Optional) Many command-line scripts written in Perl can read the bind password interactively (-w - option). To enable this functionality:
    1. Install the Term::ReadKey Perl module, available separately from CPAN (http://cpan.org).
    2. Edit each Perl script to read the bind password interactively by uncommenting the appropriate lines.

      3. All other Perl script functionality remains available without the Term::ReadKey module.

  4. Verify the common server settings as described in Common Server Settings and the Directory Server settings as described in the tables in Directory Server Configuration.

    5. Update the settings as needed.

  5. Run the idsktune command to obtain a list of recommendations for using Directory Server.
  6. If applicable, configure Directory Server for use with the Sun Cluster software. Refer to Sun Cluster Configuration Tasks.
  7. To verify configuration, proceed to Starting and Stopping Directory Server and Starting and Stopping Administration Server.

Directory Proxy Server Configuration

    To Configure the Directory Proxy Server

Perform this procedure when you selected the Configure Later option during installation.

  1. Run the idsktune command to obtain a list of recommendations for using Java Enterprise System.
  2. Configure the Directory Proxy Server instance using the quickstart.tcl script. For example:

    3. # cd /usr/sadm/mps/admin/v5.2/dps
    # /usr/sadm/mps/admin/v5.2/bin/tcl8.2/tclsh quickstart.tcl -cid cid_path -listen port number -password password -serverroot serverroot_path -userID dn

    The arguments of the quickstart.tcl script are described in the following table:

    Table 7-1  Arguments in the quickstart.tcl script

    Argument

    Description

    -cid

    The fully qualified path such that the program can assert that following directory exists:

    cid_path/bin/dps/install/script

    -serverroot

    A fully qualified path to an installed, and configured, Administration Server. The script will validate that the following files exists:

    serverroot_path/admin-serv/config/adm.conf
    serverroot_path/admin-serv/config/jvm12.conf

    -listen

    Directory Proxy Server port.

    -userID

    User distinguished name of the Administration Server administrator.

    -password

    Password of the Administration Server administrator.

  3. Verify the common server settings described in Common Server Settings.

    4. Update the common server settings for Directory Proxy Server as indicated in Table 3-2.

  4. Verify the configuration as described in Directory Proxy Server Configuration.
  5. Start the Directory Proxy Server as described in Starting and Stopping Directory Proxy Server.

Identity Server Configuration

    To Configure Identity Server After a Configure Now Installation

Although you can start Identity Server and log into its console immediately after running the Java Enterprise System installer, you cannot perform basic user management operations until you complete some final configuration steps. These steps differ depending on whether or not Identity Server is using a Directory Server instance that is already provisioned with user data.

The next sections explain what to do in the following cases:

When Directory Server Is Provisioned With User Data

When Directory Server is already provisioned with user data, refer to “Configuring a Provisioned Directory Server” in the Sun Java System Identity Server 2004Q2 Migration Guide, http://docs.sun.com/doc/817-5708, for a description of the final configuration steps.

To verify configuration, proceed to Starting and Stopping Identity Server.

When Directory Server Is Not Yet Provisioned With User Data

When Directory Server is not yet provisioned with user data, perform the steps in the following two procedures:

    To Enable the Referential Integrity Plug-in

When the referential integrity plug-in is enabled, it performs integrity updates on specified attributes immediately after a delete or rename operation. This ensures that relationships between related entries are maintained throughout the database.

  1. In Directory Server Console, click Configuration.
  2. In the navigation tree, double-click Plug-ins to expand the list of Plug-ins.
  3. In the Plug-ins list, click Referential integrity postoperation.
  4. In the properties area, check the Enable plug-in box.
  5. Click Save.
  6. Restart Directory Server to enable the plug-in.
    To Add Identity Server Indexes

Database indexes enhance the search performance in Directory Server.

  1. In Directory Server Console, click Configuration.
  2. Add the nsroledn index.
    1. In the navigation tree, double-click the Data icon, then click the root suffix that contains the directory entries you want to use in Identity Server.
    2. Click the Indexes tab.
    3. Under Additional Indexes, for the nsroledn attribute, check the following checkboxes: Equality, Presence, and Substring.
    4. Click Save.
    5. In the Indexes window, after the index is successfully created, click Close.
  3. Add the memberof index.
    1. In the Indexes tab, click Add attribute...
    2. In the Select Attributes window, select the attribute memberof, then click OK.
    3. In the Indexes tab, for the memberof attribute, check the following checkboxes: Equality and Presence.
    4. Click Save.
    5. In the Indexes window, after the index is successfully created, click Close.
  4. Add the iplanet-am-static-group index.
    1. In the Indexes tab, click Add attribute...
    2. In the Select Attributes window, select the attribute iplanet-am-static-group, and then click OK.
    3. In the Indexes tab, for the iplanet-am-static-group attribute, check the following checkbox: Equality.
    4. Click Save.
    5. In the Indexes window, after the index is successfully created, click Close.
  5. Add the iplanet-am-modifiable-by index.
    1. In the Indexes tab, click Add attribute...
    2. In the Select Attributes window, select the attribute iplanet-am-modifiable-by, and then click OK.
    3. In the Indexes tab, for the iplanet-am-modifiable-by attribute, check the following checkbox: Equality.
    4. Click Save.
    5. In the Indexes window, after the index is successfully created, click Close.
  6. Add the iplanet-am-user-federation-info-key index.
    1. In the Indexes tab, click Add attribute...
    2. In the Select Attributes window, select the attribute iplanet-am-user-federation-info-key, then click OK.
    3. In the Indexes tab, for the iplanet-am-user-federation-info-key attribute, check the following checkbox: Equality.
    4. Click Save.
    5. In the Indexes window, after the index is successfully created, click Close.
  7. Restart Directory Server.
  8. To verify configuration, proceed to Starting and Stopping Identity Server.
    To Configure Identity Server After a Configure Later Installation

After a Configure Later installation, you configure Identity Server using the Identity Server configuration program, id_svr_base/bin/amconfig. Instructions for using this program are contained in the Sun Java System Identity Server 2004Q2 Administration Guide, http://docs.sun.com/doc/817-5709.

Instant Messaging Configuration

    To Configure Instant Messaging After Installation

The Instant Messaging component product cannot be configured by the Java Enterprise System installer.

Instructions for using the Instant Messaging configurator, inst_msg_base/configure, are contained in the “Configuring Sun Java System Instant Messenger” chapter in the Sun Java System Instant Messaging 6 2004Q2 Installation Guide, http://docs.sun.com/doc/817-5934.

To verify configuration, proceed to Starting and Stopping Instant Messaging.

Message Queue Configuration

    To Configure Message Queue After Installation

The Message Queue component product requires no additional configuration. However, a common optional task is to configure Message Queue for automatic startup. To perform this task, you need to become superuser and edit properties in the imqbrokerd.conf configuration file (in /etc/imq on Solaris and in /etc/opt/imq on Linux). The properties to edit are:

Additional configuration for Message Queue is discussed in the Sun Java System Message Queue 3.5 SP1 Administration Guide, http://docs.sun.com/doc/817-6024. For example, you may want to change the default administration password.

To verify configuration, proceed to Starting Message Queue.

Messaging Server Configuration

    To Configure Messaging Server After Installation

The Messaging Server component product cannot be configured by the Java Enterprise System installer.

  1. Configure Directory Server for communications services (Calendar Server, Messaging Server and the User Management Utility) by running the comm_dssetup.pl script.

    2. Note

    Skip this step if you have already run the comm_dssetup.pl script on the same Directory Server during configuration of Calendar Server or the User Management Utility.

    1. Verify that Directory Server is running. Refer to Starting and Stopping Directory Server if needed.
    2. If Directory Server is on the same system as Messaging Server, run the comm_dssetup.pl script:

      3. cd msg_svr_base/lib
      perl comm_dssetup.pl

      Otherwise, copy the comm_dssetup.pl script and its related files to the Directory Server system. To do so, copy the file msg_svr_base/install/dssetup.zip to the Directory Server system. Then, unzip the file and run the comm_dssetup.pl script.

    3. When prompted by the running script, select Schema 2 Native Mode as the schema type unless you need to retain compatibility with previous versions of Calendar Server, Messaging Server, or custom applications. For more information about making the appropriate choice, see Chapter 7, “Understanding Messaging Server Schema and Provisioning Options,” in the Sun Java System Messaging Server 6 2004Q2 Deployment Planning Guide (http://docs.sun.com/doc/817-6440).
  2. 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:

    3. 192.18.99.1   mycomputer.company.com   loghost

  3. Perform this step only if your installation includes Identity Server and LDAP Schema 2 and if this step was not done during Calendar Server configuration: Configure for Messaging Server provisioning by running the User Management Utility, cm_umu_base/sbin/config-iscli. Instructions are contained in the Sun Java System Communications Services 6 2004Q2 User Management Utility Administration Guide, http://docs.sun.com/doc/817-5703.
  4. Configure Messaging Server by running the Messaging Server configuration program, msg_svr_base/sbin/configure.

    5. For information on configuring Messaging Server, refer to the Sun Java System Messaging Server 6 2004Q2 Administration Guide (http://docs.sun.com/doc/817-6266).

  5. If applicable, configure for use with the Sun Cluster software. Refer to Sun Cluster Configuration Tasks.
  6. To verify configuration, proceed to Starting and Stopping Messaging Server.

Portal Server Configuration

    To Configure Portal Server After a Configure Now Installation on Application Server or Web Server

If you are using Application Server or Web Server as the web container for Portal Server, you must apply changes to the instance. Use the instructions in the “Portal Server Post-Installation Tasks” section in Chapter 2 of the Sun Java System Portal Server 6 2004Q2 Administration Guide, http://docs.sun.com/doc/817-5324.

To verify configuration, proceed to Starting and Stopping Portal Server.

    To Configure Portal Server After a Configure Now Installation on BEA WebLogic Server or IBM WebSphere Application Server

If you are using BEA WebLogic Server or IBM WebSphere Application Server as the web container for Portal Server, follow these steps:

  1. Stop all web container instances, including the admin instance and, in the case of BEA WebLogic Server, managed server instances.
  2. Start the web container’s admin server instance. If you have installed on a BEA WebLogic Server managed instance, start the managed instance too.
  3. Deploy Portal Server by running the deploy command:

    4. cd prtl_svr_base/bin
    ./deploy

    When prompted, choose the default for the deploy URI and server instance name, and enter the web container admin password.

  4. Deploy the Portlet samples (that is, the portletsamples.war file):

    5. setenv DEPLOY_ADMIN_PASSWORD web-container-admin-password
    setenv IDSAME_ADMIN_PASSWORD     Identity-Server-admin-password
    cd     prtl_svr_base/lib
    ./postinstall_PortletSamples

    When prompted, enter the web container admin password and the Identity Server admin password.

  5. Restart the web container instance into which Portal Server was deployed. See your web container documentation for instructions on starting the web container instance.

    6. Note

    In the case of installation on a BEA WebLogic Server managed server, the .war files do not get deployed. Deploy the .war files using the BEA WebLogic Server administration console.

To verify configuration, proceed to Starting and Stopping Portal Server.

    To Configure Portal Server After a Configure Later Installation on Application Server or Web Server

The Portal Server component product provides a common configurator that can be used to configure all Portal Server subcomponents and Portal Server Secure Remote Access.

  1. Create a runtime configuration for Portal Server by running the Portal Server configurator, prtl_svr_base/lib/configurator.

    2. Instructions for running the configurator as well as descriptions of the settings used by the configurator are contained in the “Minimal Installation Configuration” section in Chapter 2 of the Sun Java System Portal Server 6 2004Q2 Administration Guide, http://docs.sun.com/doc/817-5324.

  2. Apply changes to the instance. Use the instructions in the “Portal Server Post-Installation Tasks” section in Chapter 2 of the Sun Java System Portal Server 6 2004Q2 Administration Guide, http://docs.sun.com/doc/817-5324.

To verify configuration, proceed to Starting and Stopping Portal Server and Starting and Stopping Portal Server Secure Remote Access.

    To Configure Portal Server After a Configure Later Installation on BEA WebLogic Server or IBM WebSphere Application Server

The Portal Server component product provides a common configurator that can be used to configure all Portal Server subcomponents and Portal Server Secure Remote Access.

  1. Create a runtime configuration for Portal Server by running the Portal Server configurator, prtl_svr_base/lib/configurator.

    2. Instructions for running the configurator as well as descriptions of the settings used by the configurator are contained in the “Minimal Installation Configuration” section in Chapter 2 of the Sun Java System Portal Server 6 2004Q2 Administration Guide, http://docs.sun.com/doc/817-5324.

  2. Stop all web container instances, including the admin instance and, in the case of BEA WebLogic Server, managed server instances.
  3. Start the web container’s admin server instance. If you have installed on a BEA WebLogic Server managed instance, start the managed instance too.
  4. Deploy Portal Server by running the deploy command:

    5. cd prtl_svr_base/bin
    ./deploy

    When prompted, choose the default for the deploy URI and server instance name, and enter the web container admin password.

  5. Deploy the Portlet samples (that is, the portletsamples.war file):

    6. setenv DEPLOY_ADMIN_PASSWORD web-container-admin-password
    setenv IDSAME_ADMIN_PASSWORD     Identity-Server-admin-password
    cd     prtl_svr_base/lib
    ./postinstall_PortletSamples

    When prompted, enter the web container admin password and the Identity Server admin password.

  6. Restart the web container instance into which Portal Server was deployed. See your web container documentation for instructions on starting the web container instance.

    7. Note

    In the case of installation on a BEA WebLogic Server managed server, the .war files do not get deployed. Deploy the .war files using the BEA WebLogic Server administration console.

To verify configuration, proceed to Starting and Stopping Portal Server and Starting and Stopping Portal Server Secure Remote Access.

Sun Remote Services Net Connect Configuration

    To Configure Sun Remote Services Net Connect

The Sun Remote Services Net Connect component product cannot be configured by the Java Enterprise System installer.

Instructions for activating and configuring Sun Remote Services Net Connect are contained in the “Activation” chapter of the Sun Remote Services Net Connect Installation and Activation Guide, http://docs.sun.com/doc/916-1586.

To verify configuration, proceed to Starting and Stopping Sun Remote Services Net Connect.

Web Server Configuration

    To Configure Web Server After a Configure Now Installation

After a Configure Now configuration installation, Web Server is fully configured and ready to use, with one exception. If Web Server will be used with the Sun Cluster software, refer to Sun Cluster Configuration Tasks for instructions on how to complete this configuration.

To verify configuration, proceed to Starting and Stopping Web Server.

    To Configure Web Server After a Configure Later Installation

After a Configure Later configuration installation, you are ready to perform the configuration tasks for the Web Server component product.

  1. Configure Web Server by running the Web Server configuration program, web_svr_base/setup/configure. The configuration program creates a runtime configuration, including an admin server and a default instance.
  2. Verify the common server settings as described in Common Server Settings and the Web Server settings as described in the tables in Web Server Configuration.

    3. Update the settings as needed. Additional information on these settings can be found in the Sun ONE Web Server 6.1 Installation and Migration Guide, http://docs.sun.com/doc/817-6245-10.

  3. If applicable, configure for use with the Sun Cluster software. Refer to Sun Cluster Configuration Tasks.

To verify configuration, proceed to Starting and Stopping Web Server.

Starting and Stopping Component Products

This section provides instructions for starting and stopping the Java Enterprise System component products, including a suggested sequence for bringing up the entire Java Enterprise System. You can use the procedures in this section to verify that component products are operational.

This section contains the following subsections:

Startup Sequence for Java Enterprise System

To start Java Enterprise System, you start the component products one after another, in a specific sequence. You start with the basic services provided by Directory Server and your web container (Web Server or an application server). (Java Enterprise System creates runnable instances of these services during installation.) Since Portal Server and Identity Server run inside the web container, they start when you start the web container.

The general sequence for bringing up the entire Java Enterprise System component set is shown in the following table. The left column lists the order in which you should perform the startup, the middle column describes the task, and the right column lists the location of the instructions for performing the task.

Table 7-2  Preferred Startup Sequence for Java Enterprise System 

Order

Task

Location of Instructions

1

Start your directory server.

 

A. Start Directory Server.

To Start Directory Server

B. Start Administration Server.

To Start Administration Server

C. Start Server Console.

To Start Server Console

2

Start your chosen web container. Identity Server and Portal Server are started if they are installed. If installed, Mobile Access starts when Portal Server starts.

 

Start Application Server (also starts Message Queue).

To Start Application Server

To Verify Identity Server and Portal Server on Application Server

Start BEA Weblogic Server (only with Portal Server).

To Verify Identity Server and Portal Server on BEA WebLogic

Start IBM WebSphere Server (only with Portal Server).

To Verify Identity Server and Portal Server on IBM WebSphere

Start Web Server.

To Start Web Server

To Verify Identity Server and Portal Server on Web Server

3

Start Portal Server Secure Remote Access.

To Start Portal Server Secure Remote Access

4

Start Instant Messaging.

To Start Instant Messaging

5

Start Messaging Server.

To Start Messaging Server

6

Start Calendar Server.

To Start Calendar Server

7

Start Directory Proxy Server.

To Start Directory Proxy Server

To shut down the entire component set, reverse the sequence.

Starting and Stopping Administration Server

To verify Administration Server, you start the Administration Server and the Console Server. Administration Server depends on Directory Server.

    To Start Administration Server
  1. Enter the following on Solaris:

    2. /usr/sbin/mpsadmserver start

  2. Verify that the Administration Server processes are running:

    3. /usr/bin/ps -ef | grep admin-serv/config

    ./uxwdog -e -d /var/opt/mps/serverroot/admin-serv/config

    ns-httpd -d /var/opt/mps/serverroot/admin-serv/config

    ns-httpd -d /var/opt/mps/serverroot/admin-serv/config

    ns-httpd -d /var/opt/mps/serverroot/admin-serv/config

    ns-httpd -d /var/opt/mps/serverroot/admin-serv/config

    To Stop Administration Server
  1. Enter the following on Solaris:

    2. /usr/sbin/mpsadmserver stop

  2. Verify that Administration Server is no longer running:

    3. /usr/bin/ps -ef | grep admin-serv/config

    To Start Server Console
  1. If necessary, configure the $DISPLAY variable to display the Console Server on your machine.
  2. Verify that the Administration Server processes are running:

    3. /usr/bin/ps -ef | grep admin-serv/config

    ./uxwdog -e -d /var/opt/mps/serverroot/admin-serv/config

    ns-httpd -d /var/opt/mps/serverroot/admin-serv/config

    ns-httpd -d /var/opt/mps/serverroot/admin-serv/config

    ns-httpd -d /var/opt/mps/serverroot/admin-serv/config

    ns-httpd -d /var/opt/mps/serverroot/admin-serv/config

  3. Enter the following on Solaris:

    4. /usr/sbin/mpsadmserver startconsole

  4. Verify that the Server Console process is running:

    5. /usr/bin/ps -ef | grep console

    /usr/lib/saf/ttymon -g -h -p mycomputer console login: -T sun -d /dev/console -1

    To Stop Server Console
  1. To stop Server Console, exit the graphical interface.
  2. Verify that Console Server is no longer running:

    3. /usr/bin/ps -ef | grep console

Starting and Stopping Application Server

To verify Application Server, you need to start the Application Server instance, then start the graphical Administration interface and log in. Application Server depends on Message Queue.

    To Start Application Server
  1. Navigate to app_svr_base/bin.
  2. Start individual Application Server instances. For example:

    3. ./asadmin start-domain --domain domain1

    Note

    If you receive a message indicating failure to start, configuration changes might not be applied yet. In this case, run the asadmin reconfig command. For example:

    asadmin reconfig --user admin --password adminadmin --host localhost --port 4848 server1

    Alternatively, you can start all instances in all domains:

    ./asadmin asadmin start-appserv

  3. Verify that the Application Server processes are running:

    4. /usr/bin/ps -ef | grep appservd

    ./appservd-wdog -r /SUNWappserver7 -d /var/opt/SUNWappserver7/domains/domain1/a

    appservd -r /SUNWappserver7 -d /var/opt/SUNWappserver7/domains/domain1/admin-se

    appservd -r /SUNWappserver7 -d /var/opt/SUNWappserver7/domains/domain1/admin-se

    /SUNWappserver7/lib/Cgistub -f /tmp/admin-server-4f378e6f/.cgistub_4816

    /SUNWappserver7/lib/Cgistub -f /tmp/admin-server-4f378e6f/.cgistub_4816

    /SUNWappserver7/lib/Cgistub -f /tmp/admin-server-4f378e6f/.cgistub_4816

    ./appservd-wdog -r /SUNWappserver7 -d /var/opt/SUNWappserver7/domains/domain1/s

    appservd -r /SUNWappserver7 -d /var/opt/SUNWappserver7/domains/domain1/server1/

    appservd -r /SUNWappserver7 -d /var/opt/SUNWappserver7/domains/domain1/server1/

    To Access the Application Server Graphical Interface

In your browser, use the http://hostname.domain:adminport format to access the Application Server Administration interface. For example:

http://mycomputer.example.com:4848

Your login to Application Server confirms successful installation.

    To Stop Application Server
  1. Navigate to app_svr_base/bin.
  2. Stop the Application Serverinstances.

    3. ./asadmin stop-domain --domain domain1

    Alternatively, you can stop all instances in all domains:

    ./asadmin asadmin stop-appserv

  3. Verify that Application Server is no longer running:

    4. /usr/bin/ps -ef | grep appservd

Starting and Stopping Calendar Server

Calendar Server depends on Directory Server.

    To Start Calendar Server
  1. Navigate to cal_svr_base/cal/sbin.
  2. Start Calendar Server.

    3. ./start-cal

  3. Verify that the Calendar Server processes are running:

    4. /usr/bin/ps -ef | grep cal

    /opt/SUNWics5/cal/lib/cshttpd -d 3

    /opt/SUNWics5/cal/lib/enpd -p 57997 -c config/ics.conf

    /opt/SUNWics5/cal/lib/csadmind

    /opt/SUNWics5/cal/lib/csnotifyd

    To Access the Calendar Server Graphical Interface

If you are already provisioned in the LDAP directory that Calendar Server points to, you can log into Calendar Server. In your browser, use the http://hostname.domain[:port] format to access Calendar Server. For example:

http://mycomputer.example.com:89

At initial login, Calendar Server creates a default calendar for you. Your login to Calendar Server confirms successful installation.

    To Stop Calendar Server
  1. Navigate to cal_svr_base/cal/sbin.
  2. Stop Calendar Server.

    3. ./stop-cal

  3. Verify that Calendar Server is no longer running:

    4. /usr/bin/ps -ef | grep cal

Starting and Stopping Directory Server

If Directory Server is part of a cluster, verify that you are working on the active node for the logical host. Directory Server has no dependencies.

    To Start Directory Server
  1. Start Directory Server using one of the following commands on Solaris:
    • If Directory Server 5.2 is the default version:

      • /usr/sbin/directoryserver start

    • If Directory Server 5.2 is not the default version:

      • /usr/sbin/directoryserver -useversion 5.2 start

  2. Verify that the Directory Server process is running:

    3. /usr/bin/ps -ef | grep slapd

    ./ns-slapd -D /var/opt/mps/serverroot/slapd-host1 -i /var/opt/mps/serverroot/slapd-host1

    To Stop Directory Server
  1. Stop Directory Server using one of the following commands on Solaris:
    • If Directory Server 5.2 is the default version:

      • /usr/sbin/directoryserver stop

    • If Directory Server 5.2 is not the default version:

      • /usr/sbin/directoryserver -useversion 5.2 stop

  2. Verify that Directory Server is no longer running:

    3. /usr/bin/ps -ef | grep slapd

Starting and Stopping Directory Proxy Server

Log in as root if the server runs on ports less than 1024. On ports greater than 1024, log in either as root or with the server's administrator account. Directory Proxy Server depends on Administration Server.

    To Start Directory Proxy Server
  1. Navigate to dpxy_svr_base/dps-instance-name (instance-name is usually machine name). For example, the default is:

    2. cd /var/opt/mps/serverroot/dps-host1

  2. Start the Directory Proxy Server process.

    3. ./start-dps

  3. Verify that the Directory Proxy Server process is running:

    4. /usr/bin/ps -ef | grep dps

    ./ldapfwd -t /var/opt/mps/serverroot/dps-or03/etc/tailor.txt

    To Stop Directory Proxy Server
  1. Navigate to dpxy_svr_base/dps-instance-name. For example:

    2. cd /var/opt/mps/serverroot/dps-host1

  2. Stop the Directory Proxy Server process.

    3. ./stop-dps

  3. Verify that Directory Proxy Server is no longer running:

    4. /usr/bin/ps -ef | grep dps

Starting and Stopping Identity Server

To verify Identity Server, you access your specific deployment configurations of Identity Server on the possible web containers:

Identity Server depends on Directory Server and a web container.

This section contains the following procedures:

    To Start Identity Server
  1. Navigate to the id_svr_base/bin directory.
  2. Start the Identity Server processes.

    3. ./amserver start

  3. Start the web container instance.
  4. Verify that the Identity Server processes are running:

    5. /usr/bin/ps -ef | grep SUNWam

    /opt/SUNWam/share/bin/amsecuridd -c 58943

    /opt/SUNWam/share/bin/amunixd -c 58946

    To Verify Identity Server and Portal Server on Application Server
  1. Use the following URL to access the default page:

    2. http://appserver-host:port/amconsole

    The Identity Server login page appears.

  2. Log in.

    3. Your login to Identity Server confirms successful deployment of Identity Server on Application Server. The default administrator account is amadmin.

  3. In a new browser, use the following URL to display the sample Desktop:

    4. http://server:port/portal

    Display of the sample Desktop confirms successful deployment of Portal Server on Application Server.

    To Verify Identity Server and Portal Server on Web Server
  1. Use the following URL to access the default page:

    2. http://webserver-host:port/amconsole

    The Identity Server login page appears.

  2. Log in.

    3. Your login to Identity Server confirms successful deployment of Identity Server on Web Server.

  3. In a new browser, use the following URL to display the sample Desktop:

    4. http://server:port/portal

    Display of the sample Desktop confirms successful deployment of Portal Server on Web Server.

    To Stop Identity Server
  1. Navigate to id_svr_base/bin.
  2. Stop the web container instance.
  3. Stop the Identity Server processes.

    4. ./amserver stop

  4. Verify that the Identity Server processes are no longer running:

    5. /usr/bin/ps -ef | grep SUNWam

Starting and Stopping Instant Messaging

Instant Messaging depends on Identity Server or the Identity Server SDK.

    To Start Instant Messaging
  1. Use either of the following methods:
    • Run the following command:

      • /etc/init.d/sunwiim start

    • Run the imadmin command. For example:

      • inst_msg_base/sbin/imadmin start

  2. Check whether the server is running:

    3. inst_msg_base/sbin/imadmin check

    /../lib/multiplexor -c ./../config/iim.conf

    ...

    /usr/j2se/bin/java -server -Xmx256m -cp ./../classes/imserv.jar:./../classes/im

    Note

    There are many ways to start the Instant Messaging client. Refer to the section called To Invoke Sun Java System Instant Messenger section of Chapter 3, "Managing Instant Messenger" in the Sun Java System Instant Messaging 6 2004Q2 Administration Guide (http://docs.sun.com/doc/817-5936).

    To Stop Instant Messaging
  1. Use either of the following methods:
    • Run the following command:

      • /etc/init.d/sunwiim stop

    • Run the imadmin command. For example:

      • inst_msg_base/sbin/imadmin stop

  2. Verify that the Instant Messaging processes are not running:

    3. inst_msg_base/sbin/imadmin check

Starting Message Queue

    To Start Message Queue
  1. Navigate to the msg_q_base/bin directory.
  2. Start the Message Queue broker.

    3. ./imqbrokerd

  3. Verify that the Message Queue process is running:

    4. /usr/bin/ps -ef | grep imqbrokerd

    bin/sh /bin/imqbrokerd

Starting and Stopping Messaging Server

Messaging Server depends on Directory Server and Administration Server.

    To Start Messaging Server
  1. Navigate to msg_svr_base/sbin.
  2. Start the Messaging Server processes.

    3. ./start-msg

  3. Verify that the Messaging Server processes are running:

    4. /usr/bin/ps -ef | grep SUNWmsgsr

    /opt/SUNWmsgsr/lib/enpd

    /opt/SUNWmsgsr/lib/stored -d

    /opt/SUNWmsgsr/lib/popd -d 5

    /opt/SUNWmsgsr/lib/imapd -d 5 -D 6

    /opt/SUNWmsgsr/lib/mshttpd -d 5 -D 6

    /opt/SUNWmsgsr/lib/dispatcher

    /opt/SUNWmsgsr/lib/job_controller

    /opt/SUNWmsgsr/lib/tcp_lmtp_server

    /opt/SUNWmsgsr/lib/tcp_smtp_server

    /opt/SUNWmsgsr/lib/tcp_smtp_server

    /opt/SUNWmsgsr/lib/imsched

    /opt/SUNWmsgsr/lib/watcher

    Note that the list of processes varies according to the Messaging Server features you have configured use.

    To Access the Messaging Server Graphical Interface

If you are already provisioned in the LDAP directory that Messaging Server points to, you can log into Messaging Server. In your browser, use the http://hostname.domain[:port] format to access Messaging Server.

For example:

http://mycomputer.example.com:80

    To Stop Messaging Server
  1. Navigate to msg_svr_base/sbin.
  2. Stop the Messaging Server processes.

    3. ./stop-msg

  3. Verify that the Messaging Server processes are no longer running:

    4. /usr/bin/ps -ef | grep SUNWmsgsr

    Note that some Messaging Server processes may take several minutes to exit because they wait for their current transactions to complete.

Starting and Stopping Portal Server

The Portal Server startup and shutdown mechanisms are part of the startup and shutdown mechanisms for the web container (either Web Server or an application server). Portal Server depends on Directory Server, Identity Server or the Identity Server SDK, and a web container.

Note

As a part of Portal Server, Mobile Access is not stopped and started on its own. When you start Portal Server or Identity Server, Mobile Access is automatically started.

To verify Portal Server, go to the following sections:

    To Verify Identity Server and Portal Server on BEA WebLogic
  1. Use the following URL to access the default page:

    2. http://beaweblogic-host:port/amconsole

    The Identity Server login page appears.

  2. Log in.

    3. Your login to Identity Server confirms successful deployment of Identity Server on BEA WebLogic.

  3. In a new browser, use the following URL to display the sample Desktop:

    4. http://server:port/portal

    Display of the sample Desktop confirms successful deployment of Portal Server on BEA WebLogic.

    To Verify Identity Server and Portal Server on IBM WebSphere
  1. Use the following URL to access the default page:

    2. http://ibmwebsphere-host:port/amconsole

    The Identity Server login page appears.

  2. Log in.

    3. Your login to Identity Server confirms successful deployment of Identity Server on IBM WebSphere.

  3. In a new browser, use the following URL to display the sample Desktop:

    4. http://ibmwebsphere-host:port/amconsole

    Display of the sample Desktop confirms successful deployment of Portal Server on IBM WebSphere.

Starting and Stopping Portal Server Secure Remote Access

Portal Server Secure Remote Access depends on Portal Server and Identity Server or the Identity Server SDK.

    To Start Portal Server Secure Remote Access
  1. Navigate to /etc/init.d.
  2. Start the Portal Server gateway.

    3. ./gateway start

  3. Verify that the Portal Server Secure Remote Access processes are running:

    4. /usr/bin/ps -ef | grep entsys

    /usr/jdk/entsys-j2se/bin/java -ms64m -mx128m -classpath

    /opt/SUNWam/lib:/opt

    To Stop Portal Server, Secure Remote Access
  1. Navigate to /etc/init.d.
  2. Stop the Portal Server gateway.

    3. ./gateway stop

  3. Verify that the Portal Server Secure Remote Access processes are no longer running:

    4. /usr/bin/ps -ef | grep entsys

Stopping and Rebooting Sun Cluster Software

Although Sun Cluster software is not started and stopped like other component products, the software can be stopped by rebooting into noncluster mode. For instructions, refer to the Sun Cluster System Administration Guide for Solaris OS (http://docs.sun.com/doc/817-4230).

Starting and Stopping Sun Remote Services Net Connect

When you activate Sun Remote Services Net Connect, it starts automatically within three minutes. After 30 minutes, you can begin retrieving reports.

You can verify that Sun Remote Services Net Connect is functioning properly by following the instructions under “Testing the Installation” in Chapter 2 of the Sun Remote Services Net Connect Installation and Activation Guide, http://docs.sun.com/doc/916-1586.

Starting and Stopping Web Server

Web Server has no dependencies.

    To Start Web Server
  1. Navigate to web_svr_base/https-instance-name.
  2. Start the Web Server administration process.

    3. ./start

  3. Navigate to web_svr_base/https-hostname.domain.
  4. Start the Web Server instance.

    5. ./start

  5. Verify that the Web Server processes are running:

    6. /usr/bin/ps -ef | grep SUNWwbsvr

    ./webservd-wdog -r /opt/SUNWwbsvr -d /opt/SUNWwbsvr/https-admserv/config -n http

    ./webservd-wdog -r /opt/SUNWwbsvr -d /opt/SUNWwbsvr/https-host1.example.com

    webservd -r /opt/SUNWwbsvr -d /opt/SUNWwbsvr/https-admserv/config -n https-admserv

    webservd -r /opt/SUNWwbsvr -d /opt/SUNWwbsvr/https-admserv/config -n https-admserv

    webservd -r /opt/SUNWwbsvr -d /opt/SUNWwbsvr/https-host1.example.com/config

    webservd -r /opt/SUNWwbsvr -d /opt/SUNWwbsvr/https-host1.example.com/config

    To Access the Web Server Graphical Interface
  1. In your browser, use the http://hostname.domain:port format to access the Web Server interface. For example:

    2. http://host1.example.com:80

  2. Use the http://hostname.domain:adminport format to access the administration server. For example:

    3. http://host1.example.com:8888

Your login to Web Server confirms successful installation.

    To Stop Web Server
  1. Navigate to web_svr_base/https-instance-name.
  2. Stop the Web Server admin process.

    3. ./stop

  3. Navigate to web_svr_base/https-hostname.domain. For example:
  4. Stop the Web Server instance.

    5. ./stop

  5. Verify that the Web Server processes are no longer running:

    6. ps -ef | grep SUNWwbsvr

Next Steps

If you have completed this chapter, you have completed configuration of your component products and verified that they are functional. The Java Enterprise System installation is now complete.

You can proceed to any of the following:

Entry points for the component product documentation can be found in Table 2 of the Java Enterprise System Documentation Roadmap (http://docs.sun.com/doc/817-5763).



Previous      Contents      Index      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.