C H A P T E R  10

Using Sun Java System Web Server

Once you have successfully installed the Java Studio Enterprise software, you can verify the configuration of Sun Java System Web Server 6.1, Service Pack 1 (Web Server) as your default server for web tier applications. The Java Studio Enterprise IDE includes the Sun Java System Web Server 6.1, Service Pack 1 plug-in. You can start, stop, and deploy to the Web Server from inside the IDE. First you need to make sure that the user account that is running the IDE has access to a valid Web Server instance.

This chapter covers the following topics:


Using the Correct Web Server Instance

This installation of the Java Studio Enterprise IDE and Sun Java System Web Server 6.1, Service Pack 1, creates a preconfigured Web Server instance. If you also installed Sun Java System Identity Server 6.1 (Identity Server) and Sun Java System Portal Server 6.2 (Portal Server), then Identity Server and Portal Server are configured to run in the default instance of Web Server. This default instance of Web Server belongs to the superuser or administrative user account which was used for the installation. If you installed the Java Studio Enterprise IDE and wish to use an instance of Web Server for development and if the user account you use to run the IDE has superuser or administrator privileges, you can use the default Web Server instance.



Note - The Java Studio Enterprise installer configures Identity Server and Portal Server with the default Web Server instance. You might want to use a separate instance for development purposes to avoid issues such as accidentally undeploying either Identity Server or Portal Server.



If you installed the Java Studio Enterprise IDE and plan to run the IDE with a user account which does not have superuser or administrator privileges, you need a Web Server instance for that user account.

(Solaris OS only) During installation on a Solaris OS machine, you had the opportunity to enable Application Server and Web Server usage by a non-root user. If you did this, the installer created a second instance of Web Server belonging to the specified user account. If you did not use this option during installation and need to create a web server instance for a non-root user, follow the procedure for Creating a New Web Server Instance. If you install Web Server, the installer always creates the default instance owned by the root. You can not see the default root instance from the IDE.


Creating a New Web Server Instance

To run the IDE with a standard end user account (defined as a user account that does not have administrator or superuser privileges) and use the Web Server, you need to create a Web Server instance for that specific user account. The installer can do this for you during installation, see Product Usage by Non-root User. If you did not select this option during installation, you can do it post-installation. To do this, access the Web Server administrative tool, create the new Web Server instance, and register the new Web Server instance with the IDE. The following procedures describe how to do this.


procedure icon  To Create a Web Server Instance

The superuser performs this procedure to create an instance for another user, usually a non-root end user. This procedures uses the Web Server Administrative Console to create a new Web Server instance.

1. Become a superuser.

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

# cd /opt/SUNWwbsvr/https-admserv

This example shows the directory for a default Solaris installation.

3. Start the Web Server Admin Server process.

# ./start

Once you see the message "server started successfully", proceed to the next step.

4. Access the Web Server Graphical Interface by typing the default server URL in your web browser.

This URL is of the format http://hostname.domainname:adminport. For example, http://host1.example.com:8888.

5. When prompted, type the User Name and Password.

Use the values that you entered on the Configuration page during installation. If you do not remember what you used for the User Name, you can find it in the Summary_Report.timestamp for your installation session. Refer to the installation chapter for your platform for the location of this report.

The Sun ONE Web Server Administration Server Console appears in the browser window.

6. From the Servers tab, click Add Server.

The Add Server dialog displays in the browser.

7. Enter the requested values.

Name of Field

Example Value

Additional Information

Server Name

www.mozilla.com

(or machine-name.domain-name)

Specifies the fully qualified host name of this server.

Server Port

1025

(Solaris OS) Be sure to use an unused port number above 1024.

Specifies an unused port number to service the HTTP requests for this server.

Server Identifier

marketing_server

Specifies the server identification (a name) for the Administration Server to use for this server instance. The Server Identifier cannot start with a digit. Only ASCII characters are supported.

Server User

IDE-user-account-login

Specifies the user name under which this server instance runs. This should match the user account that will run the IDE.

Document Root

/home/IDE-user-account-login

Specifies the directory path to the location of the server's web documents.


8. Click OK.

The new Web Server instance is created.

9. Exit from superuser privileges.

10. Provide your standard end user with the Server Identifier.

The standard user can now set this server instance as the default Web Server in the IDE.


procedure icon  To Set the Default Web Server Instance in the IDE

The standard (non-root) end user should perform this procedure.



Note - This procedure is done by the Server User (the standard end user) specified when the new Web Server instance was created.



1. If you have not already confirmed the default Application Server for use by the IDE, please read Chapter 9 and follow the appropriate procedures.

2. Start the IDE.

See Chapter 8 if you have not yet started the IDE for the first time.

3. In the IDE Explorer window, select the Runtime tab.

4. Select the Server Registry node.

If a query window displays asking "Do you want to start the Admin Server now?", then you have not yet set your default Application Server. If you see the query window, be sure you have read Chapter 9 and understand how to respond to this query.

Sun ONE Application Server dialog box for starting the Admin Server. Buttons are OK and Cancel.

If you click OK, this action tries to starts the Application Server admin server. Unless you have the proper permissions, you may not be able to start this server.



Note - (Solaris OS) If you enabled the creation of a non-root admin domain during installation, then you can click OK to respond to this query.



5. Expand the Server Registry node and expand the Installed Servers node.

6. Expand the Sun ONE Web Server node.

You see your Web Server instance with the name that was specified as the Server Identifier. For example: https-marketing_server (matching our example in Step 7 of the procedure To Create a Web Server Instance).

(Solaris only) If you created a non-root instance of Web Server during installation, your Server Registry looks something like this:

Runtime tab of Explorer showing expanded https-jstudio instance under Sun ONE Web Server 6.1 node. 

7. Expand your Web Server instance node.

You see the virtual server.

8. Right-click on the Virtual Server instance and choose Set As Default.

This sets your Web Server instance as the default.

9. Expand the Default Servers node to verify.

The default servers for Web Tier Applications shows the new server as the default.


Common Web Server Procedures

These procedures can be used to confirm the default Web Server instance and to start the Web Server instance from the IDE. For information on using the Web Server from outside the IDE, refer to Chapter 14


procedure icon  To Confirm the Default Web Server

If you have started your Web Server instance before or you are running the IDE as the same user account that performed the Java Studio Enterprise installation, this is how you confirm the default web tier application server:

1. In the IDE Explorer window, select the Runtime tab.

2. Expand the Server Registry node and expand its Default Servers subnode.

If the Web Tier Applications node's label is server-instance(hostname:portnumber) and matches the Web Server instance that you want to use from the IDE, then your default Web Server is set correctly. If it is not, continue with the next step.

The Default Servers node in the Runtime pane of the Explorer shows the application server is MyServer(localhost:4855). 

3. Find your Web Server instance under the Installed Servers node, right-click the server instance, and choose Set As Default.

Your server is set as the default server for Web Tier applications.


procedure icon  To Start the Web Server Instance

1. Right-click the Web Server node and choose Start Server from the contextual menu.

2. Confirm that the server started successfully by returning to the Web Server Console.

You can find additional information about using the Web Server in Chapter 14 and in Sun Java System Web Server documentation. Refer to TABLE 14-4 for some of the available documentation titles.