Sun Microsystems iPlanet Web Server manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

Go to page of

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of Sun Microsystems iPlanet Web Server, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of Sun Microsystems iPlanet Web Server one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of Sun Microsystems iPlanet Web Server. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of Sun Microsystems iPlanet Web Server should contain:
- informations concerning technical data of Sun Microsystems iPlanet Web Server
- name of the manufacturer and a year of construction of the Sun Microsystems iPlanet Web Server item
- rules of operation, control and maintenance of the Sun Microsystems iPlanet Web Server item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of Sun Microsystems iPlanet Web Server alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of Sun Microsystems iPlanet Web Server, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the Sun Microsystems service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of Sun Microsystems iPlanet Web Server.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the Sun Microsystems iPlanet Web Server item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

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

  • Page 2

    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[...]

  • Page 3

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

  • Page 4

    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[...]

  • Page 5

    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 [...]

  • Page 6

    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[...]

  • Page 7

    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 [...]

  • Page 8

    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[...]

  • Page 9

    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[...]

  • Page 10

    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 [...]

  • Page 11

    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[...]

  • Page 12

    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[...]

  • Page 13

    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[...]

  • Page 14

    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[...]

  • Page 15

    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[...]

  • Page 16

    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[...]

  • Page 17

    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 [...]

  • Page 18

    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[...]

  • Page 19

    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[...]

  • Page 20

    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[...]

  • Page 21

    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[...]

  • Page 22

    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[...]

  • Page 23

    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[...]

  • Page 24

    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[...]

  • Page 25

    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 [...]

  • Page 26

    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[...]

  • Page 27

    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[...]

  • Page 28

    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[...]

  • Page 29

    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. [...]

  • Page 30

    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 [...]

  • Page 31

    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[...]

  • Page 32

    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[...]

  • Page 33

    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[...]

  • Page 34

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

  • Page 35

    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[...]

  • Page 36

    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 [...]

  • Page 37

    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 [...]

  • Page 38

    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[...]

  • Page 39

    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[...]

  • Page 40

    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 .[...]

  • Page 41

    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 [...]

  • Page 42

    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[...]

  • Page 43

    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[...]

  • Page 44

    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 .[...]

  • Page 45

    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)[...]

  • Page 46

    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[...]

  • Page 47

    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 [...]

  • Page 48

    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:[...]

  • Page 49

    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[...]

  • Page 50

    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[...]

  • Page 51

    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[...]

  • Page 52

    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:[...]

  • Page 53

    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[...]

  • Page 54

    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[...]

  • Page 55

    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[...]

  • Page 56

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

  • Page 57

    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[...]

  • Page 58

    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[...]

  • Page 59

    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[...]

  • Page 60

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

  • Page 61

    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 [...]

  • Page 62

    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[...]