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:
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.
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.
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.
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.
2. Change to the installation directory for the Web Server Admin Server.
This example shows the directory for a default Solaris installation.
3. Start the Web Server Admin Server process.
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.
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.
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.
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.
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:
7. Expand your Web Server instance node.
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.
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
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.
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.
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.
Copyright © 2004, Sun Microsystems, Inc. All rights reserved.