Instruction/ maintenance manual of the product iPlanet Web Server Sun Microsystems
Go to page of 62
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.
3 Contents About This G uide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 What You N eed to Know . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
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 . . . . . . . . . . . . . . . .
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 Gui.
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.
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.
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:.
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.
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.
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.
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.
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.
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 t.
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.
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.
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.
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 (fo.
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.
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.
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 li.
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.
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.
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.
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.
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.
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.
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.
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.
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 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.
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.
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.
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 .
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.
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.
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.
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.
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 .
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.
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.
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 • U.
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.
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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 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.
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.
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.
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.
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.
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 e.
An important point after buying a device Sun Microsystems iPlanet Web Server (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought Sun Microsystems iPlanet Web Server yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data Sun Microsystems iPlanet Web Server - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, Sun Microsystems iPlanet Web Server you will learn all the available features of the product, as well as information on its operation. The information that you get Sun Microsystems iPlanet Web Server will certainly help you make a decision on the purchase.
If you already are a holder of Sun Microsystems iPlanet Web Server, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime Sun Microsystems iPlanet Web Server.
However, one of the most important roles played by the user manual is to help in solving problems with Sun Microsystems iPlanet Web Server. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device Sun Microsystems iPlanet Web Server along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
