Chapter 6   After Installation




Configuring Restart of the HTTP Proxy

---

In a terminal window, to automatically configure a restart of the http proxy whenever rebooting the system server, use the command line interface on the iPlanet Portal Server server to do the following:

---

Note	If using more than one server, repeat these steps for each server.

---

As root, in a terminal window, do the following:

# cd /opt/SUNWips/bin # cp ipshttpd /etc/rc3.d/K55ipshttpd # cp ipshttpd /etc/rc3.d/S55ipshttpd # chmod 500 /etc/rc3.d/K55ipshttpd # chmod 500 /etc/rc3.d/S55ipshttpd

---

Note	These commands will autostart the http proxy when the machine is rebooted. These commands will not autostart the http proxy when iPlanet Portal Server 3.0 is restarted using ipsserver start.

---

Setting the Environment Variable IPS_ROOT

---

Set the environment variable IPS_ROOT to the iPlanet Portal Server 3.0 installation directory. The following example assumes that /opt is the installation directory. This is required for the ldapUpdate script to work properly.

# IPS_ROOT=/opt # export IPS_ROOT

Restoring Saved Certificates

---

To restore server certificates after upgrading the iPlanet Portal Server:

1. As root, stop the iPlanet Portal Server server.

   
   

   # /etc/init.d/ipsserver stop

2. Change directories to the directory in which the certificates are to be restored. In the following example, /opt is the base directory.

   
   

   # cd /opt/netscape/server4

3. Un-tar the alias.tar file created before the upgrade process. See the "Saving the Certificates Used by the Server Component" section.

   
   

   # /usr/bin/tar xvf /usr/tmp/alias.tar

4. Restart the iPlanet Portal Server server.

   
   

   # /etc/init.d/ipsserver start

5. Open a browser window, and go to the iPlanet Web Server administration console. For example:

   http://server1.sesta.com:8088

6. Login as admin.

   
   

   ---

   Note	The password for the web server administration console is the same passphrase entered during the iPlanet Portal Server installation.

   ---

   
   

7. Select Manage.

8. Select Apply.

9. Select Load configuration files.

10. Select Preferences.

11. Select Encryption On/Off.

12. Select the On button.

13. Save the configuration.

14. In a terminal window, restart the iPlanet Portal Server server.

    
    

    # /etc/init.d/ipsserver start

Installing Third-Party Software

---

Third-party software that was originally included as a separate CD with the iPlanet Portal Server product is available for download from the iPlanet website, www.iplanet.com. The iPlanet website contains a third-party download directory in which the third-party software file, ThirdParty.tar.gz, is located.

In addition to third-party software that was originally supported by the iPlanet Portal Server 3.0 product, Service Pack 4 adds support for Rhino third-party software. Rhino is an Open Source Mozilla.org JavaScript implementation that allows the Netlet application to be run in browsers that have been configured to use Automatic Proxy Configuration (PAC) files. The automatic proxy configuration feature is supported in the Netscape Navigator and Internet Explorer browsers. For detailed information about automatic proxy configuration and PAC files, see the Netscape Developer's website http://developer.netscape.com.

---

Note	The Samba software is removed by performing an upgrade to iPlanet Portal Server 3.0 Service Pack 4 and by performing any task in which the current installation of the product is removed.

---

Downloading the Third-Party Software

The following instructions assume that the directory /opt/ips_sp4 has been created as a download directory for Service Pack 4.

1. In a terminal window, log on as root.

2. Change directories to /opt/ips_sp4 and create a directory called ips_3p in which to download the third-party tar file.

   
   

   # cd /opt/ips_sp4 # mkdir ips_3p

3. Download the file ThirdParty.tar.gz into the directory created in Step 2.

4. Run the gunzip command to extract the ThirdParty.tar file.

   
   

   # gunzip ThirdParty.tar.gz

5. Run the tar command to extract the contents of the iPS3.0SP4-01.tar file.

   
   

   # /usr/bin/tar -xvf ThirdParty.tar

Using the Third-Party Install Script

To use the Netlet feature with a Web browser that is configured to use PAC files, the third-party software, Rhino, must be installed on the server component.

To allow remote users access to Microsoft Windows networks, you must install Samba server software on the server component(s).

The install_3ps installation script installs the Samba and the Rhino software. The other third-party products, GO-joe and pcANYWHERE are installed on machines other than the server component; refer to iPlanet Portal Server 3.0 Administration Guide for installation instructions.

After downloading and untarring the third-party software to /opt/ips_sp4/ips_3p, use the following procedure to install the Samba and Rhino software. The script installs each product separately, so you can choose to install Rhino or Samba or both.

1. In a terminal window, log on as root. Change directories to the third-party download directory that you created and run the install_3ps script.

   
   

   # cd /opt/ips_sp4/ips_3p # ./install_3ps

2. Choose whether to install the Samba software.
   • If you choose yes, continue with Step 3.

   • If you choose no, the Samba software is not installed. Go to Step 4.

     
     

     # Do you wish to install the 3rd Party Samba Package? yes/[no]yes

3. Read and accept the disclaimer to install the Samba software. Type yes to accept.

   
   

   Beginning installation of third party Samba package... Installation of third party Samba package complete.

   The Samba software is installed.

4. Choose whether to install the Rhino software.
   • If you choose yes, continue with Step 5.

   • If you choose no, the Rhino software is not installed, and the terminal prompt is returned.

     
     

     Do you wish to install the 3rd Party Rhino Javascript Package ? yes/[no] yes

5. Read and accept the terms of the Mozilla public license to install the Rhino software. Type yes to accept.

   
   

   Do you agree to the terms and conditions set forth in the preceding Mozilla Public License ? yes/[no] yes 3rd Party Rhino Javascript Package installed. You must restart the server for this change to take effect.

6. Restart the server component.

In addition to using PAC files, Internet Explorer can also use an .ins automatic configuration file for automatic proxy services. For more information, see the section "Configuring Internet Explorer INS File" in Release Notes for iPlanet Portal Server 3.0 Service Pack 4.

Removing Third-party Software

The Samba third-party software is removed when the iPlanet Portal Server software is removed. However, the Rhino software must be manually removed by removing the js.jar file located in /usr/java/jre/lib/ext/.

To remove the Rhino software, issue the following commands as root:

# cd /usr/java/jre/lib/ext/ # rm js.jar