Novell iManager 2.0.2
Download Information Page

General Prerequisites

The following prerequisites apply to all platforms. Additional platform-specific prerequisites are listed in the next section by platform.

NetWare 6.0

Downloading Instructions

  1. Create a directory on your server (for example, sys:\imanager202).
  2. Click Download next to NetWare® 6.0 (iMan_202_NW60_Standalone.exe).
  3. Following the onscreen prompts, download to the directory that you created.
  4. Run the iMan_202_NW60_Standalone.exe file and extract its contents to a temporary folder that you've created on the sys: volume on your NetWare 6.0 server. You will also install from this temporary folder.

Installation Instructions

Note: If you want to use your 1.x collections and roles with this version of iManager, they will need to be updated through the iManager 2.x Configuration Wizard.

Prerequisites

In addition to the general prerequisites listed in General Prerequisites, the following prerequisites apply to iManager on NetWare 6.0:

Procedure

For detailed iManager installation instructions, see the Novell iManager 2.0.x Administration Guide.

To install iManager on NetWare 6.0:

  1. Determine whether Tomcat 3.3 is listening on port 8080 (for Tomcat 3.3, this is disabled by default, but may have been enabled for debugging purposes). If the port is enabled, disable it by commenting out the Http10Interceptor tag in sys:\tomcat\33\nwserver.xml, then restart Tomcat 3.3 (at the NetWare command prompt, type tomcat stop followed by tomcat33).
  2. Verify that LDAP SSL is running. Run TCPCON from the NetWare console. Select Protocol Information > TCP > TCP Connections. Verify that port 636 is shown in the list of open ports.
  3. Run PKI Diag Utility (PKIDIAG). For more information, see Technical Information Document #2963420.
  4. Verify that there is adequate disk space on the volume. You will need approximately 200 MB of free disk space.
  5. Verify that Tomcat 3.3 is installed. The server should have a sys:\tomcat\33\ folder, and when you type JAVA -SHOW at the NetWare command line, org.apache.tomcat.startup.Main should appear in the list of Java processes.

  6. Determine the ports that Apache is listening on. Open the sys:\Apache\conf\adminserv.conf file and find the following line:

    # Start Apache Services Port Configuration

    Note the ports for both HTTP and HTTPS (Listen and SecureListen directives).

  7. From the NetWare 6 GUI, click the Novell button, then select Install > Add.
  8. Select the product.ni file (that was copied to the temporary folder that you created on the sys: volume) for iManager 2.0.2 and complete the installation program.
  9. Modify the connector redirect ports in server.xml.
    1. Open the sys:\tomcat\4\conf\server.xml file.
    2. Find the Connector element that defines the HTTP/1.1 connector. The port is typically set to 8080. Change the redirectPort attribute from the default of 8443 to the port number you found in Step 6.
    3. Find the Connector element that defines the AJP 1.3 connector. The port is typically set to 8009. Change the redirectPort attribute from the default of 8443 to the port number you found in Step 6.
    4. Save your changes to server.xml and close the file.

  10. Open a Web browser and connect to iManager at the port discovered in Step 6. For example:

    https://IP:SecureListen port/nps/iManager.html


Windows

Downloading Instructions

  1. Create a directory on your server (for example, c:\novell\imanager202).
  2. Click Download next to Windows (iMan_202_win.exe).
  3. Following the onscreen prompts, download to the directory that you created.
  4. Run the iMan_202_win.exe file and extract its contents to a temporary directory.

Installation Instructions

Prerequisites

In addition to the general prerequisites listed in General Prerequisites, the following prerequisites apply to iManager on Windows:

The iManager 2.0.2 installation program installs and configures the following items if it does not detect a compatible version:

If you are installing iManager on the same machine as eDirectory, verify that you have Require TLS for Simple Binds with Password checked on the LDAP Group object for the server that you are using to set up iManager. If this check box is not checked, iManager is installed in non-secure mode and plug-ins that require secure mode will fail.

Procedure

For detailed iManager installation instructions, see the Novell iManager 2.0.x Administration Guide.

To install iManager on Windows:

  1. Run iManagerInstall.exe.
  2. Follow the on-screen instructions.
  3. After the installation completes, your Web server is restarted. You might need to wait several seconds for the Web server to initialize before iManager will be available.

HINT: You can view the debug output of the installation program by holding down the Ctrl key immediately after launching the installer. Continue to hold down the key until a console window appears.


Linux

Downloading Instructions

  1. Create a directory on your server (for example, in your home directory).
  2. Click Download next to Linux (iMan_202_linux.tgz).
  3. Following the onscreen prompts, download to the directory that you created.

  4. Extract the iMan_202_linux.tgz file to a directory on your server. Use the following command:

    tar -zxvf iMan_202_linux.tgz

Installation Instructions

Prerequisites

In addition to the general prerequisites listed in General Prerequisites, the following prerequisites apply to iManager on Linux:

IMPORTANT: On Linux, iManager only works with the versions of Apache and Tomcat that are installed with iManager.

Procedure

For detailed iManager installation instructions, see the Novell iManager 2.0.x Administration Guide.

To install iManager on Linux:

  1. Open a shell and change to the install_directory/iManager_linux directory. This path is relative to the directory where you copied or extracted the iManager files.

  2. Enter the following command:

    ./install.sh

  3. Follow the on-screen prompts. The text within the brackets at the prompt is the default selection. Press Enter to accept the default. When prompted to enter the iManager server addresses or DNS host name, the IP address gets auto-detected.
  4. For the admin name, you must use dot notation (for example, cn=admin.o=novell).
  5. LDAP server IP address or DNS hostname defaults to the local machine. Make sure you use the IP address of eDirectory LDAP server in the eDirectory tree where you want to install iManager.

  6. Launch a supported browser and go to:

    https://server_ip_address:port_number/nps/iManager.html

    IMPORTANT: This URL is case sensitive. The server IP address can also be a DNS name.


Solaris

Downloading Instructions

  1. Create a directory on your server (for example, in your home directory).
  2. Click Download next to Solaris* (iMan_202_sol.tgz).
  3. Following the onscreen prompts, download to the directory that you created.

  4. Extract the iMan_202_sol.tgz file to a directory on your server. Use the following command:

    gzip -dc iMan_202_sol.tgz | tar xvf -

Installation Instructions

Prerequisites

In addition to the general prerequisites listed in General Prerequisites, the following prerequisites apply to iManager on Solaris:

Procedure

For detailed iManager installation instructions, see the Novell iManager 2.0.x Administration Guide.

To install iManager on Solaris:

  1. Open a shell and change to the iManager_solaris/installs/unix directory. This path is relative to the directory where you copied or extracted the iManager files.

  2. Enter the following command:

    ./iManagerInstallSolaris.bin

    For text only, enter the following command:

    ./iManagerInstallSolaris.bin -i console

  3. Follow the prompts.

  4. Stop and re-start Tomcat, then Apache by entering the following commands:

    /var/opt/novell/tomcat4/bin/shutdown.sh
    /var/opt/novell/tomcat4/bin/startup.sh
    /var/opt/novell/httpd/bin/apachectl stop
    /var/opt/novell/httpd/bin/apachectl startssl

    These services are not configured to start at boot-up.

  5. Launch a suppored browser and go to:

    https://server_ip_address:port_number/nps/iManager.html

    IMPORTANT: This URL is case sensitive. The server IP address can also be a DNS name.

  6. Log in as someone with admin-equivalent rights to the eDirectory tree, because the schema will be extended at this time.
  7. To access the Getting Started help screen, open the gettingstarted.html file located in the /var/opt/novell/tomcat4/webapps/nps/help/en/install directory.

HP-UX

Downloading Instructions

  1. Create a directory on your server (for example, in your home directory).
  2. Click Download next to HP-UX (iMan_202_hp.tgz).
  3. Following the onscreen prompts, download to the directory that you created.
  4. Extract the file (for example, gzip -dc iMan_202_hp.tgz | tar xvf -).

Installation Instructions

Prerequisites

In addition to the general prerequisites listed in General Prerequisites, the following prerequisites apply to iManager on HP-UX:

Procedure

For detailed iManager installation instructions, see the Novell iManager 2.0.x Administration Guide.

To install iManager on HP-UX:

  1. Install the HP-UX Web Server Suite version 1.0.06.01 from the HP Software Depot Web site. The suite contains the official versions of Apache and Tomcat that are supported for HP-UX. You can update to version 1.0.10.01 after you create a new Apache SSL certificate in Step 4.

    NOTE: The version of openssl (0.9.7b) included with the HP-UX Web Server Suite versions A100901 and A101001 has problems generating certificates through Webmin. Install HP-UX Web Server Suite version A100601, which contains openssl version 0.9.6i, create a new SSL certificate for Apache through Webmin, and then update your HP-UX Web Server Suite to a newer version if you are installing iManager 2.0.2. If you would like to create certificates with openssl through Webmin in the future, back up /opt/hpws/Apache/bin/openssl before updating your HP-UX Web Server Suite from version A100601.

    Select the download with all components:

  2. Install Java 1.4.1_02 from the HP Java for HP-UX Web site and update your path to find the new Java.

  3. Add and export the following environment variables in the environment setting for the user that will be running Tomcat (usually located in the .bashrc file): JAVA_HOME, CATALINA_HOME, APACHE_HOME, SHLIB_PATH.

    For example:

    JAVA_HOME=/opt/java
    APACHE_HOME=/opt/hpws/apache
    CATALINA_HOME=/opt/hpws/tomcat
    SHLIB_PATH=/usr/lib:/usr/lib/nds-modules:$SHLIB_PATH
    export JAVA_HOME APACHE_HOME CATALINA_HOME SHLIB_PATH

  4. Install a new certificate for Apache. You must complete this step before continuing the installation. The certificate that is installed with Apache on HP-UX does not have the correct information for your server. You can install a certificate that you purchase from a trusted authority or a self-signed certificate.

    The Webmin administration tool can generate keys, certificates, and certificate requests for Apache. Webmin is installed with the HP-UX Web Server Suite. For more information, see the HP-UX Web Server Suite documentation, which is accessible from your Apache installation (http://IP_ADDRESS). For information on using Webmin to generate keys, certificates, and certificate requests, go to http://IP_ADDRESS/hp_docs/faq/#security11.

    IMPORTANT: Make sure you use the correct DNS name or IP address for the common name when you create a new certificate.

    Copy the certificates to the Apache directory: /opt/hpws/apache/conf/ssl.crt/ and /opt/hpws/apache/conf/ssl.key/.

  5. Logout or close the terminal session to load the environment variables.

  6. Extract the iMan_202_sol.tgz file to a directory on your server. Use the following command:

    gzip -dc iMan_202_hp.tgz | tar xvf -

  7. Go to the iManager_hpux/installs/unix directory.

  8. Type the following command:

    ./iManagerInstallHPUX.bin

    or

    sh iManagerInstallHPUX.bin

    For text only, enter the following command:

    ./iManagerInstallHPUX.bin -i console

    IMPORTANT: The iManager installer detects the HP-UX Web Server Suite. Do not change the install path for iManager.

  9. Start Tomcat and Apache. The command you use depends on your iManager configuration:

    /opt/hpws/tomcat/bin/startup.sh
    /opt/hpws/apache/bin/apachectl start

    or

    /opt/hpws/apache/bin/apachectl startssl

    NOTE: Tomcat might take 60 seconds or longer to load before you can access iManager, depending on the performance of your server.

  10. Run the extenNd DirectorTM Configuration Wizard. Follow the instructions in the Novell iManager 2.0.x Administration Guide.


Installing from a CD ISO Image

This option lets you download an exact copy of the Novell eDirectory 8.7.3 Web Applications distribution CD, which includes the following:

After you download the .iso file (eDir_873_webapps.iso) and burn the .iso image to CD, an exact duplicate of the original eDirectory 8.7.3 Web Applications CD is created. Neither iManager nor eGuide can be installed directly from the electronic .iso file. A CD image of the file MUST be created first. Create the installation CD according to the instructions for your CD imaging software.

  1. Create a directory on your server or workstation.
  2. On the Novell Product Downloads page, find eDirectory 8.7.3 Web Applications, then click Download.
  3. Follow the onscreen prompts to download eDir_873_webapps.iso to the directory you created.
  4. Burn an eDirectory 8.7.3 Web Applications installation CD from the .iso image.

    Note: Do not burn the .iso file to CD. Burn the contents of the .iso file (the .iso image) to CD.

Select the desired platform:

NetWare 6.0

Note: If you want to use your 1.x collections and roles with this version of iManager, they will need to be updated through the iManager 2.x Configuration Wizard.

Prerequisites

In addition to the general prerequisites listed in General Prerequisites, the following prerequisites apply to iManager on NetWare 6.0:

Procedure

For detailed iManager installation instructions, see the Novell iManager 2.0.x Administration Guide.

To install iManager on NetWare 6.0:

  1. Determine whether Tomcat 3.3 is listening on port 8080 (for Tomcat 3.3, this is disabled by default, but may have been enabled for debugging purposes). If the port is enabled, disable it by commenting out the Http10Interceptor tag in sys:\tomcat\33\nwserver.xml, then restart Tomcat 3.3 (at the NetWare command prompt, type tomcat stop followed by tomcat33).
  2. Verify that LDAP SSL is running. Run TCPCON from the NetWare console. Select Protocol Information > TCP > TCP Connections. Verify that port 636 is shown in the list of open ports.
  3. Run PKI Diag Utility (PKIDIAG). For more information, see Technical Information Document #2963420.
  4. Verify that there is adequate disk space on the volume. You will need approximately 200 MB of free disk space.
  5. Verify that Tomcat 3.3 is installed. The server should have a sys:\tomcat\33\ folder, and when you type JAVA -SHOW at the NetWare command line, org.apache.tomcat.startup.Main should appear in the list of Java processes.

  6. Determine the ports that Apache is listening on. Open the sys:\Apache\conf\adminserv.conf file and find the following line:

    # Start Apache Services Port Configuration

    Note the ports for both HTTP and HTTPS (Listen and SecureListen directives).

  7. Mount the eDir_873_webapps CD as a NetWare volume using the CDROM command.
  8. From the NetWare 6 GUI, click the Novell button, then select Install > Add.
  9. Select the product.ni file located in the iManager\installs\NW60 directory on the CD and complete the installation program.
  10. Modify the connector redirect ports in server.xml.
    1. Open the sys:\tomcat\4\conf\server.xml file.
    2. Find the Connector element that defines the HTTP/1.1 connector. The port is typically set to 8080. Change the redirectPort attribute from the default of 8443 to the port number you found in Step 6.
    3. Find the Connector element that defines the AJP 1.3 connector. The port is typically set to 8009. Change the redirectPort attribute from the default of 8443 to the port number you found in Step 6.
    4. Save your changes to server.xml and close the file.

  11. Open a Web browser and connect to iManager at the port discovered in Step 6. For example:

    https://IP:SecureListen port/nps/iManager.html


Windows

Prerequisites

In addition to the general prerequisites listed in General Prerequisites, the following prerequisites apply to iManager on Windows:

The iManager 2.0.2 installation program installs and configures the following items if it does not detect a compatible version:

If you are installing iManager on the same machine as eDirectory, verify that you have Require TLS for Simple Binds with Password checked on the LDAP Group object for the server that you are using to set up iManager. If this check box is not checked, iManager is installed in non-secure mode and plug-ins that require secure mode will fail.

Procedure

For detailed iManager installation instructions, see the Novell iManager 2.0.x Administration Guide.

To install iManager on Windows:

  1. From the eDir_873_webapps CD, run iManagerInstall.exe located in the iManager\installs\win directory.
  2. Follow the on-screen instructions.
  3. After the installation completes, your Web server is restarted. You might need to wait several seconds for the Web server to initialize before iManager will be available.

HINT: You can view the debug output of the installation program by holding down the Ctrl key immediately after launching the installer. Continue to hold down the key until a console window appears.


Linux

Prerequisites

In addition to the general prerequisites listed in General Prerequisites, the following prerequisites apply to iManager on Linux:

IMPORTANT: On Linux, iManager only works with the versions of Apache and Tomcat that are installed with iManager.

Procedure

For detailed iManager installation instructions, see the Novell iManager 2.0.x Administration Guide.

To install iManager on Linux:

  1. Open a shell, mount the CD and change to the eDir_873_webapps:\iManager\installs\unix directory.

  2. Enter the following command:

    ./install.sh

  3. Follow the on-screen prompts. The text within the brackets at the prompt is the default selection. Press Enter to accept the default. When prompted to enter the iManager server addresses or DNS host name, the IP address gets auto-detected.
  4. For the admin name, you must use dot notation (for example, cn=admin.o=novell).
  5. LDAP server IP address or DNS hostname defaults to the local machine. Make sure you use the IP address of eDirectory LDAP server in the eDirectory tree where you want to install iManager.

  6. Launch a supported browser and go to:

    https://server_ip_address:port_number/nps/iManager.html

    IMPORTANT: This URL is case sensitive. The server IP address can also be a DNS name.


Solaris

Prerequisites

In addition to the general prerequisites listed in General Prerequisites, the following prerequisites apply to iManager on Solaris:

Procedure

For detailed iManager installation instructions, see the Novell iManager 2.0.x Administration Guide.

To install iManager on Solaris:

  1. Open a shell, mount the CD and change to the eDir_873_webapps:\iManager\installs\unix directory.

  2. Enter the following command:

    ./iManagerInstallSolaris.bin

    For text only, enter the following command:

    ./iManagerInstallSolaris.bin -i console

  3. Follow the prompts.

  4. Stop and re-start Tomcat, then Apache by entering the following commands:

    /var/opt/novell/tomcat4/bin/shutdown.sh
    /var/opt/novell/tomcat4/bin/startup.sh
    /var/opt/novell/httpd/bin/apachectl stop
    /var/opt/novell/httpd/bin/apachectl startssl

    These services are not configured to start at boot-up.

  5. Launch a suppored browser and go to:

    https://server_ip_address:port_number/nps/iManager.html

    IMPORTANT: This URL is case sensitive. The server IP address can also be a DNS name.

  6. Log in as someone with admin-equivalent rights to the eDirectory tree, because the schema will be extended at this time.
  7. To access the Getting Started help screen, open the gettingstarted.html file located in the /var/opt/novell/tomcat4/webapps/nps/help/en/install directory.

HP-UX

Prerequisites

In addition to the general prerequisites listed in General Prerequisites, the following prerequisites apply to iManager on HP-UX:

Procedure

For detailed iManager installation instructions, see the Novell iManager 2.0.x Administration Guide.

To install iManager on HP-UX:

  1. Install the HP-UX Web Server Suite version 1.0.06.01 from the HP Software Depot Web site. The suite contains the official versions of Apache and Tomcat that are supported for HP-UX. You can update to version 1.0.10.01 after you create a new Apache SSL certificate in Step 4.

    NOTE: The version of openssl (0.9.7b) included with the HP-UX Web Server Suite versions A100901 and A101001 has problems generating certificates through Webmin. Install HP-UX Web Server Suite version A100601, which contains openssl version 0.9.6i, create a new SSL certificate for Apache through Webmin, and then update your HP-UX Web Server Suite to a newer version if you are installing iManager 2.0.2. If you would like to create certificates with openssl through Webmin in the future, back up /opt/hpws/Apache/bin/openssl before updating your HP-UX Web Server Suite from version A100601.

    Select the download with all components:

  2. Install Java 1.4.1_02 from the HP Java for HP-UX Web site and update your path to find the new Java.

  3. Add and export the following environment variables in the environment setting for the user that will be running Tomcat (usually located in the .bashrc file): JAVA_HOME, CATALINA_HOME, APACHE_HOME, SHLIB_PATH.

    For example:

    JAVA_HOME=/opt/java
    APACHE_HOME=/opt/hpws/apache
    CATALINA_HOME=/opt/hpws/tomcat
    SHLIB_PATH=/usr/lib:/usr/lib/nds-modules:$SHLIB_PATH
    export JAVA_HOME APACHE_HOME CATALINA_HOME SHLIB_PATH

  4. Install a new certificate for Apache. You must complete this step before continuing the installation. The certificate that is installed with Apache on HP-UX does not have the correct information for your server. You can install a certificate that you purchase from a trusted authority or a self-signed certificate.

    The Webmin administration tool can generate keys, certificates, and certificate requests for Apache. Webmin is installed with the HP-UX Web Server Suite. For more information, see the HP-UX Web Server Suite documentation, which is accessible from your Apache installation (http://IP_ADDRESS). For information on using Webmin to generate keys, certificates, and certificate requests, go to http://IP_ADDRESS/hp_docs/faq/#security11.

    IMPORTANT: Make sure you use the correct DNS name or IP address for the common name when you create a new certificate.

    Copy the certificates to the Apache directory: /opt/hpws/apache/conf/ssl.crt/ and /opt/hpws/apache/conf/ssl.key/.

  5. Logout or close the terminal session to load the environment variables.
  6. Open a shell, mount the CD and change to the eDir_873_webapps:\iManager\installs\unix directory.

  7. Type the following command:

    ./iManagerInstallHPUX.bin

    or

    sh iManagerInstallHPUX.bin

    For text only, enter the following command:

    ./iManagerInstallHPUX.bin -i console

    IMPORTANT: The iManager installer detects the HP-UX Web Server Suite. Do not change the install path for iManager.

  8. Start Tomcat and Apache. The command you use depends on your iManager configuration:

    /opt/hpws/tomcat/bin/startup.sh
    /opt/hpws/apache/bin/apachectl start

    or

    /opt/hpws/apache/bin/apachectl startssl

    NOTE: Tomcat might take 60 seconds or longer to load before you can access iManager, depending on the performance of your server.

  9. Run the extenNd DirectorTM Configuration Wizard. Follow the instructions in the Novell iManager 2.0.x Administration Guide.

For More Information

For information on additional issues for this release, see the Novell iManager 2.0.2 readme file.

For iManager documentation, see the Novell Product Documentation Web site.


Legal Notices

Disclaimer, Export Notice, Copyright, and Patents

Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes.

Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.

You may not export or re-export this product in violation of any applicable laws or regulations including, without limitation, U.S. export regulations or the laws of the country in which you reside.

Copyright © 2002-2004 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher.

Novell Trademarks

Novell and NetWare are registered trademarks of Novell, Inc. in the United States and other countries.

eDirectory is a trademark of Novell, Inc.

Third-Party Trademarks

All third-party trademarks are the property of their respective owners.