1. Manuals
  2. Brands
  3. Netscape Manuals
  4. Server
  5. NETSCAPE ENTREPRISE SERVER 6.0 - INSTALLATION AND MIGRATION...
  6. Installation and migration manual

Netscape ENTREPRISE SERVER 6.0 - INSTALLATION AND MIGRATION GUIDE Installation And Migration Manual

Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
Installation and Migration
Guide
Netscape Enterprise Server
Version 6.0
December 2001

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the NETSCAPE ENTREPRISE SERVER 6.0 - INSTALLATION AND MIGRATION GUIDE and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Netscape NETSCAPE ENTREPRISE SERVER 6.0 - INSTALLATION AND MIGRATION GUIDE

Summary of Contents for Netscape NETSCAPE ENTREPRISE SERVER 6.0 - INSTALLATION AND MIGRATION GUIDE

  • Page 1 Installation and Migration Guide Netscape Enterprise Server Version 6.0 December 2001...
  • Page 2 Netscape Communications Corporation ("Netscape") and its licensors retain all ownership rights to the software programs offered by Netscape (referred to herein as "Software") and related documentation. Use of the Software and related documentation is governed by the license agreement for the Software and applicable copyright law. Your right to copy this documentation is limited by copyright law.

  • Page 3: Table Of Contents

    Contents About This Guide ............. . . 7 What You Need to Know .
  • Page 4 Logging In as the Correct User ............25 Unpacking the Files .
  • Page 5 Migrating Java Servlets ............61 Server-side Java Applets (HttpApplets) .
  • Page 6 Netscape Enterprise Server Installation and Migration Guide • December 2001...

  • Page 7: About This Guide

    About This Guide This guide explains how to install Netscape® Enterprise Server 6.0 and how to migrate from a previous version of Enterprise Server to this version. This preface contains the following sections: • What You Need to Know • What’s in This Guide •...

  • Page 8: Document Conventions

    Document Conventions If you want to do this: See this chapter: Find out what you need to do before Chapter 1, “Before You Install installing the server, including installing Netscape Enterprise Server” other products required by the server Get step by step instructions for installing Chapter 2, “Installing Netscape and uninstalling the server on UNIX®...

  • Page 9: How To Use Online Help

    How to Use Online Help How to Use Online Help When you are using Enterprise Server, you can click Help in any Enterprise Server window to open a web browser window showing explanations of all of the window’s user interface fields. You can then navigate to other parts of the help document.
  • Page 10 Where to Find Related Information Netscape Enterprise Server Installation and Migration Guide • December 2001...

  • Page 11: Chapter 1 Before You Install Netscape Enterprise Server

    Chapter 1 Before You Install Netscape Enterprise Server The following sections provide the information you need to know before you install Netscape Enterprise Server. This chapter contains the following sections: • Supported Platforms • Required Patches • Hardware and Software Requirements •...

  • Page 12: Supported Platforms

    Supported Platforms Supported Platforms Enterprise Server runs on these platforms: Table 1-1 Supported Platforms Operating System Architecture Required Required Disk Memory Space Hewlett-Packard HP-UX 11.0; PA-RISC 64 MB 110 MB 11.0 64 supported through minimum minimum binary compatibility AIX® 4.3.3 IBM®...

  • Page 13: Unix/Linux

    Hardware and Software Requirements UNIX/Linux • Swap space at least as large as the amount of RAM on your system (twice the amount of RAM is recommended). Linux requires 256 MB swap space. • Netscape Communicator 4.79 or higher, or Microsoft Internet Explorer 5.0 or higher.

  • Page 14: Other Technical Requirements

    Other Technical Requirements • Netscape Communicator 4.79 or higher, or Microsoft Internet Explorer 5.0 or higher. • If you are using Internet Explorer, you need to set your browser to check for a new version of a page every time you access it. To configure this setting, from the View menu, choose Internet Options.

  • Page 15: Enterprise Servercreating A Dns Alias For The Server

    Other Technical Requirements Enterprise ServerCreating a DNS Alias for the Server If your server will run on one machine among many in a network, you or your system administrator should set up a DNS CNAME record or an alias that points to the actual server machine.

  • Page 16: Windows Nt User Accounts For The Server

    Other Technical Requirements The Administration Server can also run with a user account that has write permissions to the configuration files for all installed servers. However, it’s much easier to run the Administration Server as because then the Administration root Server user can start and stop servers with port numbers less than 1024.

  • Page 17: Choosing Unique Port Numbers

    Other Technical Requirements Choosing Unique Port Numbers You need multiple port numbers: one for the Administration Server and one for each instance of Enterprise Server. The Administration Server is a special instance of the Enterprise Server that you use to manage your Enterprise Server. This Administration Server is not the same as the Netscape Administration Server shipped with Netscape Console.

  • Page 18: Installation Overview

    Installation Overview Installation Overview You can install Enterprise Server from its CD, which contains installation programs for both Netscape Enterprise Server and Netscape Communicator 4.79. In addition, the Enterprise Server software comes with a version of Netscape Directory Server and Valicert, each on a separate CD. When you install Enterprise Server, you follow these basic steps: If you have iPlanet Web Server 4.x already installed and plan to migrate that server to work with Enterprise Server...

  • Page 19: Installing Netscape Communicator

    Installing Netscape Communicator Installing Netscape Communicator Because you need a web browser such as Netscape Communicator to administer your server, you must install Communicator or another browser onto your machine before installing Enterprise Server. Installing Communicator on UNIX or Linux To install Netscape Communicator you can download the software from , or follow these steps to install from the CD: http://home.netscape.com...

  • Page 20: Installing Directory Server

    Installing Directory Server Installing Directory Server If you are planning to use users and groups (for example, for access control) with your Enterprise Server, you need to install before installing the Directory Server Enterprise Server, or use an exiting LDAP server installation. Enterprise Server CAUTION 6.0 and Directory Server 5.0 cannot exist in the same...

  • Page 21: Installing Netscape Console

    Installing Netscape Console Installing Netscape Console When you install the , you also install Netscape Console. Use Directory Server Netscape Console to manage your . You can also access the Directory Server Enterprise Server from Netscape Console if you run a script after you install the Enterprise Server.

  • Page 22: Accessing Enterprise Server From The Netscape Console

    Accessing Enterprise Server from the Netscape Console • Compaq Tru64: http://www.compaq.com/java • Windows NT: http://java.sun.com/j2se/ • Linux: http://www.blackdown.org You can install the JDK before you install Enterprise Server, and provide the path to it during installation, or you can wait until after you’ve installed Enterprise Server to install it.
  • Page 23 Accessing Enterprise Server from the Netscape Console For example: perl installMCC -root /usr/netscape/servers -host chicago.example.com -port 8888 -ldaphost newark.example.com -ldapport 389 -basedn example.com -binddn “cn=Directory Manager” -bindpwd password If you are using UNIX or Linux, go to the server root and run .
  • Page 24 Accessing Enterprise Server from the Netscape Console Netscape Enterprise Server Installation and Migration Guide • December 2001...

  • Page 25: Chapter 2 Installing Netscape Enterprise Server On Unix

    Chapter 2 Installing Netscape Enterprise Server on UNIX This chapter tells you how to install Netscape Enterprise Server on UNIX systems. It contains the following sections: • Installing on UNIX Platforms • Installing Across Multiple Machines • Using Uninstall on UNIX Installing on UNIX Platforms The topics in this section describe the installation of Enterprise Server on UNIX platforms.

  • Page 26: Unpacking The Files

    Installing on UNIX Platforms • You are not planning to use Express installation. If you meet these conditions, you do not need to log in as to install the server; root instead log in as the user account that the Administration Server will use. However, you may still prefer to log in as , even though you meet the root...

  • Page 27: Running Setup

    Installing on UNIX Platforms Untar the file by typing . For example: tar -xvf filename.tar tar -xvf ee60sol.tar This command unpacks the server files and creates a temporary directory structure under the current directory. Unpacking the file may take a little time. When the files are unpacked, you see a WebServer directory, and the following files: LICENSE.txt...
  • Page 28 Installing on UNIX Platforms Type to start the server installation. ./setup If you aren’t logged in as the user (superuser), or if you don’t have root sufficient write permissions, you’ll get one or more error messages. A welcome screen appears. Press Enter to continue with the installation.
  • Page 29 Installing on UNIX Platforms Server Core. Installs the Administration Server and the first instance of Enterprise Server. Java Runtime Environment. If you are planning to use the Administration Server and/or Java and servlets support, you must have a Java Runtime Environment (JRE) or a Java Developer’s Kit (JDK), also known as Java 2 Software Development Kit (SDK).
  • Page 30 Installing on UNIX Platforms Enter the Administration Server user name and password to use for authentication. You are asked to enter your password twice. Type the Administration Server port number or accept the default of 8888. Make sure you remember the port number for the Administration Server. For the most flexibility, choose a port number above 1024.

  • Page 31: Express Installation

    Installing on UNIX Platforms If the JDK libraries and CLASSPATH are stored in the default directories below the JDK directory ( , respectively), press Enter at the /jre/lib /lib JDK LIBPATH and JDK CLASSPATH prompts. If the libraries and CLASSPATH are stored in a different place on your system, enter the pathnames.
  • Page 32 Installing on UNIX Platforms Table 2-1 Express installation settings Installation Setting Value LDAP users and groups not using none Enterprise Server default JRE shipped with subcomponents All default subcomponents installed After installing, you can configure the server to use LDAP users and groups, and to use a JDK.

  • Page 33: Installing Across Multiple Machines

    Installing Across Multiple Machines For Express installation, this user must be . The group must be the group root to which belongs. root Enter the UNIX user name to use when running the Administration Server. In most cases, this user is root Enter the Administration Server user name and password to use for authentication.

  • Page 34: Using Templatized Installation

    Installing Across Multiple Machines Both methods are described in this section. • Using Templatized Installation • Using Silent Installation Using Templatized Installation To use templatized installation, enter the installation settings for each remote machine in a template file called . You can then use the template to template.inf install the web server on multiple machines from a single session on your local machine.
  • Page 35 Installing Across Multiple Machines In the directory of each remote machine where you will /etc/hosts.equiv install the web server, create an entry for your local machine using the format local_machine_name For example, if the local machine name is on the domain chewbacca example enter the following information:...
  • Page 36 Installing Across Multiple Machines ServerRoot: the directory where your server will be installed. For example: /usr/netscape/servers JRE_DIR: If you are installing the JRE shipped with the Enterprise Server, the directory where it is installed. For example: /usr/netscape/servers/bin/https/jre HttpDocRoot: The document root of the Enterprise Server instance. For example: /usr/netscape/servers/docs For the core server, enter the following:...
  • Page 37 Installing Across Multiple Machines The following is an example of the file: template.inf [ MachineName] HostNames =host1,host2 Components=Nescore,jre,java,snmp,search SetUpLocation=/usr/netscape/downloads [host1] InstallType= SuiteSpotUserID= SuitespotGroup= SecurityCheck= False RequireDomain= False InstallWhich= ServerRoot=/usr/netscape/servers HttpDocRoot= JRE_DIR= [host2] InstallType= SuiteSpotUserID= SuitespotGroup= SecurityCheck= False RequireDomain= False InstallWhich= ServerRoot=/usr/netscape/servers JRE_DIR= HttpDocRoot=/usr/netscape/servers/docs...

  • Page 38: Using Silent Installation

    Installing Across Multiple Machines Using Silent Installation Silent installation is a less efficient way than templatized installation to install multiple instances of Enterprise Server because remote instances of the server are installed one by one rather than several at a time. You use silent installation to create a file of responses to the setup program’s prompts, then edit the file and use it to install future Enterprise Server installations.
  • Page 39 Installing Across Multiple Machines The server is installed. The following is an example of an file. install.inf [General] FullMachineName= host1.example.com SuiteSpotUserID= root SuitespotGroup= root SecurityCheck= False RequireDomain= False ServerRoot= /usr/netscape/servers Components= WebServer [WebServer] Reinstall= False AdminPort= 8888 HttpPort= HttpDocRoot= /usr/netscape/servers/docs AdminSysUser= root AdminName=...

  • Page 40: Using Uninstall On Unix

    Using Uninstall on UNIX Table 2-2 Silent Installation Parameters Parameter Name ServerRoot The directory where you install the server. AdminPort The Administration Server port. HttpPort The port of the default Enterprise Server instance. HttpDocRoot The document root of the Enterprise Server instance. AdminSysUser The user ID used when running the Administration Server.
  • Page 41 Using Uninstall on UNIX Select all subcomponents and press Return. The subcomponents are uninstalled and you return to the command prompt. NOTE The uninstall program does not remove every server file. For example, it does not remove keys and certificates, configuration files, logs, ACL files or the document root.
  • Page 42 Using Uninstall on UNIX Netscape Enterprise Server Installation and Migration Guide • December 2001...

  • Page 43: Chapter 3 Installing Enterprise Server On Windows Nt

    Chapter 3 Installing Enterprise Server on Windows NT This chapter tells you how to install Netscape Enterprise Server on Windows NT. It contains the following sections: • Installing on Windows NT • Using Silent Installation • Using Uninstall on Windows NT Installing on Windows NT The following sections describe the installation of the Enterprise Server.

  • Page 44: Unpacking The Files

    Installing on Windows NT • If you have previous versions installed, shut down the Administration Server and Enterprise Server instances before installing Enterprise Server 6.0. • If you install both Netscape Directory or Messaging Server and Enterprise Server on the same machine, during the web server installation when you are asked which version of libraries to install, always select those which have the most recent release dates, except for system32\libplc.dll...
  • Page 45 Installing on Windows NT Typical and Custom installation give you more options, and for this release, do the same thing. If you chose Express installation, the following settings are set automatically for you. If you want to have different values for these settings, choose Typical or Custom installation.
  • Page 46 Installing on Windows NT NOTE By default, the installer installs a default set of subcomponents. If you want to change the subcomponents you install, click Change and continue to Step 7. If you did not change subcomponents or if you’ve completed your subcomponent selections, click Next to continue to Step 8.
  • Page 47 Installing on Windows NT Search and Indexing Support. Install this subcomponent to search the contents and attributes of documents on the server. As the server administrator, you can create a customized text search interface tailored to your user community. SNMP Support. Install this subcomponent if you are planning to use SNMP to monitor your servers.
  • Page 48 Installing on Windows NT For more information on ports, see “Choosing Unique Port Numbers” on page 17. Type the path for the default server’s primary document directory, where your server’s content files (the images, HTML documents and data you want to present to users accessing the server) will reside.

  • Page 49: Using Silent Installation

    Using Silent Installation To configure your Enterprise Server, use the URL: server_name:administration_port http:// For example: http://www.example:8888 Enter your administration user name and password to administer the server. You can now configure your server. For more information, see the Netscape Enterprise Server Administrator’s Guide. Using Silent Installation If you want to install several Enterprise Servers, you can use silent installation to create a file of responses to the setup program’s prompts.
  • Page 50 Using Silent Installation From the command line, run setup with the -k option, which creates a file called that contains all your responses to the installer’s prompts. install.inf At the command prompt, type: setup.exe -k Answer the installer prompts and install Enterprise Server. When the server is installed, go to the server_root directory, where you’ll /setup...

  • Page 51: Using Uninstall On Windows Nt

    Using Uninstall on Windows NT The following table shows some useful install.inf parameters to edit. For best results, do not edit any parameters except those listed in the table. Silent Installation Parameters Table 3-1 Parameter Name ServerRoot The directory where you install the server. AdminPort The Administration Server port.
  • Page 52 Using Uninstall on Windows NT The uninstall program uninstalls the server. You see a window showing the progress of the uninstall. When the uninstall is complete, a message appears saying that the configuration files have not been deleted, and that you should rename them before reinstalling the server.

  • Page 53: Chapter 4 Migrating Your Enterprise Server

    Chapter 4 Migrating Your Enterprise Server You can migrate the following iPlanet Web Server 4.x information to work with Enterprise Server 6.0. • All user and group information stored in a local database (if you choose to migrate it) • Document roots and any other directory mappings •...

  • Page 54: Enterprise Server 6.0 Changes

    Enterprise Server 6.0 Changes When you migrate information from iPlanet Web Server 4.x to 6.0, Enterprise Server the changes are made in the following areas: • Configuration Files • JavaServer Pages • Java Servlets • Java Configuration Files • Simple Session Manager •...

  • Page 55: Javaserver Pages

    JavaServer Pages iPlanet Web Server 4.0 JavaServer Pages (JSPs) were written in JSP 0.92. The iPlanet Web Server 4.1 and Enterprise Server 6.0 JSPs are written in JSP 1.1. Version 0.92 is no longer supported in 6.0. JSPs must be rewritten according to Enterprise Server the version 1.1 standard.

  • Page 56: Virtual Servers

    If your iPlanet Web Server 4.x web application specified MMapSessionManager the class name for the session manager, the application remains unchanged. Virtual Servers iPlanet Web Server 4.x you could create multiple server instances using hardware and software virtual servers, but these instances were required to share the same configuration information.

  • Page 57: Start And Stop Scripts

    • directives: NameTrans es-search-nametrans publisher document-root Start and Stop Scripts If you’ve made modifications to your start or stop scripts in iPlanet Web Server 4.x, those changes will not be carried forward by the migration program. Symbolic Links in Configuration Files (UNIX and Linux) Symbolic or relative links in server configuration files may cause problems when upgrading.

  • Page 58: The Migrate Server Page

    detects whether there are server instances installed in the Enterprise Server directory you specified and displays the servers you can migrate in a section of the page called “Installed Servers.” The Administration Server cannot be migrated. Choose a server from the drop-down list and click Migrate. A new window appears showing the migration parameters.

  • Page 59: Migrating The Administration Server

    Migrating the Administration Server You can only migrate individual server instances. You cannot migrate your administration server. After you have migrated your instances, you need to server set up features such as distributed administration and clusters again in your Enterprise Server 6.0 Administration Server. When you migrate a server instance, you have the option of migrating user and group information, which spans multiple server instances.

  • Page 60: Migrating Certificates

    If you had ACLs set up in your Administration Server 4.x for distributed administration, these ACLs are not migrated. You must add them manually to your new Administration Server. Migrating Certificates The migration process copies the database files in the 4.x_server_root https-server_id directory, such as , to the...

  • Page 61: Migrating Nsapi Applications

    Migrating NSAPI Applications Most NSAPI programs you used with iPlanet Web Server 4.x will work in 6.0 without being recompiled. Some undocumented data Enterprise Server structures have been moved out of and are no longer public. Going nsapi.h forward, if your plugins use any of these data structures, you should re-write them to use accessor functions.
  • Page 62 Server-side Java Applets (HttpApplets) Server-side Java applets (HttpApplets) are not supported. Instead use Java servlets. You will need to rewrite your server-side Java applets as servlets and reinstall them. Netscape Enterprise Server Installation and Migration Guide • December 2001...
  • Page 63 Index SYMBOLS .default files 54, 61 Directory Server, installing 20 .properties files 55 documentation, related 9 ACLs, migrating 59 hardware requirements 12 UNIX 13 administration server, migrating settings 59 Windows NT 13 HP-UX, version 12 HTTP Java applets, migrating 62 browser requirements 13, 14 IBM AIX, version 12 install.inf 38...
  • Page 64 express 31 users and groups 59 typical or custom 27 virtual servers 56, 59 uninstall 40 MMapSessionManager 56 user account needed for 25 Windows NT 43 uninstall 51 NESSessionManager 55 Netscape Communicator 19 nobody user account 15 Java applets, migrating 62 NSAPI applications, migrating 61 Java configuration files 54 Java Server Pages, migrating from 4.0 55...
  • Page 65 users and groups, migrating 59 search, migrating 60 server name aliases 15 changing 15 CNAME and 15 virtual servers, migrating 56, 59 server user account 15 servers, removing 40, 51 servlets, migrating 55, 61 silent installation 33, 38, 49 Simple Session Manager 55 web.xml 54 software requirements 12 web-apps.xml 54...
  • Page 66 Netscape Enterprise Server Installation and Migration Guide • December 2001...

This manual is also suitable for:

Netscape management system 6.0

Table of Contents