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

Netscape ENTREPRISE SERVER 6.1 - 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.1
April 2002 (Draft)

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

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

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

  • Page 1 Installation and Migration Guide Netscape Enterprise Server Version 6.1 April 2002 (Draft)
  • 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 Installing from an Netscape Enterprise Server CD ........24 Running Setup .
  • Page 5 Index ............... . . 63...
  • Page 6 Netscape Enterprise Server Installation and Migration Guide • April 2002 (Draft)

  • Page 7: About This Guide

    About This Guide This guide explains how to install Netscape® Enterprise Server 6.1 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 • April 2002 (Draft)

  • 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 Sun® Solaris™ 2.6; Solaris 8 Ultra SPARC™ 128 MB 150 MB minimum minimum Microsoft® Windows NT Intel® Pentium® 128 MB 150 MB version 4.0 with Service Pack...

  • Page 13: Windows Nt/Windows 2000

    Hardware and Software Requirements • 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. On the General tab, in the Temporary Internet Files section, click Settings.

  • Page 14: Other Technical Requirements

    Other Technical Requirements • A Java Development Kit (JDK), also known as a Java 2 Software Development Kit (SDK) installed on your system if you plan to use uncompiled Java Server Pages (JSPs). See the Netscape Enterprise Server Release Notes for the required version level.

  • Page 15: Unix And Linux User Accounts For The Server

    Other Technical Requirements UNIX and Linux User Accounts for the Server When the Enterprise Server starts, it runs with a UNIX or Linux user account that you specify during installation. Any child processes of the server are created with this account as the owner. It is best to create a UNIX or Linux account for the server that has restricted access to your system resources.

  • Page 16: Windows Nt User Accounts For The Server

    Other Technical Requirements Windows NT User Accounts for the Server You should create a Windows NT user account for your Enterprise Server. It should have restricted access to your system resources and run under a nonprivileged system user account (one that has a limited set of system permissions to your system).
  • Page 17 Other Technical Requirements Make sure the port you choose isn’t already in use. On UNIX and Linux systems, you can check the file on the server machine to make sure you /etc/services don’t assign a port number that is reserved for another service. If you choose a port that is currently being used by another service, the installation program prompts you for another port.

  • 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 6.1 and Directory Server 6.x cannot exist in the same CAUTION directory.

  • Page 21: Installing A Java Developer's Kit

    Installing a Java Developer’s Kit Enterprise Server CAUTION 6.1 and Directory Server 6.x cannot exist in the same directory. If you plan to install Directory Server 6.x on the same machine as Enterprise your web server, you must install it in a different directory than Server 6.1.
  • Page 22 Installing a Java Developer’s Kit After installation, you can change the JRE or JDK Enterprise Server uses. In the Administration Server, on the Global Settings tab, use the Configure JRE/JDK Paths page. You can also change the path to the JRE/JDK in this page. Netscape Enterprise Server Installation and Migration Guide •...

  • Page 23: 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 24: 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 25: 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. Chapter 2 Installing Netscape Enterprise Server on UNIX...
  • Page 26 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 27 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 28 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 29: 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 30 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 31: 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 32: 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 33 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 34 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 35 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 36: 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 37 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 38: 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 39 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 40 Using Uninstall on UNIX Netscape Enterprise Server Installation and Migration Guide • April 2002 (Draft)

  • Page 41: 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 42: 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.1. • 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 43 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 44 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 45 Installing on Windows NT NOTE When installing on Windows NT/Windows 2000, the JDK runtime path must use the following format: j2sdk_home/bin;j2sdk_home/jre/bin/server;j2sdk_home/jre/bin /classic Java Support. Install this subcomponent if you are planning to use the Administration Server and/or Java and servlets. Search and Indexing Support.
  • Page 46 Installing on Windows NT Type a port number for the default instance of your Enterprise Server. This port should be different than the Administration Server port. If you use a port other than the default port (port 80), the URL used to gain access to your home page will change.

  • Page 47: Using Silent Installation

    Using Silent Installation NOTE You should not cancel the installation process while the files are being copied. If you do, you will have a partial installation you need to clean up. Enterprise Server If an uninstaller for exists, use it to uninstall the portion Enterprise Server you installed.
  • Page 48 Using Silent Installation When you launch the installer, it unpacks the files to your directory. TEMP Without exiting the installer, go to the directory and copy the installation TEMP files to another location. Once the files are copied, exit the installer. You now have a copy of that you can use for creating the setup.exe...
  • Page 49 Using Silent Installation [General] Components=svrcore,WebServer ServerRoot=D:\netscape\servers [WebServer] Components=NESCore,JRE,Java,Cleanup AdminPort=8888 HttpPort=80 HttpDocRoot=D:\netscape\servers\docs AdminName=admin AdminPassword=admin [Java] JRE_DIR=D:/netscape/servers/bin/https/jre [Cleanup] Archive=cleanup.zip Chapter 3 Installing Enterprise Server on Windows NT...

  • Page 50: 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. Table 3-1 Silent Installation Parameters Parameter Name ServerRoot The directory where you install the server. AdminPort The Administration Server port.
  • Page 51 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 52 Using Uninstall on Windows NT Netscape Enterprise Server Installation and Migration Guide • April 2002 (Draft)

  • 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.1. • 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.1 Changes

    Enterprise Server 6.1 Changes When you migrate information from iPlanet Web Server 4.x to 6.1, 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 were written in JSP 1.1. Enterprise Server 6.1 JSPs are written in JSP 1.1. Version 0.92 is no longer supported in Enterprise Server 6.1.

  • Page 56: Virtual Servers

    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. With Enterprise Server 6.1, you can set up multiple classes of virtual servers. Each class has separate 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.1 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 Enterprise Server 6.1 without being recompiled. Some undocumented data 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) 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 • April 2002 (Draft)
  • 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 12 administration server, migrating settings 59 Windows 2000 13 Windows NT 13 HTTP Java applets, migrating 62 browser requirements 12, 13 install.inf 36 installing...
  • Page 64 typical or custom 25 MMapSessionManager 55 uninstall 38 user account needed for 23 Windows NT 41 uninstall 50 NESSessionManager 55 Netscape Communicator 19 nobody user account 15 NSAPI applications, migrating 61 Java applets, migrating 62 Java configuration files 54 Java Server Pages, migrating from 4.0 55 Java servlets, migrating 55, 61 JDBCSessionManager 55 obj.conf,obsolete directives 56...
  • Page 65 changing 14 CNAME and 14 virtual servers, migrating 56, 59 server user account 15 servers, removing 38, 50 servlets, migrating 55, 61 silent installation 31, 36, 47 Simple Session Manager 55 software requirements 12 web.xml 54 start script, and migrating 57 web-apps.xml 54 stop script, and migrating 57 Windows NT installation 41...
  • Page 66 Netscape Enterprise Server Installation and Migration Guide • April 2002 (Draft)

This manual is also suitable for:

Entreprise server 6.1

Table of Contents