Installation guide

IMPORTANT
If there are any duplicate entries (based on duplicate DNs), then the upgrade process makes a
copy of the database. It is possible, in an extreme case, that the upgraded database could be
twice the size of the original database, until the duplicate antries are resolved. As a precaution,
make sure there is enough disk space available for the upgrade, meaning that there is twice the
current database size available.
If there is not enough disk space available, the upgrade process files with the error message
Failed to back up backend instance 'instance_name'.
1. Back up all the Directory Server user and configuration data. For example:
cd /usr/lib/dirsrv/slapd-instance_name
db2bak /var/lib/dirsrv/slapd-instance_name/bak/instance_name-
2010_04_30_16_27_56
2. Get the repo name by running yum check-update. For example:
yum check-update
Loaded plugins: rhnplugin, security
rhel -x86_64-server-5-rhdirserv-8
3. Install or upgrade the Directory Server 8.2 packages. For example:
yum update -y
This automatically updates the Red Hat Directory Server packages as well as any other required
packages.
Red Hat Directory Server 8.2 requires that all of the packages in the Red Hat Directory Server
channel be updated. Running simply yum update updates all Red Hat Directory Server and Red
Hat Enterprise Linux packages. T o exclude packages from updating on your system, you can use
--exclude packages, restrict the update to only the Red Hat Directory Server channel, or
explicitly list the packages to update. Run m an yum for a list of options. For example:
yum update -y --disablerepo=* --enablerepo=rhel-x86_64-server-5-rhdirserv-8
4. Re-run the setup-ds-admin.pl script, using the -u to update the configuration. Make sure that
the Directory Server and Admin Server are running when the script is run.
setup-ds-admin.pl -u
Go through the setup process again to re-register the updated Directory Server. The upgraded
server has the same configuration as the 8.1 server. It is also possible to pass information with
the setup-ds-adm in.pl script, as in Section 4.5, “Silent Setup”
The setup-ds-adm in.pl script updates the Directory Server core packages and configuration
and the Directory Server and Admin Server consoles.
5. Verify that the packages have been properly updated by checking the version number on one of
the Directory Server packages. For example:
Red Hat Directory Server 8.2 Installation Guide
76