Sun Microsystems iPlanet Web Server, Installation Manual

Page 1: ...Installation Guide iPlanet Web Server FastTrack Edition Version4 1 June 2000 ...

Page 2: ...CH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID ________________________________________________________________________________________ Copyright 2000 Sun Microsystems Inc Pour certaines parties préexistantes Copyright 2000 Netscape Communication Corp Tous droits réservés Sun Sun Microsystems et the Sun logo iPlanet and the iPlanet logo sont des marques de fabrique ou des marques déposées de Sun Mi...

Page 3: ...e Edition 10 More Information 11 Supported Platforms 11 Required Patches 11 Hardware and Software Requirements 12 Unix 12 Windows NT 12 Linux 13 Other Technical Requirements 14 Creating a DNS Alias for the Server 14 Unix and Linux User Accounts for the Server 14 Windows NT User Accounts for the Server 15 Choosing Unique Port Numbers 16 Installation Overview 17 Installing Netscape Communicator 17 I...

Page 4: ...ter 3 Installing iPlanet Web Server FastTrack Edition on Windows NT 35 Installing on Windows NT 35 Unpacking the Files 36 Running setup exe 36 Using Uninstall on Windows NT 41 Chapter 4 Installing iPlanet Web Server FastTrack Edition on Linux 43 Installing on Linux 43 Logging In as the Correct User 43 Unpacking the Files 44 Running Setup 45 Typical or Custom Installation 45 Express Installation 49...

Page 5: ...s Guide Document Conventions Where to Find This Guide Online How to Use Online Help Where to Find Related Information What You Need to Know The guide assumes that you are a server administrator with a general understanding of the following The Internet and the World Wide Web The iPlanet Web Server architecture as explained in the iPlanet Web Server Administrator s Guide ...

Page 6: ...pe is used for book titles emphasis letters as letters for example Spell it with a T and words as words for example The word server is in every product name If you want to do this See this chapter Find out what you need to do before installing the server including installing other products required by the server Chapter 1 Before You Install iPlanet Web Server FastTrack Edition Get step by step ins...

Page 7: ...w s user interface fields You can then navigate to other parts of the help document as well as the entire documentation set The installation programs do not have online help but some migration screens do To move to the top of whatever major part of online help you re in and gain access to navigational buttons and to a Contents Index and DocHome list of resources click the arrow button to the left ...

Page 8: ...allation Guide June 2000 These are the iPlanet Web Server FastTrack Edition documents that are available iPlanet Web Server Administrator s Guide Programmer s Guide for iPlanet Web Server NSAPI Programmer s Guide Programmer s Guide to Servlets in iPlanet Web Server Release Notes ...

Page 9: ... Platforms Required Patches Hardware and Software Requirements Other Technical Requirements Installation Overview Installing Netscape Communicator Installing Netscape Directory Server Installing Netscape Console Installing a Java Developer s Kit Accessing iPlanet Web Server from the Netscape Console iPlanet Web Server FastTrack Edition Overview iPlanet Web Server FastTrack Edition is the perfect w...

Page 10: ...h limits use to low traffic environments or development Security The FastTrack Edition SSL encryption level is only 56 bit making it less functional for highly secure environments High Availability FastTrack Edition s multiprocess mode has been disabled so process failover on Unix is not an option as it is in Enterprise Edition The Intelligent Load Balancing Plug in is also not available for FastT...

Page 11: ...ml Table 1 1 Supported Platforms Operating System Architecture Required Memory Required Disk Space Compaq Tru64 UNIX 4 0d 4 0e and 4 0f supported through binary compatibility Alpha 64 MB minimum 110 MB minimum Hewlett Packard HP UX 11 0 11 0 64 supported through binary compatibility PA RISC 64 MB minimum 110 MB minimum IBM AIX 4 3 3 Power PC 64 MB minimum 110 MB minimum Sun Solaris 8 Solaris 2 6 a...

Page 12: ...orary Internet Files section click Settings Click the radio button to check for newer versions of stored pages every visit to the page A Unix user and group that have the appropriate permissions for running iPlanet Web Server This user is different from the user that runs the Administration Server Often people use the user nobody and group nobody for this purpose but you can also create a specific...

Page 13: ...Installing a Java Developer s Kit on page 18 Linux 256 MB swap space 10 MB of disk space for log files Netscape Communicator 4 61 or higher or Microsoft Internet Explorer 4 01 Java JavaScript and cookies enabled in your browser 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 c...

Page 14: ... 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 Later you can change the actual hostname or IP address of the server machine without having to change all URLs that point to the server machine For example you might call the server my_server my_company com and then use an alias like www...

Page 15: ...missions to the configuration files for all installed servers However it s much easier to run the Administration Server as root because then the Administration Server user can start and stop servers with port numbers less than 1024 Port numbers greater than 1024 can be started by any user The user you use to run the iPlanet Web Server often nobody must be in the same group as the user you use to r...

Page 16: ...tion Server is not the same as the Netscape Administration Server shipped with the Netscape Console The standard web server port number is 80 and the standard SSL enabled web server port number is 443 but you can install iPlanet Web Server to use any port If you use a port other than the default port port 80 the URL used to gain access to your home page changes For example if your computer is call...

Page 17: ...ll one 3 If you are planning to use users and groups for access control and you do not have a Directory Server installed install it When you install Directory Server you also install Netscape Console 4 Make a note of the LDAP URL associated with your Directory Server because you will need it during the installation process 5 Install and configure iPlanet Web Server Installing Netscape Communicator...

Page 18: ...Server from the Netscape Console on page 20 If you are not planning to use Directory Server you do not need to install Netscape Console Installing a Java Developer s Kit If you are planning to use Java you must install a Java Runtime Environment JRE or a Java Developer s Kit JDK iPlanet Web Server includes a JRE that you can install during the installation process However you may prefer to install...

Page 19: ...dk download index html Compaq Tru64 UNIX requires JDK 1 2 2 3 or higher Download a JDK at http www compaq com java Windows NT requires a JDK of 1 2 2_01 or higher Download a JDK at http java sun com jdk Linux requires a JDK of 1 2 2 or higher release candidate 4 or later Download a JDK at http www blackdown org You can install the JDK before you install iPlanet Web Server and provide the path to i...

Page 20: ...b_admin_port ldaphost hostname ldapport ldap_port basedn basedn binddn binddn bindpwd bind_password For example perl installMCC root usr netscape server4 host austen red iplanet com port 8888 ldaphost siroe red iplanet com ldapport 389 basedn siroe com binddn cn Directory Manager bindpwd password 3 Copy the files entserve41 jar and entserv41_en jar from server_root bin https jar to server_root jav...

Page 21: ...pped With Solaris 8 If you are installing iPlanet Web Server FastTrack edition from the iPlanet Advantage Software CD shipped with Solaris 8 the installer is different from the one described in this Guide For installation information see the notes on the iPlanet Advantage Software CD CAUTION You must install your version 4 x servers in a server root directory separate from the server root director...

Page 22: ...till prefer to log in as root even though you meet the conditions Unpacking the Files To get the iPlanet Web Server files and unpack them follow these steps 1 Download the file from http www iplanet com and save it in a temporary directory 2 Change to the directory on your Unix machine where you copied the file Unpack the gz file by typing gunzip filename tar gz The file name is in the format fast...

Page 23: ...staller you can use the following commands Press the Enter key to accept defaults specified in brackets for example All Press CTRL b to return to a previous screen note that this sequence does not work on all screens Press CTRL c to cancel the installation program Enter comma separated lists of numbers when you want to select multiple items for example 1 2 3 Typical or Custom Installation Most use...

Page 24: ...is in the same directory as the setup program 5 Choose Typical or Custom Press Enter 6 Type a server root directory or accept the default usr netscape server4 This directory is where the server files and directory structure will be installed You need to run the server as a user that has write access to this directory for example the directory owner 7 Choose all components Press Enter 8 Choose the ...

Page 25: ...lanet Web Server The default user and group is nobody 11 Enter the Unix user name to use when running the Administration Server In most cases this user is root 12 Enter the Administration Server user name and password to use for authentication You are asked to enter your password twice This user is not a Unix user but a user name and password in the Directory Server You must make sure that the Adm...

Page 26: ...hin the stated range 1024 to 65535 If you are installing as root you can use port numbers below 1024 If you use a port other than the default port port 80 the URL used to gain access to your home page will change For example if your computer is called www iplanet com and you choose port 9753 your server s URL will be http www iplanet com 9753 For more information on ports see Choosing Unique Port ...

Page 27: ...pts 19 After the installation program extracts and installs the iPlanet Web Server components press Enter 20 Go to the https admserv directory under your server root directory for example usr netscape server4 and start the Administration Server by typing start You can also type startconsole in the server root directory startconsole starts the Administration Server and launches a browser to the Adm...

Page 28: ...p to start the server installation A welcome screen appears 3 Press Enter to continue with the installation 4 Choose whether you accept the software license agreement by entering Yes to accept or No to decline If you have not yet read the license agreement cancel out of the installation and read the file LICENSE txt that is in the same directory as the setup program Table 2 1 Express installation ...

Page 29: ...pe Directory Server you must make sure that the Administration Server user exists in the Directory Server and that it has access permissions to the Directory Server to perform user and group management tasks 11 After the installation program extracts and installs the iPlanet Web Server components press Enter 12 Go to the https adminserv directory under your server root directory for example usr ne...

Page 30: ...f that contains all your responses to the installer s prompts At the command prompt type setup k 2 Answer the installer prompts and install iPlanet Web Server 3 When the server is installed go to the server_root setup directory where you ll find the install inf file 4 Copy the install inf file to the directory where you will run setup to install your next iPlanet Web Serve 5 Edit the values in the...

Page 31: ... False RequireDomain False ServerRoot usr netscape server4 Components WebServer WebServer Upgrade False Reinstall False AdminPort 8888 HttpPort 1888 HttpDocRoot usr netscape server4 docs AdminSysUser annh AdminName admin AdminPassword password UgLdapUse Yes UgLdapUrl ldap test 389 o siroe com UgLdapName cn Directory Manager UgLdapPassword password JRE_DIR usr netscape server4 bin https jre USE_JDK...

Page 32: ... Web Server instance AdminSysUser The user ID used when running the Administration Server AdminName The user name used to access to the Administration Server s administration screens AdminPassword The password used to access to the Administration Server s administration screens UgLdapUse Yes and No indicate whether you are using the LDAP Directory Server UgLdapUrl The LDAP URL of the Directory Ser...

Page 33: ...prompt If you installed another 4 x server for example Netscape Directory Server or Messaging Server in the same directory as iPlanet Web Server follow these steps when uninstalling 1 Copy the uninstall script uninstall to another file for example uninstslapd 2 Use uninstall to uninstall iPlanet Web Server 3 Rename uninstslapd to uninstall 4 Use uninstall to uninstall Directory Server 4 1 CAUTION ...

Page 34: ...Using Uninstall on Unix 34 iPlanet Web Server FastTrack Edition Installation Guide June 2000 ...

Page 35: ...ons of Netscape or iPlanet web servers installed you must install your 4 x iPlanet Web Server in a different server root directory If you have an iPlanet Web Server 4 1 Enterprise Edition installed you must uninstall it before you can install the FastTrack Edition If you have previous versions of Netscape or iPlanet web servers installed shut down the Administration Server and Enterprise Server in...

Page 36: ...uble click the setup exe file if you downloaded the file this happens automatically when you double click the downloaded file 2 The Welcome screen appears After reading the Welcome screen click Next 3 The Software License Agreement appears Click Yes to accept the license 4 The Select Installation Type screen appears Choose the kind of installation you want Express Typical or Custom Express install...

Page 37: ...older Click Next 6 The Components to Install dialog box appears Select iPlanet Web Server FastTrack Edition from the list Note that because the Administration Server is now an iPlanet Web Server instance it is installed automatically when you install iPlanet Web Server and is not a choice on this product list Table 3 1 Express installation settings Installation Setting Vales administration port 88...

Page 38: ... install the Administration Server and the first instance of iPlanet Web Server Java Runtime Environment If you are installing Java and servlets support you must have a JRE or a JDK You can install the supplied JRE subcomponent or use a JDK already installed on your system If you want to use your own JDK you ll need to supply the path to it later in the installation For more information see Instal...

Page 39: ...ort is 8888 For more information on ports see Choosing Unique Port Numbers on page 16 Click Next 10 The Default Web Server dialog box appears A default instance of iPlanet Web Server is installed automatically Type a port number for the default instance of your iPlanet Web Server This port should be different than the Administration Server port If you use a port other than the default port port 80...

Page 40: ...stalled the JDK on your system If you want to use a Library path or Classpath that is different than the default for your JDK enter a different path here 13 The Configuration Summary dialog box appears This dialog box contains information about the settings for your iPlanet Web Server and Administration Server It also contains a list of the iPlanet Web Server components you selected for installati...

Page 41: ...eb Server 1 Go to your server root and double click on the program uninst exe 2 The iPlanet Uninstall window appears This window lists all the iPlanet and Netscape servers installed in this directory Click the checkbox next to iPlanet Web Server FastTrack Edition and click Uninstall Note that uninstalling iPlanet Web Server automatically uninstalls the Administration Server since it is an instance...

Page 42: ...ce you restart as part of the uninstall process you do not need to do a separate restart If you install another 4 x server for example Netscape Directory Server or Messaging Server on the same machine as iPlanet Web Server you should have no problems uninstalling any server if you install the servers in the same directory If you install the servers in different directories you need to uninstall iP...

Page 43: ...e the installation of the iPlanet Web Server Logging In as the Correct User Before you install the server you must log in as root unless you meet both of these conditions You plan to install the server on a port greater than 1024 The location where you plan to install the server the server root directory is writable with your non root login CAUTION Do not install iPlanet Web Server on an NFS mount...

Page 44: ...format fasttrack 4 1 security internationalization platform tar gz For example fasttrack 4 1 domestic us i686 intel linux tar gz 3 Untar the unzipped file by typing tar xvf filename 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 an Enterprise directory an...

Page 45: ...mmands Press the Enter key to accept defaults specified in brackets for example All Press CTRL b to return to a previous screen note that this sequence does not work on all screens Press CTRL c to cancel the installation program Enter comma separated lists of numbers when you want to select multiple items for example 1 2 3 Typical or Custom Installation Most users should install the Typical or Cus...

Page 46: ...onents to install If you do not install a subcomponent and later decide you want to use it you can run the installer again to install just the missing subcomponent However you cannot uninstall individual subcomponents once they are installed By default all subcomponents are installed The subcomponents you can choose to install are described in the following numbered sections 1 Server Core Installs...

Page 47: ...ke sure that the Administration Server user exists in the Directory Server and that it has access permissions to the Directory Server to perform user and group management tasks 13 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 If you want to use a ...

Page 48: ...ple ldap iplanet com 389 o siroe com The bind DN for example cn Directory Manager and the directory server password 16 Type the root directory where your server s content files the images HTML documents and data you want to present to users accessing the server will reside The default is server_root docs 17 If you want to use your own JDK enter Yes If you are installing Java support you must have ...

Page 49: ...nstalled startconsole starts Administration Server and launches a browser to the Administration Server administration pages If you have a Netscape Console installed startconsole starts the console For information about registering your iPlanet Web Server with the Netscape Console see Accessing iPlanet Web Server from the Netscape Console on page 20 21 To configure your iPlanet Web Server use the U...

Page 50: ...o start the server installation A welcome screen appears 3 Press Enter to continue with the installation Table 4 1 Express installation settings Installation Setting Value administration port 8888 administration URL http machine name adminisration port HTTP port number 80 document root server_root doc Linux user to run server root LDAP users and groups not using JDK none JRE default JRE shipped wi...

Page 51: ...t belongs 9 Enter the Linux user name to use when running the Administration Server In most cases this user is root 10 Enter the Administration Server user name and password to use for authentication You are asked to enter your password twice This user is not a Linux user but a user name and password in iPlanet Web Server If you are using a Netscape Directory Server you must make sure that the Adm...

Page 52: ...en edit the file install inf and use it to install future iPlanet Web Server installations Silent installation works best when you use the Typical installation and your installations are all similar To use silent installation follow these steps 1 Run setup with the k option which creates a file called install inf that contains all your responses to the installer s prompts At the command prompt typ...

Page 53: ...n install inf file General FullMachineName austen iplanet com SuiteSpotUserID annh SuitespotGroup staff SecurityCheck False RequireDomain False ServerRoot usr netscape server4 Components WebServer WebServer Upgrade False Reinstall False AdminPort 8888 HttpPort 1888 HttpDocRoot usr netscape server4 docs AdminSysUser annh AdminName admin AdminPassword password UgLdapUse Yes UgLdapUrl ldap test 389 o...

Page 54: ...rver AdminPort The Administration Server port HttpPort The port of the default iPlanet Web Server instance HttpDocRoot The document root of the iPlanet Web Server instance AdminSysUser The user ID used when running the Administration Server AdminName The user name used to access to the Administration Server s administration screens AdminPassword The password used to access to the Administration Se...

Page 55: ... prompt If you installed another 4 x server for example Netscape Directory Server or Messaging Server in the same directory as iPlanet Web Server follow these steps when uninstalling 1 Copy the uninstall script uninstall to another file for example uninstslapd 2 Use uninstall to uninstall iPlanet Web Server 3 Rename uninstslapd to uninstall 4 Use uninstall to uninstall Directory Server 4 1 CAUTION...

Page 56: ...Using Uninstall on Linux 56 iPlanet Web Server FastTrack Edition Installation Guide June 2000 ...

Page 57: ...e_name domain com and make sure the server is listed in DNS If that doesn t work use the IP address The port is in use Most likely you didn t shut down a server before you migrated the settings from a previous version Shut down the old server then manually start the new one The port might also be used by another installed server Make sure the port you ve chosen isn t already being used by another ...

Page 58: ...rrors when you try to run Java To correct this problem run the iPlanet Web Server installation program again and choose to install the JRE or install a JDK and point your server to it using the Configure JRE JDK Paths page on the Servlets tab For more information on JRE and JDK see Installing a Java Developer s Kit on page 18 I received an error during installation and the installation did not com...

Page 59: ...an out of space either on your hard disk or in the registry You should first make sure you have plenty of free space on your hard disk if you do then Windows NT may have filled up its registry You can check this by going to your control panels opening System clicking the Performance tab and clicking Change in the Virtual Memory section The window that comes up shows the current registry size and t...

Page 60: ...Troubleshooting Windows NT 60 iPlanet Web Server FastTrack Edition Installation Guide June 2000 ...

Page 61: ...rements Linux 13 Unix 12 Windows NT 12 HP UX version 11 I IBM AIX version 11 installing Communicator 17 core component 25 46 Directory Server 18 from a script 30 52 JDK 18 JRE 25 38 46 Linux 43 express 49 typical or custom 45 uninstall 54 Netscape Console 18 preparation for 9 Unix 21 express 27 typical or custom 23 uninstall 32 user account needed for 22 43 Windows NT 35 uninstall 41 J JDK obtaini...

Page 62: ... requirements 11 port in use error message 57 port numbers 16 R Red Hat Linux version 11 S server name aliases 14 changing 14 CNAME and 14 server user account 14 servers removing 32 41 54 silent installation 30 52 slow performance on Unix 58 SNMP Unix and Linux user for 15 Sun Solaris version 11 T technical requirements 14 U uninstall 54 Linux 54 Unix 32 Windows NT 41 Unix installation 21 Unix use...