Table of Contents

Installing the Web User Interface

Network Registrar 5.0 provides a Web-based user interface (Web UI) that you install on a Web server. The Web UI is in addition to the Network Registrar graphical user interface (GUI) and command line interface (CLI). The Web UI lets you run status reports. Access to the Web UI is from a URL to a login page.

This document describes how to install and open the Web UI on a Web server.

Installation Prerequisites

To install the Network Registrar Web UI, be sure you select and install the prerequisite software, including the Web server and the Web browser. You need:

• A Web server supporting CGI, installed on the same system as Network Registrar 5.0, such as the following:
  
  
• • Netscape Enterprise Server 3.51 or later, on at least Windows NT 4.0 or Solaris 2.6
    
    
  • Netscape FastTrack on Windows NT 4.0 or Solaris
    
    
  • Microsoft Internet Information Server (IIS) 3.0 or later, on Windows (with Service Pack 5 or later recommended for NT 4.0 or Windows 2000 server)
    
    
• Perl 5.0 or later, installed and configured on your Web server.
  
  
• A Web browser, such as the following:
  
  
• • Netscape Communicator and Navigator 4.0x, or Navigator 3.02
    
    
  • Microsoft Internet Explorer 4.0 or 3.02
    
    

Using a Netscape Web Server

Before you install the Web UI on the Netscape Enterprise or FastTrack server, verify that:

Netscape Windows Installation

To install a Netscape Web server running a Windows operating system, follow these steps:

Step 1   Install Network Registrar 5.0, the Netscape FastTrack or Enterprise server, and Perl 5.0, then reboot.

Step 2   Locate the following folders in the WebUI folder of the Network Registrar installation:

• perl—Contains the Perl files representing the five Web UI report types: AddressUsage.pl, LeaseStatus.pl, RelatedServers.pl, Reporting.pl, and ServerStatus.pl
  
  
• docs—Contains a single file, Login.htm
  
  
• javascript—Contains the following files: Help.js, NR30Help.htm, Reporting.js, and ValidateReportForm.js
  
  

Step 3   Create these folders in the Web server's installation folder:

Step 4   Copy the Login.htm file in the WebUI\docs folder to the Web server's docs folder.

Step 5   Copy the .pl files in the WebUI\perl folder to the Web server's cgi-bin folder you created.

Step 6   Edit the .pl files to change the default location from #!/usr/bin/perl to where Perl is installed; for example, #!C:\\perl\\bin\\perl.

Step 7   Copy the folders in the WebUI\javascript folder to the docs\javascript folder you created.

Step 8   Restart the Web server.

Netscape Solaris Installation

To install a Netscape Web server running the Solaris operating system, follow these steps:

Step 1   Install Network Registrar 5.0, the Netscape FastTrack or Enterprise server, and Perl 5.0, then reboot.

Step 2   Locate the following subdirectories in the WebUI directory of the Network Registrar installation:

• perl—Contains the Perl files representing the five Web UI report types: AddressUsage.pl, LeaseStatus.pl, RelatedServers.pl, Reporting.pl, and ServerStatus.pl
  
  
• docs—Contains a single file, Login.htm
  
  
• javascript—Contains the following files: Help.js, NR30Help.htm, Reporting.js, and ValidateReportForm.js
  
  

Step 3   Create these directories:

Step 4   Copy the Login.htm file in the WebUI/docs directory to the Web server's docs directory.

Step 5   Copy the .pl files in the WebUI\perl directory to the Web server's cgi-bin directory you created.

Step 6   If Perl is installed somewhere other than in the default location (#!/usr/bin/perl), then edit the .pl files, modifying the bang (!) path to point to where Perl is installed.

Step 7   Copy the folders in the WebUI/javascript directory to the docs\javascript directory you created.

Step 8   Restart the Web server.

Using a Microsoft Internet Information Server Web Server

Before you install the Web UI on the Microsoft Internet Information Server (IIS), verify that:

Things to Know About IIS

There a few things you need to know about IIS to configure the Web UI properly:

• IIS comes standard with the Windows 2000 server and as an option pack for the Windows NT server. To get the true IIS installed, you must be running a server version of Windows NT or Windows 2000. What you get on Windows NT or 2000 workstation is Personal Web Server (PWS).
  
  
• At least Service Pack 5 must be installed on your server (with the SP 6a upgrade from Microsoft recommended). There are known problems with previous service packs.
  
  
• IIS does not come with Perl. You must install Perl as a separate step from your IIS installation. You can either install Perl first and then IIS, or vice versa. To configure IIS to use Perl, see the description below.
  
  

Configuring IIS to Use Perl

This section assumes that you successfully installed IIS and ActivePerl on your server. To use ActivePerl with IIS, follow these steps:

Step 1   Run the IIS 4.0 Microsoft Management Console:

C:\winnt\system32\mmc.exe 
 

Step 2   A tree-based representative of your Web server appears. You can apply these changes to the entire Web server, a particular site, or a virtual directory by highlighting the selection on the left hand side. Then select Action > Properties.

• If you chose to administer the properties for the entire Web server, the Server Properties page appears. Select WWW Service from the Master Properties drop-down box and click the Edit button. This opens the WWW Service Master Properties page. Select the Home Directory tab.
  
  
• If you chose to administer the properties of a particular site, the Web Site Properties page appears. Select the Home Directory tab.
  
  
• If you chose to administer the properties for a virtual directory, the Virtual Directory Properties page appears. Select the Virtual Directory tab.
  
  

Step 3   Click the Configuration button to open the Application Config page.

Step 4   Select the App Mappings tab, then click the Add button. This opens the Add/Edit Application Extension Mapping page.

Step 5   To run Perl as a CGI application, enter the full path to perl.exe followed by %s %s. For example:

D:\perl\bin\perl.exe %s %s 
 

When the script is executed, the first %s is replaced by the full path and the second %s is replaced by the script parameters, similar to argv[0] and argv[1].

To run Perl for ISAPI, enter the full path to the PerlIS.DLL file.

Step 6   In the Extension field, enter .pl and any other extensions you want to use for Perl scripts.

Step 7   Click the OK buttons to get back out to the main page. Your configuration is now complete. You can now place your CGI scripts in the cgi-bin directory (with the proper extension) and IIS will relate them to the Perl Interpreter.

IIS Windows Installation

To install an IIS Web server running a Windows operating system, follow these steps:

Step 1   Install Network Registrar 5.0, the IIS software (and Perl 5.0, if necessary), then reboot.

Step 2   Locate the following folders in the WebUI folder of the Network Registrar installation:

• perl—Contains the Perl files representing the five Web UI report types: AddressUsage.pl, LeaseStatus.pl, RelatedServers.pl, Reporting.pl, and ServerStatus.pl
  
  
• docs—Contains a single file, Login.htm
  
  
• javascript—Contains the following files: Help.js, NR30Help.htm, Reporting.js, and ValidateReportForm.js
  
  

Step 3   Create these folders in the Web server's installation folder:

Step 4   Copy the Login.htm file in the WebUI\docs folder to the Web server's wwwroot folder.

Step 5   Copy the folders in the WebUI\javascript directory to the wwwroot/javascript folder.

Step 6   Copy the .pl files in the WebUI\perl folder to the Web server's wwwroot\cgi-bin folder.

Step 7   Restart the Web server.

Opening the Web Browser

After completing the previous steps, you should be able to bring up your Web browser. When you enter your machine name or URL, /login.htm, the login page, should appear. Here is a sample URL:

<http://localhost/login.htm  >