19.2 Migrating Novell Archive and Version Services from Netware to OES 11 SP2

This section provides information on how to migrate Novell Archive and Version Services running on NetWare 6.5 SP8 to Open Enterprises Server (OES) 11 SP2. In this section, the Netware server is referred to as the source server and the OES 11 SP2 server is referred to as the target server.

For general information on the OES 11 SP2 Migration Tool, see Section 1.0, Overview of the Migration Tools

19.2.1 Prerequisites

Before proceeding to migrate, meet the following prerequisites:

  • The Archive server is installed on NetWare 6.5 SP8. For more details, refer to the NW 6.5 SP8: Novell Archive and Version Services 2.1 Administration Guide.

  • Install the NSS file system on the OES 11 server.

  • The Archive server and the Primary volume must reside in the same eDirectory tree.

  • The Archive server, PostgreSQL database, and Archive volume must be installed on the same machine.

19.2.2 Migration Scenarios

The supported scenarios for Archive and Versions Services are as follows:

Migrate - Same Tree

In the Migrate scenario, the data and configuration on the source server is overwritten.

Transfer ID - Same Tree

In this scenario, the target server is installed in the same tree as the source server. On successful completion of Transfer ID, the target server functions with the same credentials (such as IP address and hostname) as the source server and source server node is no longer available in the network.

What is Migrated

The following data is migrated from the source server to the target server:

  • The Archive volume that contains the versions of your files.

  • The configuration details stored in arkConfig.xml file.

  • Database records from the MySQL database to the PostgreSQL database.

19.2.3 Migration Procedure

  1. Install the OES 11 server as the target server for the Archive and Version Services into the same edirectory tree as the source server.

    For more information on installing Novell Archive and Version Services, see Setting Up Archive and Version Services in the OES 11 SP2: Novell Archive and Version Services Administration Guide.

  2. To stop the Archive and Version Services on source server and continue to run the MySQL database, enter

    arkstop

  3. To stop the Archive Service on the target server, enter

    rcnovell-ark stop

    This command stops the Archive server and the default instance of the PostgreSQL database.

  4. If you have configured the Archive server with the default configuration, restart the PostgreSQL database with the following command:

    /opt/novell/arkmanager/bin/pg_restart.sh

  5. Migrate data from Archive volume on the NetWare server to the OES 11 server.

    The migration is from the NetWare NSS source volume to the OES 11 NSS target volume, where the source and target servers are in the same eDirectory tree. For more information, refer to the OES 11 SP2: NSS File System Administration Guide for Linux.

    IMPORTANT:You need to migrate the Archive volume before migrating the Archive and Version Service; otherwise, versions of files created on the NetWare server are unusable on OES 11 server.

  6. (Optional) Migrate data from the Primary volume on the NetWare server to the OES 11 SP2 server, using either command line utilities or the GUI interface. For more information, refer to the OES 11 SP2: NSS File System Administration Guide for Linux.

  7. Decide how to migrate Archive and Version Services.

    The Migration Tool GUI has a plug-in architecture and is made up of command line utilities with a GUI wrapper. You can migrate Archive and Version Services by using either of the following methods:

Using the Migration Tool GUI

  1. Click Computer> More Applications> System > Novell Migration Tools to launch the Migration Tool GUI.

    For more information on using the Migration Tool GUI, refer to Section 5.0, Using the Migration Tool GUI.

  2. Authenticate to the source and target server. Archive and Version Services is listed in the Service panel.

    Select the Migration Type as Migrate for migrating Archive service, or to Transfer ID for Transfer ID scenario.

  3. In the Services to Migrate panel, click Add and select Novell Archive and Versioning Services.

    The Status of the service is Not Configured.

  4. Select Novell Archive and Versioning Service and click Configure.

  5. Fill in the fields, using the information in the following table:

    Parameter

    Description

    MySQL User Name

    Specify a username for the administrator of the MySQL database on the source server.

    MySQL Database Password

    Specify a password for the MySQL user.

    MySQL Database Port

    Specify a port number used for the archive database communications on the source server. Port 3306 is the default.

    PostgreSQL Database User Name

    Specify a username for the administrator of the archive database (the PostgreSQL database for the archived data) on the OES 11 server.

    IMPORTANT:The Postgres user must be an unprivileged user, not the root user.

    PostgreSQL Database Password

    Specify a password for the PostgreSQL user.

    PostgreSQL Database Port

    Specify a port number to use for the archive database communications on the OES 11 server. Port 5432 is the default.

  6. Click OK.

    The Status of the service is Ready.

  7. Click Start to proceed with migration. The Status is Migrating.

    In the Status pane, Service tab, you can view the progress of migration. On completion of migration, the Status changes to Migrated.

    NOTE:If you encounter any errors during migration, check the Logs tab in the Service pane. After resolving the errors, execute the migration procedure again.

Using the Command Line

  1. To run the Archive and Version migration utility through command line, run /opt/novell/migration/bin/migark.sh with the following details:

    Option

    Description

    --mysqldb-user=<opt>

    Specify a username for the administrator of the MySQL database.

    --mysqldb-passwd=<opt>

    Specify a password for the MySQL user.

    --mysqldb-port=<opt>

    Specify a port number used for the archive database communications on NetWare server. Port 3306 is the default.

    --hostname=<opt>

    Specify the host name or IP address of the NetWare server on which Archive and Version Services resides.

    --username=<opt>

    Specify the fully distinguished eDirectory name and context of the administrator user. For example, cn=admin.o=novell

    NOTE:Use the dot (.) format for specifying the eDirectory name and context, not the comma (,) format.

    --password=<opt>

    Specify a password for the Admin user.

    --pg_db-user=<opt>

    Specify a username for the administrator of the archive database (the PostgreSQL database for the archived data) on the Novell OES 11 server.

    IMPORTANT:The Postgres user must be an unprivileged user, not the root user.

    --pg-db-passwd

    Specify a password for the PostgreSQL user.

    --pg_db-port=<opt>

    Specify a port number to use for the archive database communications on the OES 11 server. Port 5432 is the default.

    For example:

    /opt/novell/migration/bin/migark.sh --mysqldb-user=root --mysqldb-passwd=novell --mysqldb-port=3306 --hostname=192.168.1.255 --username=cn=admin.o=novell --password=novell12 --pg_db-user=arkuser --pg_db-passwd=novell12 --pg_db-port=5432

NOTE:If you encounter any errors during migration, check the archive_migration.log file in the /var/opt/novell/log/migration/ folder. After resolving the errors, execute the migration procedure again.

19.2.4 Post-Migration Procedure

  1. Before restarting the Archive server, ensure the following:

    • Migration of the Archive volume is successful.

    • (Optional) Migration of Primary volume is successful. In the arkConfig.xml file under the job tag, ensure that the server name and context reflect the configuration details of the target machine.

    • The migrated data from the volumes and database is consistent.

    • Edit arkConfig.xml to update the Archive volume path under archivePath tag on the OES 11 server.

    • Ensure that the admin is a part of the novlxtier group. For more information, refer to Caveats on Upgrading from OES 2 to OES 11 SP2 in the OES 11 SP2: Novell Archive and Version Services Administration Guide.

    • Ensure that the admin is LUM-enabled on the target server running Archive and Version Services.

    • Ensure that the read only attribute is not set on the ARK volume.

      To check if the ARK volume has the read only attribute, enter attrib /media/nss/ARK. The output of the above command includes the read only (ro) attribute.

      To delete the read only attribute, enter attrib -c ro /media/nss/ARK

  2. To start the Archive Service on OES 11 SP2 server, enter:

    rcnovell-ark start

Verifying Migration

To verify that migration completed successfully, check the availability of file versions by using the NSS File Version Utility.