NAME

       migrate-ds-admin.pl - Admin Server and Directory Server Migration script

SYNOPSIS

       migrate-ds-admin.pl [--options] -- [args]

DESCRIPTION

       Admin  Server  and  Directory  Server  migration  script - migrates Admin Server and all Directory Server
       instances from older releases to the current release.

       This script will copy instances (data and configuration) from the old server root directory to their  new
       FHS locations.  This script does a copy only - the data in the old instances will be left untouched.  The
       old instances must be shutdown first to ensure that the databases are copied  safely.   During  migration
       your migrated instances will be started.

OPTIONS

       A summary of options is included below:

       --help This message

       --version
              Print the version and exit

       --debug
              Turn on debugging

       --oldsroot
              The old server root directory to migrate from

       --actualsroot This is the old location of the old server root.

       --silent
              Use silent setup - no user input

       --file=name
              Use the file 'name' in .inf format to supply the default answers

       --keepcache
              Do not delete the temporary .inf file generated by this program

       --logfile
              Log migration messages to this file - otherwise, a temp file will be used

       --instance
              By default, all directory server instances will be migrated.  You can use this argument to specify
              one or more (e.g. -i slapd-foo -i slapd-bar) if you do not want to migrate all of them.

       --cross
              See below.

       For all options, you can also use the short name e.g. -h, -d, etc.  For the -d  argument,  specifying  it
       more than once will increase the debug level e.g. -ddddd

       args: You can supply default .inf data in this format:

              section.param=value

       e.g.

              General.FullMachineName=foo.example.com

       or

              "slapd.Suffix=dc=example, dc=com"

       Values  passed  in this manner will override values in an .inf file given with the -f argument.  The only
       required argument is the password of the Configuration Directory Administrator, which can be specified on
       the command line like this:

              migrate-ds-admin.pl General.ConfigDirectoryAdminPwd=thepassword

       All other parameters needed for migration will be read from the old Admin Server configuration.

       actualsroot:  This is used when you must migrate from one machine to another.  The usual case is that you
       have mounted the old server root on a different root directory, either via a network mount, or by copying
       a  tarball made using a relative directory on the source machine to the destination machine and untarring
       it.

       For example: machineA is a 32bit machine, and you want to migrate your servers to a  new  64bit  machine.
       Lets  assume  your  old  server  root on machineA was /opt/myds, and your new machine also wants to use a
       server root of /opt/myds.  There are a couple of different ways to proceed.  Either  make  a  tarball  of
       opt/myds  from machineA using a relative path (i.e. NOT /opt/myds) or use NFS to mount machineA:/opt/myds
       on a different mount point (e.g. machineB:/migration/opt/myds).

       If you do this, you should give the old "real" server root (/opt/myds) as the --actualsroot argument, and
       use  /migration/opt/myds  for the --oldsroot argument.  That is, the oldsroot is the physical location of
       the files on disk.  The actualsroot is the old value of the server root on the source machine.

       cross: Also known as crossplatform, or 'c', or 'x'.  This is when  the  source  machine  is  a  different
       architecture  than  the  destination  machine.   In  this  case,  only certain data will be available for
       migration.  Changelog information will not be migrated, and replicas will need to  be  reinitialized  (if
       migrating  masters  or  hubs).   This type of migration requires that all of your old databases have been
       dumped to  LDIF  format,  and  the  LDIF  file  must  be  in  the  default  database  directory  (usually
       /opt/fedora-ds/slapd-instance/db),  and  the  LDIF  file must have the same name as the database instance
       directory, with a ".ldif".  For example, if you have

              /opt/fedora-ds/slapd-instance/db/userRoot/
              and
              /opt/fedora-ds/slapd-instance/db/NetscapeRoot/

       you must first use db2ldif to export these databases to LDIF e.g.

              cd /opt/fedora-ds/slapd-instance
              ./db2ldif -n userRoot -a /opt/fedora-ds/slapd-instance/db/userRoot.ldif and
              ./db2ldif -n NetscapeRoot -a /opt/fedora-ds/slapd-instance/db/NetscapeRoot.ldif

       Then you must somehow make your old server root directory available on the destination machine, either by
       creating a tar archive on the source and copying it to the destination, or by network mounting the source
       directory on the destination machine.

AUTHOR

       migrate-ds-admin.pl was written by the 389 Project.

REPORTING BUGS

       Report bugs to http://bugzilla.redhat.com.

COPYRIGHT

       Copyright © 2008 Red Hat, Inc.
       This manual page was written by Michele Baldessari <michele@pupazzo.org>, for the Debian project (but may
       be used by others).
       This is free software.  You may redistribute copies of it under the terms of the Directory Server license
       found in the LICENSE file of this software distribution.  This license is essentially the GNU General
       Public License version 2 with an exception for plug-in distribution.

                                                  May 18, 2008                            MIGRATE-DS-ADMIN.PL(8)