Sun ONE logo      Previous      Contents      Index      Next     

iPlanet Portal Server 3.0 Service Pack 5 Installation Guide

Chapter 5

Removing Service Pack 5 Software

The iPlanet Portal Server software can be removed in two ways.

By running the install script, the server software and the gateway software are removed individually, providing the option of removing only one. Using ipsinstall -r removes both.


Caution

Using ipsinstall -r removes everything related to the iPlanet Portal Server software including the certificcates.



Before Removing the iPlanet Portal Server Software

This procedure assumes that the Service Pack 5 files were downloaded to /opt/ips_sp5.

  1. Back up the entire machine on which the iPlanet Portal Server software resides, so that it can be restored if necessary.
  2. Stop all services for the iPlanet Portal Server server and gateway.

  3. Note

    See "Stopping the Server Component Processes" for information on how to correctly perform these functions.



Using ipsinstall -r Command

  1. As root, change directories to /opt/ips_sp5.
  2. Issue the following command.
  3. # ./ipsinstall -r

    The script removes the server and the gateway software if they are on the same machine. If the portal uses multiple servers or a separate gateway machine, use the script on each machine to remove the software.

    ********************************************************************

    iPlanet(TM) Portal Server (iPS) (3.0sp5 release)

    ********************************************************************

    Installation log at /var/sadm/install/logs/ipsinstall.22739/install.log

    Inspecting network.

    Inspecting iPS components.

    Removing gateway.

    Removing server.

Accessing the Install Script

The ipsinstall script can be used to remove the iPlanet Portal Server Service Pack 5 software.

  1. As root, change directories to /opt/ips_sp5.
  2. Run the ipsinstall script.
  3. The ipsinstall script must be run from the directory in which it exists.

    # cd /opt/ips_sp5

    # ./ipsinstall

The iPlanet Portal Server Service Pack 5 install script will now run. See "Using the Service Pack 5 Install Script" for an example of the prompts required to remove this software.


Using the Service Pack 5 Install Script

In the following example, the install script prompts for software removal.

  1. The installation script displays the Service Pack 5 license agreement.
  2. Enter yes to accept the license agreement and continue with the backout. If you enter no, the installation script exits.

    ****************************************************************

    iPlanet(TM) Portal Server (iPS) (3.0sp5 release)

    ****************************************************************

    Installation log at /var/sadm/install/logs/ipsinstall.17169/install.log

    This product will run without a license. However, you must either purchase a Binary Code License from, or accept the terms of a Binary Software Evaluation license with, Sun Microsystems, to legally use this product.

    Do you accept? yes/[no] yes

    The installation script attempts to determine name and IP address information about the machine on which you are installing. If the machine on which you are installing uses multiple IP addresses or multiple domains, verify that the IP address displayed by the script is the correct one for the iPlanet Portal Server component.

  3. Accept the default values or enter the correct name and IP address information.
  4. Inspecting network.

    What is the iPS hostname of this machine? [server1]

    What is the subdomain ("." for none)? []

    What is the domain? [sesta.com]

    What is the ip address of server1.sesta.com? [192.168.01.01]

    Inspecting iPS components.

    The script displays the task menu.

  5. Enter 4 to remove the Service Pack 5 product.
  6. Options:

    1) Continue upgrade

    2) Continue as a clean install (current installation will be removed)

    3) Continue install (current installation will not be removed)

    4) Remove current installation

    5) Exit

    Choice? [5] 4

  7. Select which component to remove.
  8. Select which component to remove:

    1) Server

    2) Gateway

    3) Exit

    Choice? [3] 1

    The script asks you to verify your choice.

  9. Choose y to remove the iPlanet Portal Server component.
  10. The script proceeds with the removal process. When the component is removed, the script returns you to the component menu.

  11. Select which component to remove, or choose 3 to exit the script.
  12. Select which component to remove:

    1) Server

    2) Gateway

    3) Exit

    Choice? [3] 3


Removing a Partial Installation

If the installation process gets interrupted and only some of the iPlanet Portal Server packages have been installed, the packages that were installed must be removed before attempting to reinstall or use the product.

To remove a partial installation:

  1. As root, change directories to the Solaris package database directory.
  2. # cd /var/sadm/pkg

  3. List the iPlanet Portal Server software directories.
  4. # ls -d SUNW*

  5. Look for any of the following directories:
  6. SUNWicgSA/

    SUNWj2man/

    SUNWwtdt/

    SUNWwtnf/

    SUNWicgSS/

    SUNWj2rt/

    SUNWwtfw/

    SUNWwtnm/

    SUNWj2dem/

    SUNWwtdoc/

    SUNWwtgw/

    SUNWwtrw/

    SUNWj2dev/

    SUNWwtds/

    SUNWwtgwd/

    SUNWwtsam/

    SUNWwtsd/

    SUNWwtsvd/

    SUNWwtsdd/

    SUNWwtws/

    SUNWwtsmb/

    SUNWwtsv/

     

     

  7. Remove any packages that match the list above. For example:
  8. # pkgrm SUNWicgSS

    Some packages might not be completely installed and cannot be removed with the pkgrm command. Use the rm command to remove only partially installed packages. For example:

    # rm -rf SUNWicgSS

  9. Change directories to /var/sadm/install/logs and list the iPlanet Portal Server software directories.
  10. # cd /var/sadm/install/logs

    # ls

  11. Look for any of the directories listed in Step 3.
  12. Remove any directories that matched the list of iPlanet Portal Server software directories. For example:
  13. # pkgrm SUNWicgSS

    Some packages might not be completely installed and cannot be removed with the pkgrm command. Use the rm command to remove only partially installed packages. For example:

    # rm -rf SUNWicgSS



Previous      Contents      Index      Next     


Copyright 2003 Sun Microsystems, Inc. All rights reserved.