This chapter describes how to administer Sun Java System Web Server 6.1 with the Sun Java System Web Server Administration Server. Using the Administration Server, you can manage servers, add and remove servers, and migrate servers from a previous release.
This chapter includes the following sections:
This section describes how to access the Administration Server for UNIX/Linux and Windows platforms.
Go to the server_root/https-admserv/ directory (for example, /usr/s1ws61/servers/https-admserv/)
This command starts the Administration Server using the port number you specified during installation.
The Sun Java System Web Server installation program creates a program group with several icons for Windows platforms. The program group includes the following icons:
Release Notes
Start Web Server Administration Server
Uninstall Web Server
Administer Web Server
The Administration Server runs as a services applet; thus, you can also use the Control Panel to start this service directly.
Double-click the “Start Web Server Administration Server” icon, or type the following URL for starting the administration server in your browser:
http://hostname.domain-name:administration_port
Sun Java System Web Server then displays a window prompting you for a user name and password.
Type the administration user name and password you specified during installation.
Sun Java System Web Server displays the Administration Server page.
For more information, see the Administration Server page in the online help.
You must enable cookies in your browser to run the CGI programs which is necessary for configuring your server.
You can also access the Administration Server from a remote location as long as you have access to client software such as Netscape Navigator. Since the Administrator Server is accessed through a browser, you can access it from any machine that can reach the server over the network.
There are two ways you can have multiple web servers running on your system:
Use virtual servers
Install multiple instances of the server
Virtual servers allow you, with a single installed server, to offer companies or individuals domain names, IP addresses, and some server administration capabilities. For the users, it is almost as if they have their own web server, though you provide the hardware and basic web server maintenance.
The settings for virtual servers are stored in the server.xml file, found in the server_root/server_id/config directory. You must not edit this file to use virtual servers, but if you would like to learn more about this file, see the Sun Java System Web Server 6.1 SP7 Administrator’s Configuration File Reference.
For more information about virtual servers, see Chapter 14, Using Virtual Servers.
Previous releases of Sun Java System Web Server, virtual servers did not have unique configuration information. The only way to have servers with separate configuration information was to create a new server instance. However, with Sun Java System Web Server 6.1, virtual servers have separate configuration information, so multiple server instances are no longer required. They are still supported, but virtual servers are the preferred way to have multiple servers.
If you choose to install multiple instances of the web server, you can use the Administration Server to:
Install multiple copies of the server on Windows as separate instances, each with a different IP address.
Configure a set of servers that all use the same IP address, but different port numbers.
If your system is configured to listen to multiple IP addresses enter one of the IP addresses that your system is hosting for each server you install.
If you installed your server before configuring your system to host multiple IP addresses, configure your system to respond to different IP addresses. Then you can either install hardware virtual servers or change the server’s bind address using the Server Manager and install separate instances of the server for each IP address.
Access the Administration Server and choose the Servers tab.
Click Add Server.
Enter the desired information for the specified fields.
The server identifier cannot start with a digit and only Latin-1 characters should be used in instance names.
Click OK.
For more information, see the Add Server page in the online help.
You can remove a server from your system using the Administration Server. Be sure that you don’t need the server anymore before you remove it, since this process cannot be undone.
Some Windows servers have an uninstall program that you can use to remove a server and its associated administration server. For details, check with your product documentation.
Access the Administration Server and choose the Servers tab.
Click Remove Server.
Select the server you wish to remove and click Yes.
Click OK.
The Administration Server subsequently deletes the server’s configuration files, Server Manager forms, and the following directory (and any subdirectories):
server_root/https-server-id |
For more information, see the Remove Server page in the online help.
You can migrate Sun Java System Web Server from a 4.1 or 6.0 version to a 6.1 version. Your 4.1 or 6.0 server is preserved, and a new 6.1 server using the same settings is created.
You should stop running 4.1 or 6.0 server before migrating settings. Make sure you have a compatible version of the web browser installed on your computer before migrating settings.
For a complete description of how to migrate a server from a previous version to Sun Java System Web Server 6.1, see the Sun Java System Web Server 6.1 SP7 Installation and Migration Guide.
For more information, see the Migrate Server page in the online help.