Exploring NetWare 6's Web Server Options
Novell Cool Solutions: Feature
By Joe Harmon
Digg This -
Posted: 18 Jun 2002
Installing Web Servers on NetWare
Disclaimer: This document is an installation guide for the Web Servers on NetWare. It is not intended to be a full resource to these products. Its intent is to help the consumer with their default installation. If additional configuration questions arise it is suggested that you visit http://www.novell.com/documentation. If additional troubleshooting is needed it is suggested that you visit http://support.novell.com or that you open a support incident with Novell Technical Support.
Note about Web Servers on NetWare 6.0: The default Web Server on NetWare 6.0 is the NetWare Enterprise Server. The Apache Web Server is also part of NetWare 6.0 because of the many Apache-based applications that run on NetWare 6. Even if the NetWare Enterprise Server is not chosen at install time, the Apache Web Server will be installed as a foundation for the abovementioned services.
NetWare Enterprise Web Server -- This is the main Web Server on NetWare 6. This started out as the Netscape Enterprise Web Server on NetWare 4.11 and 5 and was then developed into what is known as the NetWare Enterprise Web Server on NetWare 5.1 and 6.0. This product is configured through the use of a GUI interface.
Apache-based Services -- This is not the main Web Server for NetWare 6, but there are several NetWare 6 components that run on Apache. Apache is configured manually with configuration (*.CONF) files. This Web Server is installed by default on NetWare 6.
The first option that will be presented is the services. Here you can choose the NetWare Enterprise Web Server if you desire. Again, it is important to note that whether or not you choose this server, Apache will be installed.
Single IP Address vs. Multiple IP Address
NetWare 6 has the ability to use Multiple IP Addresses or a Single IP Address to load handle its Web Servers. The reason for this is simple. Both Apache and the Enterprise Server use the same ports (80 and 443). This brings us to the reason for the choice between a single IP address or multiple IP addresses:
If you have a single IP address you will need to assign ports other than 80 and 443 to one of the services (if both are being installed). The issue here is that port 80 represents HTTP and port 443 represents HTTPS. So long as you are specifying HTTP or HTTPS there is no need to place the port number at the end of the URL. The ports are assumed. If you specify the single IP address option you will need to specify the port at the end of the URL. Example: http://192.168.0.1:1000. If you specify the multiple IP address option, you can assign port 80 and 443 to another IP address, eliminating the need to place the port at the end of the URL.
Important: You can allow the same IP address to listen on multiple ports. You can allow multiple ports on the same IP address. You CANNOT allow the same IP address to listen on the same port multiple times.
Since there are several services within NetWare 6 that want to use the same ports, you are given the option to have one IP address with multiple ports or multiple IP addresses with the same ports.
Important: If you choose the option for SINGLE IP ADDRESS, you will need to decide which ports you want to use. Keep in mind that the ports may already be taken by another product. For a list of common ports you can go to NetWare 6 Port Assignments. By default, if the NetWare Enterprise Web Server is installed, it will take over port 80 and 443. If desired, you can change this over to the Apache-based Services. However, one thing to keep in mind is that you will have to configure Apache through a configuration file vs. the Enterprise Server being configured through a GUI interface.
Note: iFolder is shown in this configuration screen but is not discussed in this document. It is discussed in the iFolder documentation.
Important: The service which owns port 80 and 443 will also receive the NetWare 6 home page. If assigned to the Enterprise Server, the NetWare 6 home page will be copied out to the SYS:/NOVONYX/SUITESPOT/DOCS directory. If assigned to Apache-based Services then the NetWare 6 home page will be copied out to the SYS:/APACHE/NWDOCS directory. If you want to keep the NetWare 6 home page and host your own home page on port 80 and 443, then it is suggested that you choose the multiple IP address option. You can still choose the single IP address option and host both the NetWare 6 page and your own home page, but it will require additional configuration after the installation not required by the multiple IP address option.
Single IP Address Option
If you choose the multiple IP address option then there are a few things you should note to avoid confusion. The main IP address that you give to the server will be picked up by the NetWare Enterprise Web Server by default. The main IP address will also host the NetWare 6 home page.
Option 1 -- If the main server IP address is given to the NETWARE ENTERPRISE Web Server, the following will occur:
- The NetWare 6 home page will be run by the NetWare Enterprise Web Server under the SYS:/NOVONYX/SUITESPOT/DOCS directory.
- Apache Services will be available on the secondary IP address. However, the Web Manager (which runs through Apache) will be listening on the main IP address (same one the Enterprise Server is using) on port 2200.
- Apache will be available to run your home page under the SYS:/APACHE/NWDOCS directory since it is not using the NetWare 6 home page. However, if you plan on using the NetWare Enterprise Server to host your pages you will lose the NetWare 6.0 home page.
Option 2 -- If the main server IP address is given to APACHE-BASED SERVICES, the following will occur:
- The NetWare 6 home page will be run by Apache Services under the SYS:/APACHE/NWDOCS directory.
- Apache Services will be available on the main IP address along with the Web Manager running on port 2200 on that IP address.
- Apache will not be able to run your home page by default because it will be hosting the NetWare 6 page. The Enterprise Server will be available to host your home page at this point under the SYS:/NOVONYX/SUITESPOT/DOCS directory.
Therefore, if you want Apache to host your pages on port 80 and 443, then give the Enterprise Server the main server IP address so that Apache will be open on port 80 and 443 (Option 1). If you want the Enterprise Server to host you pages on port 80 and 443 then give Apache-Based Services the main server IP address (Option 2).
Multiple IP Address Option
The last dialog box is the summary. Here we will show the list of services to be installed. This is your last chance to back up if things need to be changed. If you are finished and ready to install, click FINISH.
Web Server Directory Structures
Apache-based Services Directory Structure (SYS:/APACHE)
- CONF - Directory for Apaches configuration files.
- ADMINSERV.CONF - Main configuration file for Apache that is generated during the NetWare 6 installation .
- HTTPD.CONF - Default configuration file if you want to customize your own Apache Web Server.
- MODULES - Directory that holds the Apache modules.
- Here is where you would place any modules that need to be used but are not compiled with the Apache Web Server.
- NWDOCS - Default home directory for the Apache Web Server.
- HTDOCS is usually the default directory for Apache if you were using the HTTPD.CONF file. However, NetWare 6 uses its own file and its own directory for Web content. This directory is the NWDOCS.
- LOGS - Here is where you will find the ACCESS_LOG and ERRORS_LOG.
NetWare Enterprise Server Directory Structure (SYS/NOVONYX)
- SYS:/NOVONYX/SUITESPOT/DOCS - This is the main document directory for the NetWare Enterprise Web Server.
- SYS:/NOVONYX/SUITESPOT/HTTPS-SERVERNAME/CONFIG - This is where you will find the main configuration files for the Enterprise Web Server.
- SYS:/NOVONYX/SUITESPOT/ADMINSERV/CONFIG - This is where you will find the main configuration files for the Web Manager.
- SYS:/NOVONYX/SUITESPOT/HTTPS-SERVERNAME/LOGS - This is where you will find the error log for the Web Server.
Accessing Web Servers on NetWare
(1) Accessing via the NetWare 6 Home Page
Note: Again, this page will be running under Apache or the Enterprise Server depending on how the product was installed. If you chose the single IP address option then you may need to specify a port number after the URL. If you chose the multiple IP address option then you will just need to put in the IP address of Apache or Enterprise depending on which one received the main server IP address.
(2) NetWare Web Manager (Apache-Based Service)
Note: This allows you to manage several Web-based products as well. It is accessed by going to https://MainIPAddress:2200. If you installed using the multiple IP address option, this will be running as an Apache Service off of the main IP address.
Important: When clicking on MANAGE Web Server (on NetWare 6 home page) or on the Server Name (within the Web Manager) you will be required to login. If admin is not in the same container as the Web Server, you will need to login with the full context and a leading period as seen in the example below.
(3) Enterprise Web Server Administration
After you authenticate you will be able to manage the NetWare Enterprise Web Server configuration options.
(4) Apache Web Server Administration
The Apache Web Server administration is all done via editing files. There is currently no GUI for administering the Apache Web Server running on NetWare. The main configuration file for Apache is found in the SYS:/APACHE directory. It is called ADMINSERV.CONF. Several Apache-based services are administered through the NetWare 6 home page but are not covered in this document.
Novell Cool Solutions (corporate web communities) are produced by WebWise Solutions. www.webwiseone.com