HP Tru64 UNIX Enterprise Directory Installing Revision/Update Information: Version 5.5 ECO1 This kit also contains HP Administrator for Enterprise Directory V2.2. Checklist: 1. Read the Read Before Installing document. 2. If upgrading from a previous version, you must create a snapshot file of your current database, using these commands: ncl> disable dsa ncl> delete dsa to snapshot 3. Deinstall previous version of the Directory. 4. Check prerequisite software, diskspace, and licenses. 5. Install Version 5.5 ECO1 of the Directory (release notes subset first). 6. Use setld -v to verify the installation. 7. If DECnet-Plus is installed then run the create_ templates procedure. 8. If upgrading or reinstalling, recustomize any customized files, specifically: The schema files (recompile the schema if you customize it) dxd_dsa_startup.ncl (was called start_dsa.ncl prior to DSA V5.3) dxd_dsa_shutdown.ncl (was called stop_dsa.ncl prior to DSA V5.3) dxd_dsa_process start_dsa_event_dispatching.ncl The deinstallation of the previous version saves files that might be customized. See Read Before Installing for more information. 9. Start the Directory Service. If upgrading from a previous version, create the DSA from the snapshot file: ncl> create dsa from snapshot ncl> enable dsa 1 Prerequisite Software o Tru64 UNIX V5.1A or later. o Optionally, 1. For LDAPv3 over SSL, OpenSSL 0.9.6g for Tru64 UNIX 5.1 or higher, or later. 2. DECnet-Plus V5.1A for Tru64 UNIX, or later (This is required if you intend to run X.500 protocols over an OSI network.) 2 Information Required Before you install the Tru64 UNIX Enterprise Directory, make sure you know the location of the installation kit. This is either a device name or a mount point. 3 Disk Space and Time Required The installation subsets require the following free disk space in kilobytes on /usr: and /var __________________________________________________________ Component__________________in_/usr____in_/var_____________ Base (mandatory 3000 500 component) Server 4000 50 Admin[1] 4300 600 API 7800 - LUC 8300 - Relnote 300 - Man 300 - [1]_______________________________________________________ This is not the HP Administrator for Enterprise Directory; it is the Admin component. 2 __________________________________________________________ Component__________________in_/usr____in_/var_____________ HP AED[2] Windows kit - 62500 HP AED Utility - 47500 Total 28 Mb 111 Mb [2]_______________________________________________________ This is the HP Administrator for Enterprise Directory; it is the Windows GUI for managing the Directory. __________________________________________________________ You are recommended to back up your system disk before the installation. Installation of all components takes approximately 15 minutes. 4 Product Licenses Before you install the software, you must register one or more of the following licenses: X500-DIRECTORY-SERVER, X500-SERVER-USAGE, and X500-ADMIN-FACILITY. 5 Before Upgrading from a Previous Version of the Directory On Tru64 UNIX the DSA uses memory image files instead of snapshot files. Memory image files are specific to the version of the kit. This applies to all versions (SSB, ECO kits, and FT kits). Therefore, your current memory image files cannot be used by this kit. To use your existing database with this kit, create a snapshot file of your database before you upgrade. To create a snapshot file, disable and delete the DSA using the following NCL commands: ncl> disable dsa ncl> delete dsa to snapshot After installing this release, use the following NCL commands to recreate the DSA: ncl> create dsa from snapshot ncl> enable dsa 3 When the DSA has been recreated and enabled successfully, you can delete the snapshot file from the DSA system as follows: # rm /var/dxd/DSA-information-tree.snapshot* The DSA does not need this file any longer, so you can save disk space by deleting it. Do not delete any of the other database files. 6 Release Notes and Read Before Installing Document The release notes are provided in a Relnote subset. You are recommended to install the Relnote subset and read the release notes before installing any other subsets. The product documentation includes a Read Before Installing document, which you are recommended to read before installing any components. 7 Installing the Tru64 UNIX Enterprise Directory and HP Administrator for Enterprise Directory Log in with superuser privileges. Make sure you are in the root directory. Type: # setld -l source where source is either a mount point directory or a device-specific file name of the installation kit. The installation procedure displays a menu. Select the components that you want to install, and follow the instructions. The Base component is a prerequisite for all Enterprise Directory components, and is required on all systems from which you want to manage the Directory Server, and all systems on which you want to run directory applications. HP Administrator for Enterprise Directory is an optional subset. Installing on a Distributed Computing Environment System If you install the DCE software after the Directory, you will need to reinstall the Directory. Make sure that the DCE software is installed before the Directory. 4 Files Saved When Deinstalling The installation procedure saves some files if you use setld to deinstall a subset. The files that are saved are as follows: /var/dxd/scripts/create_inbound_clns_template.ncl /var/dxd/scripts/create_inbound_cons_template.ncl /var/dxd/scripts/create_outbound_clns_template.ncl /var/dxd/scripts/create_outbound_cons_template.ncl /var/dxd/scripts/start_dsa_event_dispatching.ncl /var/dxd/scripts/dxd_aci_template.dxim /var/dxd/scripts/dxd_dsa_startup.ncl /var/dxd/scripts/dxd_dsa_shutdown.ncl ________________________Note ________________________ Prior to DSA V5.3 release, the file dxd_dsa_ startup.ncl was called start_dsa.ncl, and the file dxd_dsa_shutdown.ncl was called stop_dsa.ncl. _____________________________________________________ 8 HP Administrator for Enterprise Directory If you want to use HP Administrator for Enterprise Directory+ for management of your directory, you should first install the components "HP Administrator for Enterprise Directory - Windows" and "HP Administrator for Enterprise Directory - Utility". When the installation is complete, copy the file directoryadministrator.exe from /var/dxd/caed_win32 to your PC. This file is an executable program that when run on a PC will install HP Administrator for Enterprise Directory. You can also check for a later version of the pro- gram that can be downloaded directly onto a PC from (http://h71000.www7.hp.com/commercial/edir/edir_mgt_gui_download.html). ___________________ + See the file ReadMe.txt in the HP Administrator for Enterprise Directory kit for details. 5 9 Handling Errors If an error occurs during installation, make sure that you have the correct prerequisite software and sufficient disk space. Repeat the installation, keeping a log of the messages displayed. If the problem occurs at the same point, refer to HP Enterprise Directory - Problem Solving. 10 Verifying the Installation To verify that all installed files are in the correct locations and have the correct protections, type: # setld -v subset where subset is one or more of DXDABASE550, DXDASRVR550, DXDADXIM550, DXDARELNOTE550, DXDAAPI550, DXDALUC550, DXDAMAN550, DXDAADMWIN220 and DXDAADMUTIL220. 11 Tasks After Installation After installation, if you have DECnet-Plus installed, you need to run a procedure that creates OSI transport templates required by the directory components, as follows: If you do not run this procedure after installation, you will be unable to use the directory components on this system until the next system reboot. You can now configure the Tru64 UNIX Enterprise Directory as described in HP Enterprise Directory - Management. If you are upgrading from a previous version, then you may have saved copies of schema files. Modify the schema files provided by this installation to include any customizations you made to the previous version, and then recompile the schema. You can then start the DSA. Note that if DECnet or DCE software are installed after you install the Directory Service, you will need to reinstall the Directory Service. 6 12 Further Information HP Enterprise Directory - Problem Solving contains a list of the files that should be present on your system after installation, their locations and approximate sizes. The guide also lists errors that you might see during installation and verification and explains what to do if they occur. © Copyright 2006 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. A FULL SOFTWARE PATCH KIT HAS RECEIVED LIMITED TESTING AND IS CONSIDERED APPROPRIATE FOR GENERAL DISTRIBUTION TO CUSTOMERS. DISCLAIMER OF WARRANTY AND LIMITATION OF LIABILITY THIS FULL SOFTWARE PATCH KIT IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND. ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR PARTICULAR PURPOSE, OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED TO THE EXTENT PERMITTED BY APPLICABLE LAW. IN NO EVENT WILL HP OR ANY OF ITS SUBSIDIARIES BE LIABLE FOR ANY LOST REVENUE OR PROFIT, OR FOR SPECIAL, INDIRECT, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, WITH RESPECT TO ANY SOFTWARE PATCH MADE AVAILABLE HERE OR TO THE USE OF SUCH SOFTWARE PATCH. 7