Chapter 2
Installation Instructions
This chapter includes the following sections:
Table 2-1 summarizes the installation steps and where to find the detailed instructions for these steps.
Step 1: Install the iPlanet Messaging Server 5.2 and Record Your Installation Parameters
See the iPlanet Messaging Server Installation Guide. Record you installation parameters, especially those listed in Table 1-1.
Step 2: Configure the Directory Server Plug-ins
Before you can install the Delegated Administrator, you may want to configure two optional plug-ins. The plug-ins are automatically installed with Directory Server 4.16, but need to be activated by modifying the SLAPD configuration file. The plug-ins are described below:
Class of Service. This plug-in determines a user's specific configuration values and resource limits based on a Class of Service attribute in the user entry. For more information see the Class of Service section in Chapter 6 of the iPlanet Delegated Administrator 4.5 Deployment and Customization Guide.
Directory Entry Counts. This plug-in automatically maintains count values for domains, groups, or users that are added to or deleted from the directory. This provides you with an up-to-date count of the number of entry types.
To Configure the Directory Server Plug-ins
Stop the Directory Server.
In each instance of Directory Server that you plan to use with Delegated Administrator, modify the following file (where NSHOME is the installation Directory root for the Messaging Server):
-
Directory_root/slapd-identifier/config/slapd.ldbm.conf
If you want to enable the Class of Service feature, remove the comments from the following lines by deleting the pound sign (#) at the beginning of the lines:
-
#plugin postoperation on "Class of Service" Directory_root/lib/cos-plugin.so cos_init o=iplanet.com
-
#plugin preoperation on "Class of Service init" Directory_root/lib/cos-plugin.so cos_preop_init
-
If the above two lines are missing, add them to the file without the comment characters.
Perform one of the following steps in order to include the counter plug-ins:
If the following line exists in the file, be sure it is uncommented:
-
include "Directory_root/slapd-rtfm/config/
counters.ldbm.conf"
-
Or,
Add the contents of the file Directory_root/slapd-identifier/config/counters.ldbm.conf to the file Directory_root/slapd-identifier/config/slapd.ldbm.conf.
Start the Directory Server.
Step 3: Configure the Directory Server
Optimizing page handling and search performance is recommended, but not required for all Delegated Administrator installations. Modifying the user entries is absolutely required if you've already provisioned your directory with users and groups. Follow the guidelines in the iPlanet Messaging Server Provisioning Guide to upgrade existing entries for use with the iPlanet Delegated Administrator.
Optimizing Page Handling and Search Performance
You can optimize Delegated Administrator page handling and search performance by modifying the Directory Server configuration. The following measures are necessary when any domain in your directory exceeds 5000 users.
Add indexes for the memberof attributes.
Reset the lookthroughlimit parameter.
Reset sizelimit parameters.
Set the All ID Threshold value appropriately.
To add appropriate indexes to your Directory:
Using Netscape Console, in the Directory Server window, select the Configuration tab and then click the Database icon.
Select the Indexes tab in the right pane.
To add the nsdadomain attribute, click Add Attribute, and then do the following:
In the Select Attributes window, select the nsdadomain attribute and then click OK.
Click Add Attribute and select nsdadomain from the Select Attribute list.
In the Additional Indexes list, select the nsdadomain attribute and then check the boxes for Equality, Presence, and Substring.
To add the memberof attribute, click Add Attribute, and then do the following:
In the Select Attributes window, select the memberof attribute and then click OK.
Click Add Attribute and select memberof from the Select Attribute list.
In the Additional Indexes list, select the memberof attribute and then check the boxes for Equality, Presence, and Substring.
To add a substring index for the uid attribute, in the Additional Indexes list, select the uid attribute. Then check the boxes for Equality, Presence, and Substring.
Click Save.
To reset the lookthroughlimit:
Using Netscape Console, in the Directory Server window, select the Configuration tab and then select Database in the left pane.
Select the Performance tab in the right pane.
In the Look Through Limit field, enter -1.
Click Save.
To reset the sizelimit parameter:
Using Netscape Console, in the Directory Server window, select the Configuration tab and then select the root entry in the navigation tree in the left pane.
Select the Performance tab in the right pane.
In the Size Limit field, enter -1.
Click Save.
Setting the All IDs Threshold Value
By default, the directory server is set to an All IDs threshold of 4000. For Delegated Administrator, this value should be just higher than the number of users in your directory. For detailed information on changing this value, see the Managing All IDs Threshold section in Chapter 7 of the iPlanet Directory Server Administrator's Guide at http://docs.iplanet.com/docs/manuals/directory/41/admin/index1.htm#1053642
Step 4: Install or Upgrade to iPlanet Web Server 6.0 SP2 (Service Pack 2)
iPlanet Web Server 6.0 SP2 (Service Pack 2) and iPlanet Delegated Administrator for Messaging and Collaboration must be installed on the same computer system. On Solaris, the Web server is on the CD at /solaris/ES. For HP-UX, the Web server is on the CD at /hpux/ES. For Windows NT, it is on the CD at /ntx86/ES.
If you do not have iPlanet Web Server 6.0 installed, install it now. If you have a older version of Web Server installed, it is recommended that you upgrade the server to the 6.0 Service Pack 2 version. Follow the instructions in the iPlanet Web Server 6.0 Installation Guide, available at http://docs.iplanet.com/docs/manuals/enterprise/50/ig/contents.htm. During installation, you do not have to specify a Directory Server when prompted for one.
|
Note
|
The iPlanet Web Server port must not be assigned to the same port as the Messenger Express (Web Mail) port, which was specified during the Messaging Server installation. Be sure to write down all parameters set during Web Server installation as these may be needed for configuration and iPlanet Delegated Administrator installation.
|
Step 5: Install Delegated Administrator
After completing the information sheet in Table 1-1, run the Delegated Administrator install program.
UNIX Installation Instructions
Become root and cd to the installation files directory on the CD at /solaris/iDA and enter ./setup. The following screens will appear during installation. We recommend that you write the entered installation values in the underscored fields of this document or in some other secure place for future reference.
Install Screen 1—Tips
-
---------------------------------------------------------
Sun-Netscape Alliance
iPlanet Delegated Administrator for Messaging and Collaboration
Installation/Uninstallation
---------------------------------------------------------
Welcome to the iPlanet Delegated Administrator for Messaging and
Collaboration installation program. This program will install iPlanet Server
Products and the iPlanet Console on your computer.
It is recommended that you have "root" privilege to install the software.
Tips for using the installation program:
- Press "Enter" to choose the default and go to the next screen
- Type "Control-B" to go back to the previous screen
- Type "Control-C" to cancel the installation program
- You can enter multiple items using commas to separate them.
For example: 1, 2, 3
Would you like to continue with installation? [Yes]: Yes
---------------------------------------------------------
-
Yes continues with installation. No terminates installation process.
-
* * *
Install Screen 2—License
-
---------------------------------------------------------
Sun-Netscape Alliance
iPlanet Delegated Administrator for Messaging and Collaboration
Installation/Uninstallation
---------------------------------------------------------
BY INSTALLING THIS SOFTWARE YOU ARE CONSENTING TO BE BOUND BY
AND ARE BECOMING A PARTY TO THE AGREEMENT FOUND IN THE
LICENSE.TXT FILE. IF YOU DO NOT AGREE TO ALL OF THE TERMS
OF THIS AGREEMENT, PLEASE DO NOT INSTALL OR USE THIS SOFTWARE.
Do you agree to the license terms? [n]:
---------------------------------------------------------
-
y continues. n terminates installation.
-
* * *
Install Screen 3—Install Location
-
---------------------------------------------------------
Sun-Netscape Alliance
iPlanet Delegated Administrator for Messaging and Collaboration
Installation/Uninstallation
---------------------------------------------------------
This program will extract the iPlanet Delegated Administrator for Messaging
and Collaboration application from the distribution media and install it into a
directory you specify.
Install location [/usr/netscape/ida10]:_______________________________
---------------------------------------------------------
-
This is the location of the iPlanet Delegated Administrator installation files. It can be placed anywhere in the directory. This parameter is required later for administrative purposes.
-
-
* * *
Install Screen 4—Enable Purge Command
-
---------------------------------------------------------
Sun-Netscape Alliance
iPlanet Delegated Administrator for Messaging Installation/Uninstallation
---------------------------------------------------------
If you want iPlanet Delegated Administrator for Messaging to manage a
Messaging Server, you will be asked for the Messaging Server identifier
and it's Administration Server URL.
Manage Messaging Server [Yes]:
-
Specify Host Name [galaxy.siroe.com]: ______________________________
Specify Admin URL: ______________________________________________
Specify CGI Path [msg-galaxy/Tasks/operation]:________________________
Specify Default Domain[siroe.com]:__________________________________
---------------------------------------------------------
-
Yes gives you access to the imadmin domain/family/group/user purge commands. You have access to the other iPlanet Delegated Administrator commands whether you answer yes or no, but the purge commands require this extra information. After answering yes, you are prompted for the following:
-
Host Name is the fully-qualified messaging server host name specified during Messaging Server installation, and should be in the Required Information Sheet for iPlanet Delegated Administrator Installation Sheet in Table 1-1.
-
Admin URL is the fully qualified host name and port number of the Administration Server for the Messaging Server installation. This information was specified during Messaging Server installation and should be in the iPlanet Delegated Administrator Installation Sheet in Table 1-1. Example: http://galaxy.siroe.com:1210
-
CGI Path—use the default. Typically this is
msg-instance/Tasks/operation
-
msg-instance represents the messaging server instance. For example, if your messaging server instance is siroe, the path is msg-siroe/Tasks/operation.
-
Default Domain is the domain of unqualified userIDs that do not belong to any particular domain. This information was specified during Messaging server installation, and should be in the Required Information Sheet for iPlanet Delegated Administrator Installation Sheet in Table 1-1.
-
* * *
-
If you answered no to the original question, you can add access to the purge commands later by adding these lines to the resource.properties file in DelegatedAdmin_root/nda/classes/netscape/nda/servlet/.
-
MsgSvr0-name=fully_qualified_host_name
MsgSvr0-adminurl=http://fully_qualified_host_name:host_port
MsgSvr0-cgipath=msg-host_name/Tasks/operation
MsgSvr0-defdomain= default_domain
-
After editing the resource.properties file, you must restart the enterprise server in order for the changes to take effect.
Install Screen 5—Calendar Server
-
---------------------------------------------------------
Sun-Netscape Alliance
iPlanet Delegated Administrator for Messaging Installation/Uninstallation
---------------------------------------------------------
If you want iPlanet Delegated Administrator for Messaging to manage an
iPlanet Calendar Server, enter 'Yes'.
Manage Calendar Server [No]: __________________
---------------------------------------------------------
-
Selecting Yes enables you to create and delete calendar resources. Note that you also must have the iPlanet Calendar Server installed to create these calendar resources. If it is not installed, attempts to create calendar resources on the GUI will fail.
-
If you answered no to the original question, you can enable the creation and deletion of calendar resources by modifying or entering the line NDADefaultConfiguration-calendar-support=yes in DelegatedAdmin_root/nda/classes/netscape/nda/servlet/resource.properties. Enter it under the line #### INSTALLER ####.
-
Note that currently there is minimal iPlanet Delegated Administrator support for iPlanet Calendar Server. Implementing iPlanet Delegated Administrator with Calendar Server is scheduled for a future release.
-
* * *
Install Screen 6—Enterprise Server
-
---------------------------------------------------------
Sun-Netscape Alliance
iPlanet Delegated Administrator for Messaging Installation/Uninstallation
---------------------------------------------------------
iPlanet Delegated Administrator for Messaging requires the configuration
directory of the Enterprise server instance. The Enterprise server must
be installed locally on this computer system, and iPlanet Delegated
Administrator for Messaging will be accessible only for this Enterprise
server instance.
Example: /home/es/https-machine/config
Specify Enterprise server config directory: ________________________
Specify web server port [8080]: _________________________________
---------------------------------------------------------
-
To specify the configuration directory for the Enterprise Server (web server) instance, enter the location of the configuration directory, which is located under the Enterprise Server root directory. Typically: server_root_dir/https-machine_name/config. This information is specified during Enterprise Server installation. See "Step 4: Install or Upgrade to iPlanet Web Server 6.0 SP2 (Service Pack 2)".
-
To specify the web server port, enter the port number of the iPlanet Web Server. This information is specified during the iPlanet Web Server installation.
-
* * *
Install Screen 7—LDAP Server Host & Port
-
---------------------------------------------------------
Sun-Netscape Alliance
iPlanet Delegated Administrator for Messaging Installation/Uninstallation
---------------------------------------------------------
iPlanet Delegated Administrator for Messaging requires the use of a
LDAP-based Directory Server for the administration of User/Group data.
This server is called the User/Group Directory.
Enter the non-SSL URL for the directory server:
ldap://<host>:<port>
Specify LDAP URL: ____________________________________
---------------------------------------------------------
-
This URL specifies the location of the machine and server port for the LDAP directory containing user/group data. This information is specified during Messaging Server installation and is in the Required Information Sheet for iPlanet Delegated Administrator Installation in Table 1-1. Example: ldap://galaxy.siroe.com:389
-
* * *
-
Install Screen 8—Directory Manager & Password
-
---------------------------------------------------------
Sun-Netscape Alliance
iPlanet Delegated Administrator for Messaging Installation/Uninstallation
---------------------------------------------------------
In order to create the suffix for iPlanet Delegated Administrator for
Messaging, enter the base DN and password of the user who can access the
Directory Server.
Specify Directory Manager [cn=Directory Manager]: ________________
Password: [from above]_________________________________________
---------------------------------------------------------
-
Enter the base DN and password of the Directory Manager (specified during the Messaging Server installation). These values are required because the iPlanet Delegated Administrator needs to create configuration entries in the LDAP directory. This information is in the Required Information Sheet for iPlanet Delegated Administrator Installation in Table 1-1.
-
* * *
Install Screen 9—Class of Service Plug-ins
-
---------------------------------------------------------
Sun-Netscape Alliance
iPlanet Delegated Administrator for Messaging Installation/Uninstallation
---------------------------------------------------------
The Directory Server that iDA uses does not have the Class of Services plugins
installed. You can continue the iDA installation now, but you need to install
the plugins later for iDA to work properly.
Continue iDA installation? [No]: Yes
---------------------------------------------------------
-
If the Class of Service plug-in hasn't been installed, this warning message appears. You can continue installation and install the plug-in at any time. See "Step 2: Configure the Directory Server Plug-ins."
-
* * *
Install Screen 10—User Data Suffix
-
---------------------------------------------------------
Sun-Netscape Alliance
iPlanet Delegated Administrator for Messaging Installation/Uninstallation
---------------------------------------------------------
iPlanet Delegated Administrator for Messaging requires a suffix to store
it's user data. If this base suffix does not exist the Installation
program will attempt to create it.
Example: o=isp
Exmaple: dc=isp, dc=com
Specify Suffix: ________________________________________
---------------------------------------------------------
-
Enter the root of the organization tree specified during the directory portion of the Messaging Server installation. It is the root under which the user data is to be stored. This information is in the Required Information Sheet for iPlanet Delegated Administrator Installation in Table 1-1.
-
* * *
Install Screen 11—DC Suffix
-
---------------------------------------------------------
Sun-Netscape Alliance
iPlanet Delegated Administrator for Messaging Installation/Uninstallation
---------------------------------------------------------
This suffix is already present in the directory.
Continue without installing iDA information in the directory? [No]: Yes
Specify DC Suffix [o=internet]:_____________________________
---------------------------------------------------------
For the first request, answer Yes. This parameter is for a standalone non-iMS installation. Sample data will not be installed if you choose Yes.
The second request is for the DC tree root that the system uses to locate domain information. This parameter is by default o=internet. Unless this parameter was reconfigured in the Messaging System, use the default.
-
* * *
Install Screen 12—Configuration Suffix
-
---------------------------------------------------------
Sun-Netscape Alliance
iPlanet Delegated Administrator for Messaging Installation/Uninstallation
---------------------------------------------------------
iPlanet Delegated Administrator for Messaging requires a suffix to store
it's configuration data. If this base suffix does not exist the
Installation program will attempt to create it.
Example: o=isp
Exmaple: dc=isp, dc=com
Specify Suffix [o=siroe.com]:
---------------------------------------------------------
-
Choose the suffix that stores configuration data.
-
* * *
Install Screen 13—URL
-
---------------------------------------------------------
Sun-Netscape Alliance
iPlanet Delegated Administrator for Messaging Installation/Uninstallation
---------------------------------------------------------
Extracting Netscape core components...
Extracting iPlanet Delegated Administrator for Messaging...
Restarting Enterprise Server
Connecting netscape browser to http://galaxy.siroe.com:2001/nda/start.htm
Press Return to continue...
---------------------------------------------------------
-
Remember the URL listed (example http://galaxy.siroe.com:2001/nda/login.htm) as you will need this to log in to the iPlanet Delegated Administrator. If you forget the port number, you can find it in server_root_dir/https-machine_name/config/server.xml.
Windows NT Installation Instructions
Double-click on the setup icon located on the CD at /ntx86/iDA. The following screens will appear during installation. We recommend that you write the entered installation values in the underscored fields of this document or in some other secure place for future reference.
Install Screen 1—Welcome
-
---------------------------------------------------------
Welcome to the iPlanet Delegated Administrator for Messaging and
Collaboration setup program.
We strongly recommend that you exit all Windows programs before running
this Setup program. Click Cancel to quit Setup and then close any programs
you have running. Click Next to continue with the Setup program.
WARNING: This program is protected by copyright law and international
treaties.
Unauthorized reproduction or distribution of this program, or any
portion of it, may result in severe civil and criminal penalties, and
will be prosecuted to the maximum extent possible under law.
---------------------------------------------------------
-
Next continues with installation. Cancel terminates installation process.
View Readme brings up information about iPlanet Delegated Administrator.
-
* * *
Install Screen 2—License
-
---------------------------------------------------------
To install iDA for Messaging and Collaboration, you must accept the
following license agreement. Use the scroll bars to view the rest of the
agreement
[Software Evaluation Agreement is displayed]
Do you accept all of the terms of the preceeding License Agreement?
If you choose No, the program will close.
---------------------------------------------------------
-
Yes continues. No terminates installation.
-
* * *
Install Screen 3—Install Location
-
---------------------------------------------------------
The setup program will install iDA for Messaging and Collaboration
in the destination directory shown below. If you want to install products
in a different directory, click Browse and choose a directory now. The
destination directory becomes the server root when installation is
complete.
When the directory you want as destination directory is shown below,
click Next.
You can choose not to proceed with installation by clicking Cancel
to exit Setup.
Installation Directory
c:\netscape\ida10 [Browse...]
---------------------------------------------------------
-
This is the location of the iPlanet Delegated Administrator installation files. It can be placed anywhere in the directory. This parameter is required later for administrative purposes.
-
-
* * *
Install Screen 4—Components to Install
-
---------------------------------------------------------
Select the products you want to install; uncheck the products
you do not want to install.
Products:
iDA for Messaging and Collaboration
Description of Selected Component
iPlanet Delegated Administrator for
Messaging and Collaboration [Change...]
Space Required: 7MB Space Available: 4564 MB
---------------------------------------------------------
-
Make sure that "iDA for Messaging and Collaboration" is highlighted in the "Products:" list in order for it to install.
Install Screen 5—Messaging Server Information
-
---------------------------------------------------------
If you want iPlanet Delegated Administrator for Messaging to manage a
Messaging Server that is already installed, enter the following information.
Manage Messaging Server
Messaging Server Information
Server Identifier: [galaxy.siroe.com]_______________________
Administration Server URL:
http://galaxy.siroe.com:<Enter the Admin Server Port Number>__________________
CGI Path: [msg-galaxy/Tasks/Operation]__________________________________
Default Domain: [siroe.com]_________________________________
---------------------------------------------------------
-
Checking Manage Messaging Server gives you access to the imadmin domain/family/group/user purge commands. You have access to the other iPlanet Delegated Administrator commands whether you check the box or not, but the purge commands require this extra information.
-
Server Identifier is the fully-qualified messaging server host name specified during Messaging Server installation, and should be in the Required Information Sheet for iPlanet Delegated Administrator Installation Sheet in Table 1-1.
-
Administration Server URL is the fully qualified host name and port number of the Administration Server for the Messaging Server installation. This information was specified during Messaging Server installation and should be in the iPlanet Delegated Administrator Installation Sheet in Table 1-1. Example: http://galaxy.siroe.com:1210
-
CGI Path—use the default. Typically this is
msg-instance/Tasks/operation
-
msg-instance represents the messaging server instance. For example, if your messaging server instance is siroe, the path is msg-siroe/Tasks/operation.
-
Default Domain is the domain of unqualified userIDs that do not belong to any particular domain. This information was specified during Messaging server installation, and should be in the Required Information Sheet for iPlanet Delegated Administrator Installation Sheet in Table 1-1.
-
* * *
-
If you unchecked Manage Messaging Server, you can add access to the purge commands later by adding these lines to the resource.properties file in DelegatedAdmin_root/nda/classes/netscape/nda/servlet/.
-
MsgSvr0-name=fully_qualified_host_name
MsgSvr0-adminurl=http://fully_qualified_host_name:host_port
MsgSvr0-cgipath=msg-host_name/Tasks/operation
MsgSvr0-defdomain= default_domain
-
After editing the resource.properties file, you must restart the enterprise server in order for the changes to take effect.
Install Screen 6—Calendar Server
-
---------------------------------------------------------
If you want iPlanet Delegated Administrator for Messaging to manage an
iPlanet Calendar Server, check the box below.
Manage Calendar Server
---------------------------------------------------------
-
Checking Manage Calendar Server enables you to create and delete calendar resources. Note that you also must have the iPlanet Calendar Server installed to create these calendar resources. If it is not installed, attempts to create calendar resources on the GUI will fail.
-
By default, Manage Calendar Server is unchecked.
-
If you leave Manage Calendar Server unchecked, you can enable the creation and deletion of calendar resources by modifying or entering the line NDADefaultConfiguration-calendar-support=yes in DelegatedAdmin_root/nda/classes/netscape/nda/servlet/resource.properties. Enter it under the line #### INSTALLER ####.
-
* * *
Install Screen 7—Enterprise Server
-
---------------------------------------------------------
The Enterprise server must be installed locally on this computer
system. iPlanet Delegated Administrator for Messaging will be
accessible only for this Enterprise server instance.
Enter the full path to the Configuration Directory of the
Enterprise server instance:___________________________________
Specify web server port [8080]: _________________________________
---------------------------------------------------------
-
To specify the configuration directory for the Enterprise Server (web server) instance, enter the location of the configuration directory, which is located under the Enterprise Server root directory. Typically: c:\server_root_dir\https-machine_name\config. This information is specified during Enterprise Server installation. See "Step 4: Install or Upgrade to iPlanet Web Server 6.0 SP2 (Service Pack 2)".
-
To specify the web server port, enter the port number of the iPlanet Web Server. This information is specified during the iPlanet Web Server installation.
-
* * *
Install Screen 8—LDAP Server Host & Port
-
---------------------------------------------------------
iPlanet Delegated Administrator for Messaging requires the use of a
LDAP-based Directory Server for the administration of User/Group data.
This server is called the User/Group Directory.
Host Name: [galaxy.siroe.com]_______________________
Non-SSL Port: [389]_______________________________
Setup will verify that this information is correct when you click
Next. Ensure that the Server Configuration Directory is running.
---------------------------------------------------------
-
This URL specifies the location of the machine and server port for the LDAP directory containing user/group data. This information is specified during Messaging Server installation and is in the Required Information Sheet for iPlanet Delegated Administrator Installation in Table 1-1. Example: ldap://galaxy.siroe.com:389
-
* * *
-
Install Screen 9—Directory Manager & Password
-
---------------------------------------------------------
In order to create the suffix for iPlanet Delegated Administrator for
Messaging, enter the base DN and password of the user who can access the
Directory Server.
Base DN: __cn=Directory Manager______________
Password: _________________________________________
---------------------------------------------------------
-
Enter the base DN and password of the Directory Manager (specified during the Messaging Server installation). These values are required because the iPlanet Delegated Administrator needs to create configuration entries in the LDAP directory. This information is in the Required Information Sheet for iPlanet Delegated Administrator Installation in Table 1-1.
-
* * *
Install Screen 10—Class of Service Plug-ins
-
---------------------------------------------------------
The Directory Server that iDA uses does not have the Class of Services plugins
installed. You can continue the iDA installation now, but you need to install
the plugins later for iDA to work properly.
Continue iDA installation? [Yes]: Yes
---------------------------------------------------------
-
If the Class of Service plug-in hasn't been installed, this warning message appears. You can continue installation and install the plug-in at any time. See "Step 2: Configure the Directory Server Plug-ins."
-
* * *
-
Install Screen 11—DC Suffix
-
---------------------------------------------------------
iPlanet Delegated Administrator for Messaging requires the
Directory Server domain component (DC) tree suffix that the
Delegated Administrator will manage.
If this suffix does not exist, the Installation program will attempt
to create it.
Enter the suffix under which the domain component (DC) tree
in the Directory Server resides.
Example: o=internet.
_____________________________
---------------------------------------------------------
-
This request is for the DC tree root that the system uses to locate domain information. This parameter is by default o=internet. Unless this parameter was reconfigured in the Messaging System, use the default.
-
* * *
-
Install Screen 12—Configuration Suffix
-
---------------------------------------------------------
iPlanet Delegated Administrator for Messaging requires a suffix to store
it's configuration data. If this suffix does not exist, the Installation
program will attempt to create it.
Example: o=isp
Example: dc=isp, dc=com
________________________________________
---------------------------------------------------------
-
Choose the suffix that stores the configuration data.
-
* * *
Install Screen 13—Configuration Summary
-
---------------------------------------------------------
If you want to review or change any information about the
installation about to be performed, click Back until you find the
screen with the relevant information. If you are ready to install,
click Next to begin the installation process.
Current Settings:
[List of current settings]
---------------------------------------------------------
-
Review the list of current settings. If any of the settings needs to be changed, click Back until you find the relevant screen.
-
If you are ready to install, click Next.
-
A dialog appears indicating the status of the install process.
Install Screen 14—Completion of Installation
-
---------------------------------------------------------
Setup has finished installing.
View Readme
When you click Finish, your installation will be complete
---------------------------------------------------------
-
Check View Readme to read information about iPlanet Delegated Administrator for Messaging and Collaboration .
-
When you click Finish, your browser will bring you to the iPlanet Delegated Administrator start page.
Reboot System
On Windows NT systems, it is necessary to reboot your system after the installation is complete.
Silent Installation
The installation program allows you to create a silent installation cache file that can be used to quickly install additional iPlanet Delegated Administrator instances in your enterprise. When you use the -k option during your first installation, you create the silent installation cache file (for example: ./setup -k). All of your responses to the installation prompts are recorded in that file.inf. See Table 2-2 for information on optional setup parameters.
Table 2-2 Optional Parameters for the setup command
|
Parameter
|
Description
|
|
-s
|
Silent installation mode. This parameter must be used in conjunction with the -f file parameter.
|
|
-f file
|
Specify file as the silent installation script. This parameter must be used in conjunction with -s parameter.
|
|
-k
|
Keep the installation cache.
|
|
Note
|
When you use a cache file, no new cache file is created from a silent installation.
If you have many similar server configurations to set up, you can place the configuration file and the server installation package on each machine. When you execute the setup program on each machine, it then extracts all information it needs from the configuration file as it performs the installation.
|
By running the silent installation, you instruct the setup program to read the silent installation cache file. The setup program uses the responses in this file rather than ask the same installation questions again for subsequent iPlanet Delegated Administrator installations. When you use the cache file in a new installation, you are not asked any questions. Instead, all of the cache file responses are automatically applied as the new installation parameters.
The silent installation cache file is saved in the /DelegatedAdmin_root/setup directory. For example, if you installed iPlanet Delegated Administrator into /usr/netscape/server4, the cache file for that installation is:
/usr/netscape/server4/setup/install.inf
To use the cache file for a fast installation of another iPlanet Delegated Administrator for Messaging and Collaboration instance, follow these steps:
Copy the silent installation cache file to the installation directory that you are using for the new installation.
Review and edit the silent installation cache file as necessary.
-
You will probably want to change some of the parameters and specifications in the cache file. For example, you might change the SuiteSportUserID or the SuiteSpotGroup that was initially recorded in the cache file. Remember that the parameters listed in the cache file will be automatically applied to this installation.
Run setup with the -s -f filename options where filename represents the full path and name of the silent installation cache file (See Table 2-2 for setup options.). For example:
-
./setup -s -f /home/foo/install.
Prior to an HP-UX iPlanet Delegated Administrator silent installation, you will need to create a user called nobody who has no privileges, does not reside in any group, is not root, and does not have a home directory. The user, nobody, should not be a user in your Messaging or Directory Server.
Using the Delegated Administrator
Access the iPlanet Delegated Administrator for Messaging and Collaboration Login Page by pointing a web browser to http://host:webserver_port/nda/login.htm.
You can use the Login Page to log in as any level of administrator named in the page. The user ID and password you use to log in determines your administrator role and determines which branches of the directory to which you have access.
To start Delegated Administrator from the Start Page:
In a browser, enter the URL for the Delegated Administrator host using the form http://host:webserver_port/nda/start.htm.
Click Login.
In the Delegated Administrator Login window, using the information on the Start Page, enter an administrator's system user ID and password. For example, to log in as serviceadmin, you would enter the following:
-
User ID: serviceadmin@default_domain.com
-
Password: password
Click Login.
-
Delegated Administrator displays the administration page that is appropriate for the User ID you entered.
Uninstalling Delegated Administrator
When you run the uninstall program, the following occurs:
All Delegated Administrator binaries are removed.
Delegated Administrator-related data is removed from the web server configuration files. However, the web server configuration files, containing the Delegated Administrator-related data, are backed up and renamed with .nda extensions (for example, servlets.properties.nda). Note that the data found between Delegated Administrator tags in the configuration files should never be manually edited.
The web server is restarted.
All Delegated Administrator files that were generated after initial installation remain on your computer system.
All data that was added to the directory when Delegated Administrator was installed, and any data that was added subsequently, remains in the directory.
To uninstall Delegated Administrator, run the uninstall program:
Both Directory Server and Web Server should be installed and running when you uninstall Delegated Administrator.
In Unix, cd to the install directory and enter ./uninstall
For Windows NT, execute the uninst.exe program.