Previous     Contents     Index     Documentation Resources     Next     
Managing Servers With iPlanet Console



Chapter 2   Installing iPlanet Servers and Console


This chapter provides an overview of the iPlanet Server Products Setup program and how it is used in various situations.

This chapter contains the following sections:

Each iPlanet server product has its own detailed installation instructions. To read these, see your server product documentation at http://docs.iplanet.com.



The Setup Program


The iPlanet Server Products Setup program is for installing iPlanet server products all at once or one at a time. Use the Setup program each time you need to do any of the following:

  • Install a new server or server component

  • Install iPlanet Console as a stand-alone application

  • Update a server


Installing a New Server

This section provides an overview of installation dependencies and options common to all iPlanet server products.


Note Each iPlanet and Netscape™ server has its own detailed installation instructions. Look for your server's documentation at http://docs.iplanet.com



Directory Server Must Be Installed First

In order to install iPlanet software, you must first set up Directory Server. When you do this, you create a user ID and password for the Configuration Administrator. During a typical installation, the Setup program checks this user ID and password against the installed directory. If the values do not match, authentication fails, and you can't complete the installation.

For detailed information on installing Directory Server, see the server's documentation at http://docs.iplanet.com.

When you install Directory Server for the first time, iPlanet Administration Server and Console are automatically installed for you.


Administration Server Is Required in Each Server Root

Every iPlanet server root must contain an instance of Administration Server. If you are installing a server into a new folder, the Setup program will automatically install Administration Server for you.


Note Installing or upgrading iPlanet Console on Windows NT requires rebooting the machine at the end of the install process. The option to reboot is offered at the end of the setup program. If you choose not to reboot at the end of the install process you must remember to reboot later, before you use iPlanet Console.



Installation Modes

The Setup program offers three installation modes: Express, Typical, and Custom.


Express

Use this mode to get the system running quickly, using default settings as much as possible. This mode was designed for administrators who want to test a server's basic operation on a particular system before deploying. It automatically generates as much information as possible to complete the most basic installation. Generally, you need to enter only administrator names and passwords during an express installation.


Typical

Use this mode if you want to specify some, but not all, installation options. Administrators often use this mode because it handles the details of server configuration, while still letting administrators modify settings such as directory location, port numbers, user names, and passwords.


Custom

Use this mode only if you've run the installer before, and are familiar with server configuration settings and how to modify them. This mode is most useful to the administrator who routinely installs and upgrades servers, and whose company has already identified special enterprise needs. When using custom mode, you can specify every typical option as well as advanced ones such as the IP address of a host system.


Installing iPlanet Console as a Stand-Alone Application

You can install iPlanet Console as a stand-alone application on a machine local to you. Having iPlanet Console on your local machine allows you to manage servers on remote machines.


To Install iPlanet Console as a Stand-Alone Application on UNIX System

  1. Download the compressed product binaries for iPlanet Console.

    These are available at http://www.iplanet.com/downloads/patches/

  2. Extract the binaries into a new directory.

  3. Run the Setup program by typing setup.

    The first installation screen appears.

  4. Proceed through the installation process. Here are the prompts you encounter with instructions about what to do:

    Would you like to continue with installation? Enter Yes.

    Do you agree to the license terms? Enter Yes.

    Select the component you want to install. Enter 2 for iPlanet Console

    Installation location. Enter the path to the folder where you want to install iPlanet Console. If the specified folder does not exist, the Setup program will create it for you.

  5. Press Enter.

    The Setup program installs iPlanet Console in the folder you specified.

Once installation is complete, you can run iPlanet Console by navigating to the folder you specified as the installation location, and then typing startconsole.


To Install iPlanet Console as a Stand-Alone Application on Windows NT Systems

  1. Download the compressed product binaries for iPlanet Console.

    The binary files are available at this location: http://www.iplanet.com/downloads/patches

  2. Extract the binaries into a new folder and run the setup.exe program.

    The installation startup screen appears.



    .

  3. Proceed through the installation process. Here are the prompts you encounter with instructions about what to do:

  4. Do you accept all of the terms of the preceding license agreement? Click Yes.

  5. Choose the type of Setup you prefer. Select iPlanet Console.

  6. Installation directory. Enter the location where you want to install iPlanet Console. If this folder does not exist, the Setup program asks if you want to create it.

  7. Review your selections. If you need to make any changes, click Back and modify your choices.

  8. Click Install.

    The Setup program installs iPlanet Console in the specified folder.

  9. When the installation is complete, click Finish.

Once installation is complete, you can run iPlanet Console by clicking Start, and then choosing Programs > iPlanet Server Products > iPlanet Console 5.0.



Upgrading to Version 5.0


If you already have versions of Netscape Console and Administration Server installed on your system, you can upgrade to iPlanet Console 5.0. This section contains instructions for performing the following upgrades:

  • Upgrading Administration Server and Console

  • Upgrading a Stand-Alone Console.


    Note The instructions presented in this section apply only when upgrading iPlanet or Netscape Administration Server and Console. If you want to upgrade a different iPlanet or Netscape product, please refer to the installation instructions for the upgraded version of that product. You can find most installation instructions at http://docs.iplanet.com.



Upgrading Administration Server and Console

To upgrade Netscape Administration Server and Console to iPlanet Administration Server and Console 5.0, follow the directions for your operating system.


To Upgrade on UNIX Systems

  1. Download the compressed product binaries for iPlanet Administration Server and Console.

    The binary files are available at this location: http://www.iplanet.com/downloads.

  2. Extract the binaries files into a new folder.

  3. Run the Setup program by typing setup.

    The first installation screen appears.

  4. Proceed through the installation process. Here are the prompts you encounter with instructions about what to do:

    Would you like to continue with installation? Press Enter for Yes.

    Do you agree to the license terms? Enter Yes.

    Select the component you want to install Enter 1 for iPlanet Servers.

    Choose an installation type Enter 2 for Typical.

    Installation location Enter the location where Administration Server is currently installed.

    If Administration Server was installed with another Netscape or iPlanet server, enter the path to that product's server root. For example, if you installed Netscape Directory Server 4.1 in the /usr/netscape/server4 folder, then you would enter /usr/netscape/server4 as your installation location.

    Specify the components you wish to install Press Enter (for All)

    (Core Components) Specify the components you wish to install Choose all three core components by entering 1, 2, 3.

    (Administration Services) Specify the components you wish to install Choose both components by entering 1,2.

    Computer name Enter the fully qualified hostname of your computer. For example, eastcoast.siroe.com.

    System User Enter the user ID that iPlanet Administration Server is currently running as. The server will continue to run as this user.

    System Group Enter the UNIX group to which the System User belongs.

    Configuration Admin ID or DN Enter the user ID or distinguished name of the administrator who is currently authorized to access the configuration directory.

    Password Enter the password for the user specified by the Configuration Admin ID or DN.

  5. Press Enter.

    The installer replaces your existing Administration Server and Console with the new versions of the software.

Once installation is complete, you can run iPlanet Console by navigating to the folder you specified as the Install location, and then typing startconsole.


To Upgrade on Windows NT Systems

  1. Download the compressed product binaries for iPlanet Administration Server and Console.

    The binary files are available at this location: http://www.iplanet.com/downloads

  2. Extract the binaries into a new folder and run the setup.exe program.

    The installation startup screen appears.



  3. Click Next.

  4. Proceed through the installation process. Here are the prompts you encounter with instructions about what to do:

    Do you accept all of the terms of the preceding license agreement? Click Yes.

    Choose the type of Setup you prefer Select iPlanet Servers.

    (Type of Installation) Choose the type of Setup you prefer Select Typical.

    Installation directory Enter the location where iPlanet Administration Server is currently installed.

    If Administration Server was installed with another Netscape or iPlanet server, enter the path to that product's server root. For example, if you installed Netscape Directory Server 4.1 in the C:\Netscape\Server4 folder, you would enter C:\Netscape\Server4 as your installation location.

    Select the products you want to install Both boxes are checked, by default.

    User ID or Distinguished Name Enter the user ID or distinguished name of the administrator who is currently authorized to access the configuration directory.

    Password Enter the password for the user ID or distinguished name entered above.

  5. Review your selections. If you need to make any changes, click Back and modify your choices.

  6. Click Next.

    The Setup program replaces your existing Administration Server and Console with version 5.0.

  7. When the installer completes, click Finish.

Once installation is complete, you can run iPlanet Console by clicking Start, and then choosing Programs > iPlanet Server Products > iPlanet Console 5.0.


Upgrading a Stand-Alone Version of iPlanet Console

If you have installed a stand-alone version of iPlanet Console, you can upgrade it to version 5.0.


To Upgrade a Stand-Alone Version of iPlanet Console on UNIX Systems

  1. Download the compressed product binaries for iPlanet Console.

    The binary files are available at this location: http://www.iplanet.com/downloads

  2. Extract the binaries into a new folder.

  3. Run the Setup program by typing setup.

    The first installation screen appears.

  4. Proceed through the installation process. Here are the prompts you encounter, with instructions about what to do:

    Would you like to continue with installation? Press Enter for Yes.

    Do you agree to the license terms? Enter Yes.

    Select the component you want to install Enter 2 for iPlanet Console.

    Installation location Enter the location where iPlanet Console is currently installed.

  5. Press Enter.

    The installer replaces your existing version of iPlanet Console with the new version of the software.

Once installation is complete, you can run iPlanet Console by navigating to the folder you specified as the installation location, and then typing startconsole.


To Upgrade a Stand-Alone Version of iPlanet Console on Windows NT Systems

  1. Download the compressed product binaries for iPlanet Console.

    The binary files are available at this location: http://www.iplanet.com/downloads

  2. Extract the binaries into a new folder and run the setup.exe program.

    The installation startup screen appears.



  3. Click Next.

  4. Proceed through the installation process. Here are the prompts you encounter with instructions about what to do:

    Do you accept all of the terms of the preceding license agreement? Click Yes.

    Choose the type of Setup you prefer. Select iPlanet Console.

    Installation directory. The installer will automatically supply the location where Console is currently installed.

  5. Review your selections. If you need to make any changes, click Back and modify your choices.

  6. Click Install.

    The Setup program replaces your existing version of iPlanet Console with the new version of the software.

  7. When the installer completes, click Finish.

Once installation is complete, you can run iPlanet Console by clicking Start, and then choosing Programs > iPlanet Server Products > iPlanet Console 5.0.



Silent Installation


The Silent Installation feature of the iPlanet Server Products Setup program allows you to use a file to predefine all the specifications that you would normally supply interactively during installation of each server. Silent Installation is useful when you want to install a large number of iPlanet server instances using identical installation options.


Performing a Silent Installation

In order to perform a silent installation, you must create a set of installation specifications and then run the iPlanet Server Products Setup program in silent mode. The easiest way to create a set of installation answers is to perform an installation and save your installation cache to a file. Once you've done this, you can modify the cache file and then use it when performing additional installations.

You can use Silent Installation to upgrade multiple instances of Administration Server. Rather than manually entering the same set of answers for each server, you can save your installation answers while upgrading one instance of Administration Server, and then upgrade the remaining instances using the same answers.


To Save Your Installation Answers

  1. From the system prompt, run the Setup program by typing setup -k.

    The -k flag instructs the Setup program to store your answers to installation questions.

  2. Perform your installation or upgrade.

    The answers that you specify in response to installation and upgrade questions are stored in the setup/install.inf file which is contained in the destination directory that you specify during installation.

  3. If you plan to perform multiple silent installations using different sets of installation answers, rename install.inf to a name that clearly identifies the set of installation specification you have chosen and then repeat this procedure.

  4. Repeat steps 1 through 3 for each set of installation specifications you need.

For more details on installation, see "The Setup Program."


To Perform a Silent Installation

  1. Make any necessary changes to the file or files containing your installation answers.

  2. Copy the installation answer file or files to the directory containing the Setup program.

  3. From the system prompt, run the Setup program by typing setup -s -f filename.

    The -s flag instructs the Setup program to perform a silent installation. The -f flag tells the Setup program to use the answer file specified by filename.

On UNIX, Silent Installation outputs some status messages and alerts. Complete status information is written to the setup/setup.log file which is contained in the destination directory that you indicate during installation.

On Windows NT, Silent Installation does not produce any status messages or alerts. All status information is written to the setup/setup.log file which is contained in the destination directory that you indicate during installation.

For detailed information on how a particular server uses Silent Installation, see that server's documentation.



Uninstallation


If you are no longer using an iPlanet server, you can uninstall it. Uninstallation completely removes a server from your computer. The server will not be accessible and you will lose all settings.


Uninstalling an iPlanet Server

The following procedures show you how to uninstall an iPlanet server on UNIX and Windows NT.


To Uninstall an iPlanet Server on UNIX Systems

  1. In the server root, type uninstall.

    The first uninstallation screen appears.

  2. Proceed through the uninstallation process. Here are the prompts you encounter with instructions about what to do. Depending on the selections you make, you may see additional prompts:

    Select the components you wish to uninstall Select the components to uninstall or press Enter (for All) to remove all listed software.

    Configuration Admin ID or DN Enter the user ID or distinguished name of the administrator who is currently authorized to access the configuration directory.

    Password Enter the password for the user specified by the Configuration Admin ID or DN.

  3. Press Enter.

    The uninstall program removes the selected software. If the uninstall program cannot remove all files in the server root, it prints a message to the screen. To remove any remaining files, go to the server root and delete the files manually.


To Uninstall an iPlanet Server on Windows NT Systems

  1. Click Start, and then choose Settings > Control Panel.

  2. Double-click Add/Remove Programs.

    Alternatively, you can run uninst.exe from the server root.

  3. In the Add/Remove Program Properties window, click the Install/Uninstall tab.

  4. Select iPlanet Server Products 5.0, then click Remove.

  5. In the iPlanet Uninstall window, select the iPlanet servers and components you want to uninstall.

  6. If you want to specify which subcomponents of your iPlanet software to remove, highlight the installed product or component name and then click the Subcomponents button.

    The Select Sub-components dialog appears. Select the subcomponents that you want to remove, then click Continue.

    Select the components you wish to uninstall Select the components to uninstall or press Enter (for All) to remove all listed software.

    Configuration Admin ID or DN Enter the user ID or distinguished name of the administrator who is currently authorized to access the configuration directory.

  7. Password Enter the password for the user specified by the Configuration Admin ID or DN.

  8. Click Uninstall.

    The uninstall program removes the selected software. If the uninstall program cannot remove all files in the server root, it prints a message to the screen. To remove any remaining files, go to the server root and delete the files manually.


Silent Uninstallation

The Silent Uninstallation feature allows you to uninstall a product without providing answers to uninstallation questions.


To Perform a Silent Uninstallation on UNIX Systems

  • From the system prompt, run the uninstallation program in silent mode by typing uninstall -s.

    If the uninstallation program cannot contact the instance of Directory Server containing the configuration information for the product you are trying to uninstall, uninstallation will fail. In this case, no product files or configuration information will be removed. If you want the uninstallation program to remove the local product files regardless of whether it can contact the instance of Directory Server containing configuration information, run the uninstallation program by typing uninstall -s -force.

    While it removes files, the uninstallation program outputs some status messages and alerts. When uninstallation is finished, you are returned to the system prompt.


To Perform a Silent Uninstallation on Windows NT Systems

  • From the system prompt, run the uninstallation program in silent mode by typing uninst -s.

    If the uninstallation program cannot contact the instance of Directory Server containing the configuration information for the product you are trying to uninstall, uninstallation will fail. In this case, no product files or configuration information will be removed. If you want the uninstallation program to remove the local product files regardless of whether it can contact the instance of Directory Server containing configuration information, run the uninstallation program by typing uninstall -s -force.

    The uninstallation program does not produce any status messages or alerts. All status information is written to the uninstallation log file which is contained in your system's temporary directory (for example, C:\TEMP).


Previous     Contents     Index     Documentation Resources     Next     
Copyright © 2001 Sun Microsystems, Inc. Some preexisting portions Copyright © 2001 Netscape Communications Corp. All rights reserved.