C H A P T E R  14

Using Java Studio Enterprise Servers

After installation, you can use the procedures in this chapter to validate correct installation and configuration of your Java Studio Enterprise servers. This chapter describes:


Preparing to Validate Server Installation

This section contains an overview of the general validation process, the suggested server startup sequence and information on how to find port numbers. Perform the procedures in the appropriate platform-specific section to verify that component products are operational on your machine. See TABLE 14-1 for a list of these procedures.

Overview of the Validation Process

(Microsoft Windows) To start and stop a component product server, you must log in as a user who has administrative rights.

(Solaris OS) To start and stop the component product servers, you must have root privileges. If you created a non-root instance of Application Server or Web Server, you can use those instances with the non-root user account that was associated with creating that instance.

The basic process for starting most Java Studio Enterprise servers has three steps:

1. Start the admin server process.

2. Log in to the administrative tool.

Most of the servers have browser-based interfaces to the administrative tool.

(Solaris OS) As long as you know the proper user name and password, you can access these browser-based interfaces as a non-root user.

3. Start your server instance using the administrative interface.

Most of the servers also have command-line interfaces. See the documentation for the component products for additional information.

Sun Java System Application Server 7 Standard Edition, Update 1 and Sun Java System Web Server 6.1, Service Pack 1 can also be started and stopped from the Java Studio Enterprise IDE via their respective plug-ins.

TABLE 14-1 lists the procedures to use for validating your server installation.

TABLE 14-1 Procedures for Validating Java Studio Enterprise Servers

Task

Windows Instructions

Solaris Instructions

Validate Application Server

Validating Application Server Installation

To Start and Validate Application Server as Root

Validate Directory Server

To Validate Directory Server Installation

To Start and Validate Directory Server Installation

Validate Web Server

To Validate Web Server Installation

To Start and Validate Web Server Installation

Validate Identity Server

Validating Identity Server Installation

To Validate Identity Server Installation

Validate Portal Server

To Validate Portal Server Installation

To Validate Portal Server


Suggested Startup Sequence

If you are using only Application Server or Web Server, then there is no startup sequence requirement.

The startup sequence is important when using Identity Server and Portal Server. Identity Server and Portal Server are deployed as web applications running on Web Server. Identity Server and Portal Server also rely on Directory Server. Therefore, before attempting to access either Identity Server or Portal Server, you must start both Directory Server and Web Server. To shut down the servers, reverse the sequence.

Before accessing Identity Server and Portal Server, start the servers in this sequence:

1. Start Directory Server.

Start both the admin server and the server instance.

2. Start Web Server.

Start both the admin server and the server instance.

Finding Port Numbers

To perform the server validation procedures you need to know the port numbers, instance names, and other configuration data for the servers that you installed. You can review the configuration data for each server in the following ways:


Validating Server Installation (Microsoft Windows Systems)

On Microsoft Windows systems, you can start the servers from the Start Menu or the command line. For command line information, please see Appendix C. This section describes using the Start Menu entries for starting and stopping the servers.

Finding Port Numbers

Verify server configuration information such as actual port number assigned or instance name, by reviewing the configuration data used by the installer. See Finding Port Numbers for details on viewing this information.



Note - These instructions assume that you are logged in as a user with administrative privileges.



Validating All Servers

If you installed using Typical Installation or you installed all of the Java Studio Enterprise servers, the quickest way to verify the server installations is to use the Start Menu option to start all the servers and then verify access to the administrative tool for each one. See To Start and Validate All Servers.


procedure icon  To Start and Validate All Servers

1. Choose Start > Programs > Sun Microsystems > Java Studio Enterprise 6 2004Q1 > Start Servers > All Servers.

This starts all the installed servers in the proper order.

2. (Optional) Access the Computer Management Services dialog to verify that the servers started properly by following these steps:

a. Open the Computer Management dialog.

b. Double-click Services and Applications.

c. Double-click Services.

d. Scroll down the list of services to see the following Java Studio Enterprise server entries. Verify that the Status column for each server entry shows the value Started:

3. Access the administrative console for the servers as follows:

a. For Directory Server, follow steps 2-5 of the procedure To Validate Directory Server Installation.

b. For Web Server, follow steps 2-5 of the procedure To Validate Web Server Installation.

c. For Application Server, follow steps 2-3 of the procedure Validating Application Server Installation.

d. For Identity Server, use the procedure Validating Identity Server Installation.

e. For Portal Server, use the procedure To Validate Portal Server Installation.


procedure icon  To Stop All Servers

single-step bulletChoose Start > Programs > Sun Microsystems > Java Studio Enterprise 6 2004Q1 > Stop Servers > All Servers.

Validating Individual Servers

Use the following sections to start and validate individual servers.

Verify server configuration information such as actual port number assigned or instance name, by reviewing the configuration data used by the installer. See Finding Port Numbers for details.

Validating Application Server Installation

If you installed the Java Studio Enterprise IDE, see Chapter 9 for information on confirming your default application server from within the IDE. If you did not install the IDE, follow this procedure.


procedure icon  To Validate Application Server Installation

1. Choose Start > Programs > Sun Microsystems > Java Studio Enterprise 6 2004Q1 > Start Server > Application Server.

This starts the Application Server admin process and the default Application Server instance.

2. Choose Start > Programs > Sun Microsystems > Java Studio Enterprise 6 2004Q1 > Administration Consoles > Application Server.

The Application Server Administration login prompt appears.

3. Type your User Name and Password and Click OK.

User Name is the Administrator User ID that you used on the Configuration page during installation. The Sun ONE Application Server Console appears.

Sun ONE Application Server Console showing server1 node.

4. Click the Server1 node in the left frame and check that the status of the server instance (displayed on the right frame) is running.

Sun ONE Application Server Console showing server1 status. 


Note - Starting Application Server from outside the IDE using the Start Menu entry starts all instances of the application server. Using the IDE to start the server enables you to start a specific instance.




procedure icon  To Validate Directory Server Installation

1. Choose Start > Programs > Sun Microsystems > Java Studio Enterprise 6 2004Q1 > Start Servers > Directory Server.

This starts Directory Server's admin process and Directory Server's server instance.

2. Choose Start > Programs > Sun Microsystems > Java Studio Enterprise 6 2004Q1 > Administration Consoles > Directory Server.

The Sun ONE Server Console Login dialog appears. The User ID and Administration URL display the values used during installation and configuration.

Sun ONE Server Console Login dialog with prepopulated values for User ID and Administration URL, no value for Password. Buttons are OK, Cancel and Help. 

3. Type your Password and Click OK.

This is the password that you used on the Configuration page during installation. The Sun ONE Server Console appears.

Sun ONE Server Console showing installed server tab.Buttons are Edit and Help. 

4. On the Servers and Applications tab, expand your server host node, then expand the Server Group node.

You see an entry for the Administration Server and entry for your server of the form Directory Server (hostname).

Sun ONE Server Console with Server Group node open showing Administration Server and Directory Server instance. 

5. Double-click on the Directory Server node.

The Sun ONE Directory Server Console for your server instance appears.

From this console, you can perform administrative tasks.

Sun ONE Directory Server console for server instance. 

procedure icon  To Validate Web Server Installation

You can start Web Server from the Start Menu or from inside the Java Studio Enterprise IDE. This procedure describes using the Start Menu.

1. Choose Start > Programs > Sun Microsystems > Java Studio Enterprise 6 2004Q1 > Start Servers > Web Server.

This starts the Web Server Administration service.

2. Choose Start > Programs > Sun Microsystems > Java Studio Enterprise 6 2004Q1 > Administration Consoles > Web Server.

The Web Server Administration login prompt appears.

Web Server Administration login prompt with no values for User Name and Password. Buttons are OK and Cancel. 

3. Type your User Name and Password and click OK.

These are the values you provided on the Configuration page during installation. The Sun ONE Web Server Console appears in your browser window.

Sun ONE Web Server Administration Server showing Servers tab. 

4. Select your server instance and click Manage.

The Sun ONE Web Server Manager showing your server instance appears.

Sun ONE Web Server Manager showing server instance status. 

If you see this JavaScript Application popup dialog:

Warning message popup dialog. Button is OK. 

single-step bulletClick OK and use the `Apply button as described to Apply Changes.

5. Confirm that your server instance is running by clicking Server On if your server instance is off.

Validating Identity Server Installation

Use one of these methods to validate the Identity Server is installed and configured correctly:


procedure icon  To Validate Identity Server Using Your Web Browser

To successfully access the Identity Server Admin Console, you must have started Directory Server, Web Server, and Web Server admin server.

1. Type the Identity Server URL in your browser to access the Admin Console.

The URL is of the form http://hostname.domainname:port-number/amconsole. For example, http://host.my.company.com:80/amconsole. The Sun ONE Identity Server Admin Console login dialog appears in the browser window.

Sun ONE Identity Server Console login prompt with no values for User Name and Password. Button is Log In. 

2. Type your User Name and Password and click Log In.

The Sun ONE Identity Server Console appears in your browser window.



Note - Remember User Name is amadmin. Password is the value you used during installation on the installer Configuration page.



Sun ONE Identity Server Console. 

procedure icon  To Access Identity Server Admin Console using the Start Menu.

If you have already started Directory Server and Web Server, then skip to Step 2.

1. Choose Start > Programs > Sun Microsystems > Java Studio Enterprise 6 2004Q1 > Start Servers > Identity Server.

This starts Directory Server and Web Server.

2. Choose Start > Programs > Sun Microsystems > Java Studio Enterprise 6 2004Q1 > Administration Consoles > Identity Server.

The Sun ONE Identity Server Admin Console login dialog appears.

3. Type your User Name and Password and click Log In.

The Identity Server Console appears.

Using Identity Server

Identity Server uses the amldapuser as the bind user to search for users in the directory during authentication. This user by default has read access to the directory. The bind password for this user is prereconfigured by the installer by appending a `1' to the Administrator Password that is used during installation. For example, if you type admin123 as the Administrator Password on the installer's Configuration page, the assigned amldapuser password is admin1231.


procedure icon  To Validate Portal Server Installation

After successfully following all the prior procedures to validate Directory Server, Web Server and Identity Server, perform these additional steps.

1. Log out from Identity Server Console or start a new browser instance.

2. Type the Portal Server URL in your web browser.

The URL is of the form: http://webserverhost.domainname:port-number/portal/dt. For example, http://host1.my.company.com:80/portal/dt.

The Sun ONE Portal Server Desktop page appears in the browser window. Display of the sample Desktop confirms successful deployment of Portal Server on your Web Server instance.

Sun ONE Portal Server Desktop.[ D ] 


Validating Server Installation (Solaris OS)

This section contains procedures for verifying proper installation of the Java Studio Enterprise servers on the Solaris OS.

Finding Port Numbers

Verify server configuration information such as actual port number assigned or instance name, by reviewing the configuration data used by the installer. See Finding Port Numbers.

Validating All Servers (Solaris OS)

If you did a Typical Installation or installed all servers, the quickest way to start and stop all the servers is to use the provided scripts.



Note - To start and stop the servers, you must have superuser privileges. If you created non-root instances of Application Server and Web Server during installation, you can do some activities as non-root, such as starting and stopping the non-root instances.




procedure icon  To Start All Servers

1. Change to the directory containing the scripts. For example, if you accepted the default installation directory, type:

# cd /opt/SUNWjstudio/bin

2. Invoke the start server script.

# ./startservers

If you created non-root instances of Application Server and Web Server during installation, running this script as root does not start the non-root instances. You can start those instances from the IDE or from the command line as the non-root user.

3. Access the administrative console for the servers as follows:

a. For Application Server, follow steps 4-5 of the procedure To Start and Validate Application Server as Root.

b. For Directory Server, follow steps 6-9 of the procedure To Start and Validate Directory Server Installation.

c. For Web Server, follow steps 5-6 of the procedure To Start and Validate Web Server Installation.

d. For Identity Server, use the procedure To Validate Identity Server Installation.

e. For Portal Server, use the procedure To Validate Portal Server.


procedure icon  To Stop All Servers

1. Change to the directory containing the script. For example, if you accepted the default installation directory, type:

# cd /opt/SUNWjstudio/bin

2. Invoke the stop server script.

# ./stopservers

Validating Individual Servers (Solaris OS)

Use the following sections to start and validate individual servers.

Validating Application Server Installation

To verify Application Server, start the server instance, invoke the graphical administration interface and log in. Application Server depends on Message Queue. Starting Application Server automatically starts Message Queue. You can also start Application Server from inside the IDE. See Chapter 9 for details. If you have not yet started the Java Studio Enterprise IDE, see Chapter 8 for information on the IDE setup process, then review the information in Chapter 9.

If you did not install the IDE, follow the procedure To Start and Validate Application Server as Root to validate your Application Server installation.


procedure icon  To Start and Validate Application Server as Root

Perform this procedure when your default domain and application server instance are owned by root. If you created a non-root instance during installation, then log in as the non-root user and start Application Server from the IDE. See Using Sun Java System Application Server for details.

1. Log in as root.

2. Change to the directory containing Application Server executable utilities.

# cd /opt/SUNWappserver/bin

3. Start the Application Server instances. For example:

# ./asadmin start-domain --domain domain1

You see output similar to the following:

Instance domain1:admin-server started
Instance domain1:server1 started
Domain domain1 Started

4. (Optional) Verify that Application Server is running.

# ps -ef | grep appservd

5. Access the Application Server Graphical Interface by typing the URL in your browser.

Use the format http://hostname.domainname:admin-port-number. For example, assume that hostname is host1 and domainname is my.company.com, and the default port number 4848 was assigned by the installer, type:

http://host1.my.company.com:4848


Your login to Application Server confirms successful installation.


procedure icon  To Stop Application Server

1. Log in as root.

2. Change to java-studio-install-dir/AppServer7/bin. For example, type:

# cd /opt/SUNWappserver/bin

3. Stop the Application Server instances.

# ./asadmin stop-domain --domain domain1

You see output similar to the following:

Instance domain1:admin-server stopped
Instance domain1:server1 stopped
Domain domain1 stopped

4. (Optional) Verify that Application Server is no longer running.

# ps -ef | grep appservd


procedure icon  To Start and Validate Directory Server Installation

1. Log in as root.

2. Change to the directory containing the start script for your server instance. The directory name is of the form slapd-hostname, where hostname is the name of the machine. For example, if host1 is your machine name:

# cd /opt/SUNWdirserver/slapd-host1

3. Start Directory Server.

# ./start-slapd

4. Verify that Directory Server is running.

ps -ef | grep slapd

You see output similar to the following:

# root  1297     1  0   Jul 01 ?        2:27 ./ns-slapd -D /opt/SUNWdirserver/slapd-host1 -i /opt/SUNWdirserver/slapd-host1

5. Start the Directory Server Admin Server.

# cd /opt/SUNWdirserver
# ./start-admin

6. Start the Sun ONE Server Console.

# ./startconsole

The Sun ONE Server Console login dialog appears.

Sun ONE Server Console login prompt with no value for Password. Buttons are OK, Cancel and Help. 

7. Type your User ID and Password and click OK.

Your login to Sun ONE Server Console confirms successful installation.

8. (Optional) On the Servers and Applications tab, expand your server host node, then expand the Server Group node.

You see an entry for the Administration Server and an entry for your server of form Directory Server (hostname).

 

9. Double-click on the Directory Server (host-name) node.

The Sun ONE Directory Server for your server instance appears. From this console, you can start, stop, and restart your server instance.

Sun ONE Directory Server console for server instance. 

procedure icon  To Stop Directory Server

1. Log in as root.

2. Change to the directory containing the stop script for your server instance. The directory name is of the form slapd-instancename, where instancename is usually the host name of the machine. For example, if host1 is your machine name. For example:

#cd /opt/SUNWdirserver/slapd-host1

3. Stop Directory Server.

# ./stop-slapd

4. Stop Directory Server admin server.

# ./stop-admin

5. Verify that Directory Server instances are no longer running.

# ps -ef | grep slapd

Validating Web Server Installation

If you installed Web Server, the default Web Server instance belongs to root. If you installed either Identity Server or Portal Server, the root instance of Web Server is configured as the web container running these applications.

If you selected the non-root option during installation (see Product Usage by Non-root User), then the installer created a second Web Server instance belonging to the non-root user. To verify proper installation and configuration, start the Web Server Admin Server and access the Web Server Console from your browser.


procedure icon  To Start and Validate Web Server Installation

1. Become superuser (root).

2. Change to the installation directory for Web Server Admin Server.

# cd /opt/SUNWwbsvr/https-admserv

3. Start the Web Server admin process.

# ./start

4. (Optional) Exit from superuser privileges.

You can access Web Server Admin Console as a non-root user as long as you know the User Name (Administrator User ID) and Password (Administrator Password) that were specified during installation.

5. Type the URL for your Web Server in your browser. Use the http://hostname.domainname:admin-port-number format to access the administration server. For example:

http://host1.my.company.com:8888

The Web Server administration console login prompt displays.

Sun ONE Web Server Admin Login prompt with no values for User Name and Password. 

6. Type your User Name and Password.

Your login to Web Server confirms successful installation. You can also start the instances from the command line.


procedure icon  To Start the Web Server Root Instance From the Command Line

1. Log in as root, if you haven't already done so.

1. Change to the installation directory for Web Server. The directory name is of the form https-hostname.domainname. For example, where host1 is your machine name and my.company.com is the domain name:

# cd /opt/SUNWwbsvr/https-host1.my.company.com

2. Start the Web Server instance.

# ./start

3. Verify that Web Server processes are running.

# ps -ef | grep webservd


procedure icon  To Start the Web Server Non-root Instance From the Command Line

You can also start and stop the non-root Web Server instance from the IDE. See Using Sun Java System Web Server for details.

1. Log in as the non-root user that was specified during installation.

2. Change to the installation directory for the non-root instance of Web Server. The directory name is https-jstudio.

# cd /opt/SUNWwbsvr/https-jstudio

3. Start the Web Server instance.

# ./start

4. Verify that Web Server processes are running.

# ps -ef | grep webservd


procedure icon  To Stop Web Server

1. Log in as root.

2. Change to the installation directory for Web Server Admin Server. For example:

# cd /opt/SUNWwbsvr/https-admserv

3. Stop the Web Server admin process.

# ./stop

4. Change to the installation directory for your Web Server instance. For example:

# cd /opt/SUNWwbsvr/https-hostname.domainname

5. Stop the Web Server instance.

# ./stop

6. Verify that Web Server is no longer running.

# ps -ef | grep webservd

Validating Identity Server Installation

Identity Server is a web application hosted on Web Server. Start the Web Server instance first, see To Start the Web Server Root Instance From the Command Line.

Identity Server also depends on Directory Server. Start Directory Server before starting Identity Server. See To Start and Validate Directory Server Installation.


procedure icon  To Validate Identity Server Installation

1. Verify that Web Server and Directory Server processes are running.

# ps -ef | grep SUNWam
# ps -ef | grep slapd

2. Access Identity Server Console through your web browser by typing Identity Server's URL in your browser to access the console.

The URL is of the format: http://webserverhost:port-number/amconsole. Use the web server HTTP port number. The Identity Server Console Login prompt appears.

Sun ONE Identity Server Console login prompt with no values for User Name and Password. Button is Log In. 

3. Type your User Name and Password to log in.

Your login to Identity Server confirms successful deployment of Identity Server on Web Server. Remember that the User Name for Identity Server is amadmin. The Password (Administrator Password) is the one you used on the Configuration page during installation.


procedure icon  To Validate Portal Server

The Portal Server startup and shutdown mechanisms are part of the startup and shutdown mechanisms for Web Server. Portal Server also depends on Directory Server.

1. Log out from Identity Server Console or start a new browser instance.

2. Verify that Web Server and Directory Server processes are running.

# ps -ef | grep SUNWam
# ps -ef | grep slapd

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

http://webserverhost.domainname:port-number/portal/dt

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

Sun ONE Portal Server desktop.[ D ] 


Finding Additional Documentation

You can find documentation at docs.sun.com. The following tables list some of the available documentation titles. For an explanation of the product names, see Product Names.

Sun Java System Application Server Documentation

TABLE 14-2 lists some examples of the available Application Server documentation.

TABLE 14-2 Application Server Documentation

Book Title

Description

Part Number

Location

Sun ONE Application Server 7 Getting Started Guide

S1AS7 GSG (post-install w/small tutorial)

817-2170-10

http://docs.sun.com/db/doc/817-2170-10

Sun ONE Application Server 7 Standard Edition Installation Guide

Installation Guide for stand-alone Application Server installer

817-2169-10

http://docs.sun.com/db/doc/817-2169-10


Sun Java System Directory Server Documentation

TABLE 14-3 lists some examples of the available Directory Server documentation.

TABLE 14-3 Directory Server Documentation

Book Title

Description

Part Number

Location

Sun ONE Directory Server 5.2 Plug-In API Programming Guide

Demonstrates how to develop DS plug-ins.

816-6702-10

http://docs.sun.com/db/doc/816-6702-10

Sun ONE Directory Server 5.2 Plug-In API Reference

Details the data structures and functions of the DS plug-in API.

816-6701-10

http://docs.sun.com/db/doc/816-6701-10

Sun ONE Directory Server 5.2 Reference Manual

Details configuration parameters, commands, files, error messages, and schema.

816-6699-10

http://docs.sun.com/db/doc/816-6699-10

Sun ONE Directory Server Resource Kit 5.2 Tools Reference

Covers installation and features of DS Resource Kit.

816-6400-10

http://docs.sun.com/db/doc/816-6400-10


Sun Java System Web Server Documentation

TABLE 14-4 lists some examples of the Web Server documentation.

TABLE 14-4 Web Server Documentation

Book Title

Description

Part Number

Location

Sun ONE Web Server 6.1 Getting Started Guide

Recommended for first-time users, includes hands-on exercises that introduce server basics and features.

817-1829-10

http://docs.sun.com/db/doc/817-1829-10

Sun ONE Web Server 6.1 NSAPI Programmer's Guide

Creating custom Netscape Server API plug-in

817-1835-10

http://docs.sun.com/db/doc/817-1835-10

Sun ONE Web Server 6.1 Programmer's Guide

Using programming technologies and API with WS

817-1832-10

http://docs.sun.com/db/doc/817-1832-10

Sun ONE Web Server 6.1 Programmer's Guide to Web Applications

Implementing servlets and JSP technology in WS

817-1833-10

http://docs.sun.com/db/doc/817-1833-10


Sun Java System Identity Server Documentation

TABLE 14-5 lists some examples of the Identity Server documentation.

TABLE 14-5 Identity Server Documentation

Book Title

Description

Part Number

Location

Sun Java System Identity Server 6.1 documentation collection

all documentation titles for this version

n/a

http://docs.sun.com/

coll/S1_IdServ_61

Sun ONE Identity Server 6.1 Deployment Guide

Information on deploying Identity Server within an existing IT infrastructure.

816-6775-10

http://docs.sun.com/db

doc/816-6775-10

Sun One Identity Server 6.1 Migration Guide

Includes instructions on how to augment Identity Server with new services using the public APIs.

816-6771-10

http://docs.sun.com/db

doc/816-6771-10


Sun Java System Portal Server Documentation

TABLE 14-5 lists some examples of the Portal Server documentation.

TABLE 14-6 Portal Server Documentation

Book Title

Description

Part Number

Location

Sun ONE Portal Server 6.2 Developer's Guide

Explains how to use the PS software APIs

816-6758-10

http://docs.sun.com/db/doc/816-6758-10

Sun ONE Portal Server 6.2 Administration Guide

 

816-6748-10

http://docs.sun.com/db/doc/816-6748-10



Troubleshooting During Server Validation

The Java Studio Enterprise servers have specific dependencies and need to be started in the proper startup sequence. Refer to Suggested Startup Sequence for more information. This section lists some of the more common errors you might see.

1. Trying to access Identity Server Console from your web browser results in the following error:

Server Error
This server has encountered an internal error which prevents it from fulfilling your request. The most likely cause is a misconfiguration. Please ask the administrator to look for messages in the server's error log.

Reason: Identity Server relies on other Java Studio Enterprise servers, such as Directory Server and Web Server. The servers may not all be running.

Solution: Start the servers in the proper sequence. See Suggested Startup Sequence for details.

2. (Solaris) Trying to start the Identity Server from the command line, you see the following error:

Directory Server was not installed as part of Identity Server.

Please start it manually.

starting web container instance ...

Sun ONE Web Server 6.1 B09/11/2003 19:00

info: CORE3016: daemon is running as super-user

...

info: WEB0100: Loading web module in virtual server [https-hostname.domainname] at [/search]

failure: WebModule[/portal]: WEB2783: Servlet /portal threw load() exception

javax.servlet.ServletException: WEB2778: Servlet.init() for servlet RewriterServlet threw exception

...

----- Root Cause -----

Start of DataServiceException:

Message: LDAP authentication failed.

Cause:com.iplanet.sso.SSOException: LDAP authentication failed.

...

com.sun.portal.desktop.context.ContextError:

DSAMEServiceAppContext.initAdminDSAMEConnection()com.iplanet.sso.SSOException:

LDAP authentication failed.


Reason: Identity Server relies on other Java Studio Enterprise servers, such as Directory Server and Web Server. The servers may not all be running.

Solution: Start the servers in the proper sequence. See Suggested Startup Sequence for details.

3. After starting all the servers, trying to access the amconsole by using an URL of the form http://localhost/amconsole gives you a Page Not Found error.

Reason: You may have an incorrect proxy server setting. IS may be trying to resolve the URL by using the proxy server if one is set.

Solution: Set the Web browser proxy setting to direct connection or to not use a proxy server.

4. (Microsoft Windows) You see this error message in the console window trying to start Identity Server from the Start Menu:

C:\Sun\jstudio\IS6.1\bin>C:\Sun\jstudio\DirectoryServer5.2\slapd-localhost\start -slapd.bat

C:\Sun\jstudio\WebServer6.1\https-localhost.my.company.com\startsvr.bat

C:\Sun\jstudio\IS6.1\bin>net start slapd-localhost

The requested service has already been started.

More help is available by typing NET HELPMSG 2182

C:\Sun\jstudio\IS6.1\bin>


Reason: Directory Server is already started and can not be started again.

Solution: You can ignore this message. You should be able to access Identity Server as both Directory Server and Web Server are already running.

5. Installing Java Studio Enterprise results in either a failed installation or failed configuration of Identity Server:

Reason. Your system DNS Suffix may not be set correctly.

Solution. See Verifying the DNS Suffix.

6. Trying to access Portal Server Desktop, you see this error in the browser window:

A serious error has occurred in the Desktop. This may have been caused by a mis-configuration on the server.

Report this problem to you administrator.

Possible cause:

You do not have permission to access the dektop

Return to front page


Reason: You have not logged out of Identity Server Console before trying to access Portal Server Desktop.

Solution: Either logout of Identity Server Console and try again or start a new instance of your browser and try again.