Provided by: 389-admin_1.1.42-2_amd64 bug

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)