Chapter 4. Installing your server

Installing your server

This chapter describes how to install your server and covers the following topics:

Installing for the first time or reinstalling

To install your server for the first time or to reinstall:

Prepare to install.
- Put the server CD-ROM in your CD-ROM drive.
- For Windows NT, use either of the following methods:
  - Using your mouse, click the left mouse button to perform these tasks:
    - Select the File menu.
    - Select Run.
    - Specify the directory letter for your CD-ROM drive, the platform subdirectory, and the language subdirectory, followed by the setup.exe file. For example:
```
    e:\NT\language\setup
```
      NT is the Windows NT platform subdirectory; language is the national language you want to install.
    - Select OK.
      Alternatively, you can select the browse button and find the setup.exe file on the CD-ROM drive before selecting OK.
  - Open an MS-DOS window and at the DOS prompt, enter
```
    e:\NT\DEU\g:setup.exe
```
    where e is your CD-ROM drive.
- From the Welcome window, click Next.
Deselect the components you do not want to install.
- From the Select Components window, deselect any components that you do not want to install:
  - IBM Internet Connection Server
    This is the base Web server product.
    Note:
    The server documentation is automatically installed when you install this component.
  - Security Files
    This contains all the function to use the SSL protocol as part of your server.
  - NT Service
    For Windows NT, the NT Service component allows you to run the server as an NT service.
    Once your server is installed as an NT service, the Internet Connection Server program group will contain only the Uninstall icon because you can start a true Windows NT service only from the Services panel. You can reinstall the base program to get the program icon.
- Click Next.
Choose a target directory.
Note:
With Windows NT, the directory you specify for the installation must be on a drive in an NTFS, HPFS, or FAT partition. We recommend that you install onto an NTFS drive for better file protection.

From the Choose Target Directory window, do the following:
- Click Browse if you want to change the drive or directory destination. The default destination directory for the server is C:\WWW\.
- Click Next.
Choose component directories.
- From the Choose Component Directories window, review the destination directories for the server components. These directories define where you want to install your server components and where you want to store the resources you will be making available through your server. This window initially displays the first five directories. Click Next to display the remaining directories in a separate window.
  Note:
  You can change the path for a directory using either of the following methods:
  - Type over the default path.
  - Click the button next to the directory name and select the new path in the Choose directory window. Click OK to continue.
  - Administration directory
    The files used by the server Configuration and Administration forms are installed in this directory.
  - Executables directory
    The server executable program files and other related files are installed in this directory.
  - CGI Bin scripts directory
    Your script programs that use the Common Gateway Interface (CGI) and the server htimage program are installed in this directory.
  - Documentation directory
    The server publications Quick Beginnings and the WebMaster's Guide are installed in this directory.
  - HTML directory
    Your HTML documents, the server sample HTML pages, and the server Front Page are installed in this directory.
  - Icons and graphics directory
    The default directory list icons are installed in this directory. You may also choose to put your own icon and graphics files in this directory.
  - Labels directory
    Example labels for Platform for Internet Content Selection (PICS) support are installed in this directory.
  - Logs directory
    The server puts log files in this directory.
  - Trusted servlets directory
    This is the directory where you want to keep all trusted Java servlets. This will allow these servlets to run in the same process as the server and can improve performance.
  - Servlets directory
    This is the directory where you want to keep all untrusted Java servlets. This will ensure that these servlets run in a separate process than the server and will not bring down the server if they fail.
- Click Next.
  If you selected any of the component directories, you will be prompted on additional windows for those directories.
Select program folder name.
- Optionally, change the default program folder name of your server by selecting one of the existing folders from the Select Program Folder window or by typing a new program folder name. The default folder name is Internet Connection Server.
- Click Next.
Select configuration file
If you are reinstalling and already have a server configuration file, you will be asked if you want to keep the existing httpd.cnf file. This file is located in the C:\WINNT35\ directory.
- Click No if you want to install with the default configuration settings.
  Note:
  Your current httpd.cnf configuration file will be copied to a file named httpd.$nf.
  
  It is recommended that you choose No, which is the default, because many new directives have been added to the configuration file. For a list of new directives, see page reference #1.
- Click Yes if you are reinstalling and want to save your current configuration settings.
Click OK to continue.
Choose configuration parameters.
- Review the default values for host name, HTTP port, SSL port, the key ring file name, administrator ID, and administrator password from the Configuration Parameters window.
  - Host Name
    The default value is the host name defined as part of your TCP/IP configuration. If you want to use an alias, you can change this field to a fully qualified host name that is defined in your domain name server.
  - HTTP Port (80)
    The default value of 80 is the well known port number for Hypertext Transfer Protocol (HTTP). Other port numbers less than 1024 are reserved for other TCP/IP applications. Port numbers 8080 and 8008 are commonly used for testing servers.
  - SSL Port (443)
    The default value of 443 is the well known port number for Secure Sockets Layer (SSL) protocol requests.
  - Key Ring File
    This is the name of the file where you want to store private-public key pairs that the server will use for secure communications. The default value is C:\WWW\BIN\keyfile.kyr. If you already have a key ring file, correct the key ring file name.
    Note:
    For Windows NT, if you have installed the secure server as an NT service, you must start the server, go to the Configuration and Administration forms, and check the box to set your key ring file password to be automatically stashed.
  - Administrator ID
    This is the ID of your server administrator. Anyone attempting to use the server Configuration and Administration Forms will be prompted to enter this ID. The default value is webadmin.
  - Administrator Password
    This is the password that protects access to the Configuration and Administration forms. Anyone attempting to use the server Configuration and Administration forms will be prompted to enter this password. The default value is webibm.
- After reviewing the default values, make your changes by editing the parameter field. We recommend that you change the default administrator ID and password now.
- Click Next.
Enable Java support.
- You will be asked if you want to enable Java servlet support.
- Click Yes or No to begin the installation.
Select PICS configuration file.
- If an existing PICS configuration file is found on your system, you will be asked if you want to keep the existing file.
- Click Yes or No to continue.
  If you select No, the existing file will be backed up in your ETC directory with the file name ICS_PICS.$NF.
Complete the installation.
- During the installation, the Setup window is displayed and shows you the status of the installation. If you changed any of the default values, you may be prompted on additional windows for configuration values. You can stop the installation by clicking Cancel.
- The server files will be installed and the server icons added.
  For Windows NT, if you installed your server as an NT service, you will get a message stating that you can start the program from the Services panel.
- After installation is completed, a message will be issued if you need to reboot your system.
- Click OK.
Install the Nodelock Administration Tool.
- You will be asked if you want to install the License Use Runtime files for the Nodelock Administration Tool. This tool is required to install the secure server product license.
- If these files are not already installed on our system, click Yes.
- The License Runtime files will be installed.
- You will be asked if you want to view the README file.
- Click Yes or No to continue.
- You will be given the option to reboot now or later. The default is to reboot now.
- Click OK to complete the installation.
Install the secure server product license.
Note:
If you do not install the secure server product license, your server will operate as a secure server for only 60 days. You can install the secure server product license any time during that 60-day period or any time after 60 days without having to reinstall the server.
- In the License Use Runtime folder, start the Nodelock Administration Tool by double clicking on its icon.
- Click Products on the menu bar, then click the New option.
- In the New Product window, click Import.
- Select the name of the file that contains the Enrollment Certificate.
- Exit the Nodelock Administration Tool.
Connect to your server.
Use your favorite browser to connect to your server's Front Page by going to the URL http://your.server.name, where your.server.name is the fully qualified name of your host. The Front Page contains links that let you:
- Access the Configuration and Administration forms
- Create sample home pages
- Access the Internet Connection Family Web site
- Read online Internet Connection Secure Server documentation
See the Webmaster's Guide to learn how to configure your server to your exact specifications.

Migrating from a pre-V4R2 or an export V4R2 level server

If you are migrating from a previous release or want to reinstall the US-Canadian version of the V4R2 Internet Connection Secure Server, you must first delete the current version of the server. A backup configuration file and password file are saved during the migration procedure. For planning information, go to "Migration considerations".

To remove the server icon and product from your machine, stop the server and select the Uninstall Internet Connection Server icon in the Internet Connection Server group. For Windows NT, you can also selectively uninstall either the NT service, security, and/or base server components.

To install the current version of the server, use the procedure in "Installing for the first time or reinstalling".

Installing the secure server product license

If you do not install the secure server product license, or you download an evaluation copy of the server from the Internet Connection Family web site http://ics.raleigh.ibm.com, your server operates as a secure server for only 60 days. You can install the secure server product license any time during that 60-day period or any time after 60 days without having to reinstall the server. The secure server product license is available on the Internet Connection Secure Server CD-ROM.

To install the secure server product license:

In the License Use Runtime folder, start the Nodelock Administration Tool by double clicking on its icon.
Click Products on the menu bar, then click the New option.
In the New Product window, click Import.
Select the name of the file that contains the Enrollment Certificate.
Exit the Nodelock Administration Tool.

Automating installation

With InstallShield, you can automate your installation by running it in silent mode. You will not receive any messages during installation; however, a log file will be created. You can review this file to determine if the server was successfully installed.

You need a response file. The default response file on the CD-ROM is setup.iss. Copy setup.iss to a directory, review it, and use your favorite editor to make any changes.
To start the silent installation, type the following from a command prompt:
```
SETUP -S -F1path\filename -F2path\logfilename
```
-F1 and -F2 specify the paths and file names for the response and log files.
If you specify only -F1, InstallShield will:
- Use the response file specified by path\filename for the silent installation.
- Place the log file, which will be named SETUP.LOG, in the source directory.
If you specify both -F1 and -F2, InstallShield will:
- Use the response file specified by path\filename for the silent installation.
- Use -F2path\logfilename to determine where to put and what to name the log file.
Note: Make sure there are no spaces between -F1 and path/filename or -F2 and path/logfilename.
When the installation is complete, go to the log file and verify that you have successfully installed the server.

What's next?

Go to Chapter 5. "Starting to use your server" for information on the HTML documents shipped with the server and instructions on making your own documents available.

Use the information in the Webmaster's Guide to change your server default configuration settings and control access to your server.

[ Top of Page | Previous Page | Next Page | Table of Contents ]