Sun Microsystems iPlanet Web Server manual

Installation Guide iPlanet Web Server, FastTrack Edition V ersion 4.1 June 2000[...]

Copyright © 2000 Sun Micros ystems, Inc. Some preexis ting portions Copyright © 2000 Netscape Communications Corporation. All rights reserved. Sun, Su n Micros ystems, an d t he S un logo, iP la net , a nd th e iP la net lo go a re tr ademark s or regist ere d trademarks of S un Microsy stems, Inc. in the United States and other countries. Netsca[...]

3 Contents About This G uide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 What You N eed to Know . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 What’s in This Guide . . . . . . . .[...]

4 iPlanet W eb Serve r, FastTr ack Editi on Instal lation G uide • June 20 00 Chapter 2 Install ing iPlane t Web Server, F astTrack Edition on Unix . . . . . . . . . . . . . . . . . . 21 Installin g on U nix Pla tforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Inst[...]

5 About This Guide This guide explains ho w to instal l iPlanet™ Web S e rv er, FastTrack Edition . This preface conta ins the following sections: • What You Need to Know • What’s in Th is Guide • Document Con vention s • Where to Find This G uide On line • How to Use Online Help • Where to Find Related Information What You Need to [...]

What’s in This Guide 6 iPlanet W eb Serve r, FastTr ack Editi on Instal lation G uide • June 20 00 What’s in This Guide The iPlanet Web Se rv er Installation Guide covers the information you need to install iPlanet Web Server on your system. Document Conventions This guide uses the following conventions: • When this document refers to iPlan[...]

Where to Find This Guide Online About Th is Guide 7 • Brackets ([]) are used to encl ose parameters that are optional. • A slash (/) is used to separa te directories in a path. (Windows NT supports both the slash and the backslash.) Where to Find This G uide O nline You ca n f ind the iPlanet We b Server Installat ion Guide onl ine in PDF an d [...]

Where t o Find Rel ated Info rmatio n 8 iPlanet W eb Serve r, FastTr ack Editi on Instal lation G uide • June 20 00 These are the iPlanet Web Server, FastTrack Edition do cuments that are available: • iPla net Web Se rver Admi nist rat or’s Guid e • Programm er’s Guide for iPlanet Web Ser ve r • NSAPI Programmer’s Guide • Program me[...]

9 Cha pter 1 Before You Install iPlanet Web Server, FastTrack Edition The following sections discu ss the informat ion you need to kno w before you instal l iPlanet Web Server, FastTrack Edition. This chapter contains the f ollowing sections: • iPlanet Web Server, FastTrack Edition Overview • Supported Platforms • Required Patches • Hardwar[...]

iPlanet W eb Serv er, FastT rack Editi on Overvi ew 10 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 iPlanet Web Server, FastTrack Edition is easy to use, and comes with built-in support for Java, SSL, and LDA P. Because it shares a common code base with iPlanet Web Server, Enterprise Edition, applications developed fo [...]

Support ed Platfor ms Chapter 1 Before You Insta ll iPlanet Web Serv er, Fa stTrack E dition 11 More Information For a full description of the iPlanet Web Server, En terprise Edition, see: http://www.iplanet.com/products/infras tructure/web_servers/index.html Suppor te d Plat fo rm s iPlanet Web Server, FastTrack Edition runs on these platforms: Re[...]

Hard ware and S oft war e Requ ir emen t s 12 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 Hardware an d Softwa re Requir eme nts In addition to the Unix, Linux, or Wind ows NT operation system. memory and disk space requirements listed above, your com puter must have the followi ng hardware and software: Unix • Swap[...]

Hardware and Software Req uirements Chapter 1 Before You Insta ll iPlanet Web Serv er, Fa stTrack E dition 13 • 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 co nfigure this setting, from the View menu, cho ose Internet Options. On the G eneral tab, in th e Tempo[...]

Other Te chnic al Requir ements 14 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 Other Technical Requireme nts Once you have the proper hardwar e and sof tware necessary to ins tall iPlanet We b Server, you should make sure that you meet the following requirements: • You know the host name and IP address of your serve[...]

Other Technical Req uirements Chapter 1 Before You Insta ll iPlanet Web Serv er, Fa stTrack E dition 15 In addition, the user acco unt you create for the server should belong to a group that contains the server users for all iPlanet servers so th at multiple servers can have access to sha red files. If you don’t create a dedicated user account fo[...]

Other Te chnic al Requir ements 16 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 During installation, the server uses the Lo calSystem account, not the user account you created. Once you start and run the server, you should use the user account you created. You can chan ge the user account for the server after the insta[...]

Installation Overview Chapter 1 Before You Insta ll iPlanet Web Serv er, Fa stTrack E dition 17 Installation Overview You can insta ll iPlanet Web Server by do wnloading it off the iPl an et web site. When you instal l iPla net Web Server, you follow th ese basic steps: 1. If you have an existing iPlanet W eb Server, Netscape Enterprise Server, or [...]

Installing Netscape Directory Ser ver 18 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 Installing Netscape Directory Server If you are planning to use users and groups (for exam ple, for access contro l) with your iPlanet Web Server, you need to install Netsca pe Directo ry Server before installing th e iPlanet Web Serv[...]

Installing a Java Deve loper’s Kit Chapter 1 Before You Insta ll iPlanet Web Serv er, Fa stTrack E dition 19 • Java servlets • server-side JavaScript database conn ectivity (LiveWire) You need a JDK to run th e following feature (it will not run with a J RE): • Java Server Pages (JSPs) Because you need a J DK to use JSPs, JSPs are only turn[...]

Acce ss ing i Pla net We b Ser ver fro m t he N etsc ape Cons ol e 20 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 Accessing iPlanet Web Server from the Netscap e Console If you want to be able to access the iPlanet Web Server f rom the Netscape Console, run the installMCC script after you install iPlanet Web Server an[...]

21 Cha pter 2 Installing iPlanet Web Server, FastTrack Edition on Unix This chapter tells you h ow to install iPlan et Web Server on Unix system s. It contains the follo wing sect ion s: • Instal ling on Un ix Platform s • Using Si lent Installa tion • Using U ninstall o n U nix Installing on Unix Platforms The following sections describe the[...]

Installing on Unix Platfor ms 22 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 Logging In a s the Correct User Before you install iPlanet Web Server, you must log in as root , unless you meet the following co nditions: • You plan to insta ll the iPlanet Web Server on a port higher th an 1024. • The location where yo[...]

Installing on Unix Platfor ms Chapter 2 Installing iPlanet Web Server, FastTrack Edition on Un ix 23 Running Setup You run the setup program to install iPlanet Web Server. During the installation process, you ha ve the choice of three kinds of in stallation: Express, Typical, or Custom. Most users should choose Typical or Custom (they are identical[...]

Installing on Unix Platfor ms 24 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 To run setup, follow these steps: 1. If you are not in the directory already, change to the directory where you unpacked the file. 2. Type ./setup to start the server installation. If you aren’t logged in as the root user (superuser), or if[...]

Installing on Unix Platfor ms Chapter 2 Installing iPlanet Web Server, FastTrack Edition on Un ix 25 2. Java Runt ime Environment If you are planning to use Ja va, you must have a Java Run time Environment (JRE) or a Java Developer’s Kit (JDK) . You can install the provided JRE, or supply your own JDK. For more infor mation, see “Install ing a [...]

Installing on Unix Platfor ms 26 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 13. Type the Administration S erver port number or accept the default of 88 88. Make sure you reme mber the port number for the Administration Server. For the most flexibility, choose a port num ber above 1024. If you want to use a port numbe[...]

Installing on Unix Platfor ms Chapter 2 Installing iPlanet Web Server, FastTrack Edition on Un ix 27 If you are installing Java 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. For more information, see “Installing a Java Developer’s Kit,” on page 18. 18. If yo[...]

Installing on Unix Platfor ms 28 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 The following table lists the as sumptions made by the Express insta llation. If you would like to use different in sta llation setting s, use Typical or Custom in stallation. After installing, you can configure the server to use LDAP users a[...]

Installing on Unix Platfor ms Chapter 2 Installing iPlanet Web Server, FastTrack Edition on Un ix 29 5. Choose Express and press Enter. 6. Type a server root director y or accept the de fault ( /usr/netscape/server4 ). This directory is where the server files and directory structure will be installed. root must have write access to this directory. [...]

Using Silent Installation 30 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 You can now configure your iPlanet Web Server. Fo r more information, see the iPla net Web Se rver Admin ist rat or’s Guid e . Using Silent Installation If you want to insta ll several iPlanet Web S ervers , you can use silent instal lation to [...]

Using Silent Installation Chapter 2 Installing iPlanet Web Server, FastTrack Edition on Un ix 31 The following is an example of an install .inf file. The following table shows some useful install.inf parameters to edit. For best results, do not edit any pa rameters except those list ed in the ta ble. [General] FullMachineName= austen.iplanet.com Su[...]

Using Uninstall on Unix 32 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 Using Uninstall on Unix You can remove iPlanet Web Server from your computer by using the uninstall applicatio n. SuiteSpotUs erID T he user ID used when ru nning the default in stance of t he iPlanet Web Server. SuiteSpotGroup The group the user r[...]

Using Uninstall on Unix Chapter 2 Installing iPlanet Web Server, FastTrack Edition on Un ix 33 To remove your iPlanet Web Server: 1. Go to your server root and type ./uninstall . A list of iPlanet and Netscape servers currently installed in this location appea rs. 2. Find iPlanet W e b Server in th e list a nd type the number next to it at th e pro[...]

Using Uninstall on Unix 34 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000[...]

35 Cha pter 3 Installing iPlanet Web Server, FastTrack Edition on Windows NT This chapter tells you h ow to install iPlan et Web Server. It conta ins the following sections: • Instal ling on Win dows NT • Using U ninstall o n Win dows NT Installing on Windows NT The following sections describe the ins tallat ion of the iPlan et Web Server . Any[...]

Installing on Windows NT 36 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 • Do no t install iPlanet W eb Server on an N FS-mounted drive due to pot ential security and file locking restrictions on remote partitions. • The server will unpack onto the drive designated by the TEMP environment variable. Make sure there [...]

Inst alli ng on Wi ndo ws NT Chapt er 3 Instal ling iPla net Web Server, Fas tTrack Edition on Windo ws NT 37 Click Next. 5. The Location of Installation dialog box appears. The d efault location for the server files is C:NetscapeServer4 , where C: is the letter of the drive o n which you are installing the server. If you want to install iPlanet [...]

Installing on Windows NT 38 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 If you did not change subcompo nents or if you’ve com p leted yo ur subcomponent selectio ns , click Next to continue to St ep 8. 7. If you clicked Change on the previous scre en, the Select Sub- Components dialog box appears. You can select a s[...]

Inst alli ng on Wi ndo ws NT Chapt er 3 Instal ling iPla net Web Server, Fas tTrack Edition on Windo ws NT 39 8. The iPlanet Web Server Administra tion Server Authentication dialog box appears. Type the user name fo r Administration Server access; the de fault is admin. Type the Ad ministration Server access password; type it again f or verificatio[...]

Installing on Windows NT 40 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 11 . The Using LDAP for Users and Group Adm inistration d ialog box appears. If you want to use LDAP, click the checkbox and specify the LDAP URL in the format ldap:// h ost name:p ort/ bas e DN . For exam ple, ldap://iplanet.com:389/o=siroe.com .[...]

Using Uninstall on Windows NT Chapt er 3 Instal ling iPla net Web Server, Fas tTrack Edition on Windo ws NT 41 14. Click F inish. 15. Restart your machine or use the Services Control Panel to start the iPlanet Web Server. 16. To configure your iPlanet Web Server, use the URL: http:// server _na me:ad mini stra tio n_por t For example: http://iplan [...]

Using Uninstall on Windows NT 42 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 If you have speci al settings in your conf iguration files, renamin g the files is on e way you can still access them after reinstalling the server. If you don’t rename the files, you cannot reinstall the server. 5. Restart your system . Yo[...]

43 Cha pter 4 Installing iPlanet Web Server, FastTrack Edition on Linux This chapter tells you h ow to install iPlan et Web Server. It conta ins the following sections: • Ins tal ling on Linux • Using Si lent Installa tion • Using U nin stall on Linux Installing on Linux The following sections describe the installation of the iPlanet W eb Ser[...]

Installing on Linux 44 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 If you meet both conditions, you do not need to log in a s root to install the server; instead log in as the user acco unt that the Administra tion Server will use. However, you may still prefer to log in as root , even though you meet the conditions .[...]

Inst all ing on Lin ux Chapt er 4 Insta lling iPlan et Web Se rver, Fast Track Ed ition on Linux 45 Running Setup You run the setup program to install iPlanet Web Server. During the installation process, you ha ve the choice of three kinds of in stallation: Express, Typical, or Custom. Most users should choose Typical or Custom (they are identical)[...]

Installing on Linux 46 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 4. Choose whether you accept the software license agreement by typing Yes to accept, or No to decline. If you have not yet read the licen se agreement, cancel out of the installation and read the file LICENSE.txt that is in the same directory as the se[...]

Inst all ing on Lin ux Chapt er 4 Insta lling iPlan et Web Se rver, Fast Track Ed ition on Linux 47 3. Java Support Install this subcomponent if you are plan ning to use Java servlets or JSPs. You also need a JR E or JDK to use iPlanet Web Server’s Java support. Install the JRE provided with iPlanet We b Server (see the previous subcomponent) or [...]

Installing on Linux 48 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 If you use a port oth er than the default port (po rt 80), the URL used to gain access to your home page will change. For exa mple, if your computer is called www.iplanet.com and you choose port 9753, your server’s URL will be http://www.iplanet.com:[...]

Inst all ing on Lin ux Chapt er 4 Insta lling iPlan et Web Se rver, Fast Track Ed ition on Linux 49 If the JDK libraries and CLASSPATH are stored in the default directories below the JDK directory (/jre/lib and /lib, respectively), press Enter at the JDK LIBPATH and JDK CLASSPATH prompts. If the libraries and CLAS SPATH are stored in a differen t p[...]

Installing on Linux 50 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 After installing, you can configure the server to use LDAP users and groups, and to use a JDK. For more information on how to make these changes, see the iPlan et Web Server Adm inistrator’s Guide . To run setup, follow these steps: 1. If you are not[...]

Inst all ing on Lin ux Chapt er 4 Insta lling iPlan et Web Se rver, Fast Track Ed ition on Linux 51 4. Choose whether yo u accepts th e 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 an d read the file LICENSE.txt that is in the same directory as[...]

Using Silent Installation 52 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 starts the console. For information about registering your iPlanet Web Server with the Netsca pe Console, see “Access ing iPlanet We b Server from the Netscape Console,” on page 20. 13. To configure your iPlanet Web Server, use the URL: http:[...]

Using Silent Installation Chapt er 4 Insta lling iPlan et Web Se rver, Fast Track Ed ition on Linux 53 5. Edit the values in the install.inf file to m atch the values of the next server you want to ins tall. For example, cha nge the machine name, port number, installation directory, etc. 6. Run setup usin g the install.inf file for input. For examp[...]

Using Uninstall on Linux 54 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 The following table shows some useful install.inf parameters to edit. For best results, do not edit any parameters except those listed in the ta ble. Using Uninstall on Linux You can remove iPlanet Web Server from your computer by using the uninst[...]

Using Uninstall on Linux Chapt er 4 Insta lling iPlan et Web Se rver, Fast Track Ed ition on Linux 55 To remove your iPlanet Web Server: 1. Go to your server root and type ./uninstall . A list of iPlanet and Netscape servers currently installed in this location appea rs. 2. Find iPlanet W e b Server in th e list a nd type the number next to it at t[...]

Using Uninstall on Linux 56 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000[...]

57 Cha pter 5 Troubleshooting Your Installation This chapter conta ins information on troubleshooting Windo ws NT, Unix and Linux installations of iPlanet Web Server. It contains the following sections: • Troublesho oting A ll Platf orms • Troublesho oting Unix an d Linux • Troublesho oting W indows N T Troubleshooting All Platforms This sect[...]

Troubl eshooti ng Unix a nd Linu x 58 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000 Delete everything after the colon a nd save the file. Shut do wn the Administration Server and restart it. When pro mpted for the a dministration password, leave the password field blank. You sho uld be able to acce ss the Administration[...]

Troubl eshootin g Windows NT Chapt er 5 Troub leshootin g Your I nstallation 5 9 Trouble shooting Win dows NT This section describes troubles hooting prob lems that are Windows NT specif ic. The instal lation could not proceed . Error: Ca n’ t open file fo r writ i ng. Can’t write to fi le fi lena me . The error was error code 3 2 Make sure you[...]

Troubl esh oot i ng Windo ws NT 60 iPlanet Web S erver, FastT rack Edition In stallation Gu ide • June 2000[...]

61 Index C CNAME, DN S and , 14 Communicator, insta lling, 17 Compaq Tru64 Unix, version, 11 Console, iP lanet Web Server integrat ion with , 20 core component, 25 , 46 D Direct ory Se rver insta llin g, 1 8 documentatio n, rela te d, 7 dynamic IP address, 59 H hardwa re requir em ent s Linux, 13 Unix, 12 Windows NT, 1 2 HP-UX, versio n , 11 I IBM [...]

62 iPlanet Web Server, FastT rack Edition In stallation Gu ide • June 2000 L Linux insta lla tion , 43 Linu x us er a cco un ts, 14 Linux, versio n, 11 LocalSystem user ac coun t, 16 M manual conv entions, 6 manual s, o nline vers ions, 7 N Netscape Communi cator, 17 nobody user ac count, 15 O online he lp, 7 online v ersions of manuals, 7 P plat[...]