=========================================================== = ARKEIA V6.0 TO V7.0 MIGRATION PROCEDURE READ ME = = = = This file is the READ ME for the migration = = procedure from Arkeia v6.0.x to Arkeia v7.x = = = = Version 1.0 released on 2007-11-27 = = = = Copyright (c) 2008 by Arkeia Corporation, = = All Rights Reserved. = = = =========================================================== =========================================================== = NOTE = =========================================================== = If you migrate from a version prior to 6.0, you need to = = migrate to 6.0 FIRST. = =========================================================== =========================================================== = WARNING!! = =========================================================== = PLEASE NOTE: = = = = While Arkeia Corporation has tried to provide a = = complete and fairly "safe" migration procedure for its = = products, your should be aware that this = = procedure can have potentially destructive effects = = on existing Arkeia v6.y.x servers. = = = = ARKEIA CORPORATION RECOMMENDS THAT YOU READ AND = = UNDERSTAND THIS FILE BEFORE ATTEMPTING THE MIGRATION = = PROCEDURE. = = = = FURTHERMORE, ARKEIA CORPORATION DISCLAIMS ANY LIABILITY = = FOR THE LOSS OF DATA RESULTING FROM THE USE OF THIS = = PROCEDURE. EXCEPT WHEN OTHERWISE STATED IN WRITING = = ARKEIA CORP AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS= = IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR = = IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED = = WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A = = PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY = = AND PERFORMANCE OF THE PROGRAM IS WITH YOU. = =========================================================== = WARNING!! = =========================================================== TABLE OF CONTENTS ================= 1. What is the migration procedure? 2. Obtaining the migration procedure. 3. Running the migration procedure on a server. 3.0 Keep a copy of the v6.y.x configuration. 3.1 Required operations before migration. 3.2 Upgrade the Arkeia server backup to v7.x 3.3 Running the migration procedure 3.4 Tasks to be performed after the migration. 3.5 Test the migrated new version. 4. Running the migration procedure on a client. 5. How to obtain help on the migration procedure. 1. What is the migration procedure? =================================== The Arkeia migration procedure is designed to ease the transition from Arkeia 6.y to Arkeia 7.0 This migration procedure can only be run by script. It is designed to preserve the maximum amount of user information and configuration parameters, so that the existing v6.y.x configuration will be carried over to the new 7.x version of Arkeia, with minimal adjustment by the system administrator. Applying the migration procedure to an existing Arkeia v6.y.x server allows the administrator to transfer the following information to the Arkeia 7.x server: -- Disk space configured for backup; FILE libraries are migrated to a new object called VTL. -- Backups made on FILE libraries. -- Periodic backups configured with FILE libraries. 2. Obtaining the migration procedure. ===================================== The Arkeia migration procedure from the following sources: - the Arkeia Corporation web site, at the following URL: http://www.arkeia.com - the 7.0 Arkeia backup server packages, where it can be found in the following directory: /opt/arkeia/bin/migration The procedure is installed by default at the same time as the Arkeia server. PLEASE NOTE: The Arkeia v6.y license must be upgraded to an Arkeia v7.0 license or the migration procedure will not be able to work properly. Please contact the Arkeia Sales Team for more information. 3. Running the migration procedure on an Arkeia server. ======================================================= The migration procedure requires these steps: - Make a copy of the v6.y configuration, for safety. - Close down Arkeia processes. - Run the migration by script. - Test the new version. 3.0 Keep a copy of the Arkeia v6.y configuration ------------------------------------------------ The automatic procedure makes a copy of the Arkeia parts that will be migrated. We suggest you to make a copy yourself before starting modifications. * Make your own copy of the following directory (a) The Arkeia tape cartridge directory: /opt/arkeia/server/dbase/f3tape (b) The Arkeia drive directory: /opt/arkeia/server/dbase/f3drv (c) The Arkeia tape library directory: /opt/arkeia/server/dbase/f3lib (d) The Arkeia drivepack directory: /opt/arkeia/server/dbase/f3dpk PLEASE NOTE: Although the automatic procedure will make these copies, it is absolutely ESSENTIAL to make them BEFORE the migration procedure itself is launched IF THE MIGRATION FAILS, AND YOU HAVE NOT MADE THESE COPIES, YOU MAY LOSE ALL YOUR BACKED UP DATA!! 3.1 Required operations before the migration -------------------------------------------- The following operations must be performed BEFORE attempting the migration of an Arkeia v6.y.x server to an Arkeia v7.x: * Arkeia v7.x comes with a default VTL license which allows 1TB of configured VTLs. Before it creates the new VTL(s), the migration verifies that you have a sufficient VTL license for the amount of configured FILE tapes. Therefore, you should install a valid VTL license before starting the migration. * Stop all the Arkeia v6.y.x processes: (a) Stop all jobs and backup, restore or verification operations. (b) Stop all library processes (Library management + stop library) (all arkvlib, arklib processes must be stopped). (c) Quit the Arkeia v6.y.x GUI. (No "arktrans" processes should be left running). 3.2 Upgrade the Arkeia server backup to v7.x ---------------------------------------------- For the moment, upgrade only the Arkeia backup server v6.y using rpm package or .tar.gz * Stop Arkeia v7: Arkeia version 7 must be stopped BEFORE the migration procedure can be started. To do this, enter this command as root: /opt/arkeia/bin/arkboot stop Check that all the Arkeia processes have been stopped by entering this command as root: ps -faxuw | grep ark 3.3 Starting the migration -------------------------- The migration can only be run as a script. 3.3.1 Running the migration procedure script -------------------------------------------- To run the migration procedure, simply enter the following command as root: /opt/arkeia/bin/migration/arkmigrate-60-70 The following options must be supplied on the command line: --path [VALUE] Arkeia v6.y.x root directory. (Default is : /opt/arkeia). For example, the following command, entered as root, would perform a valid migration from the Arkeia v6.y.x to the new Arkeia v7.x, located in the directory /usr/local/arkeia /opt/arkeia/bin/migration/arkmigrate-60-70 --path /usr/local/arkeia Follow the instructions printed on the screen to complete the migration. 3.4 Tasks to be performed after the migration --------------------------------------------- Do not forget to install the v7.0 license using the Arkeia GUI (Graphical User Interface). 3.5 Testing the migrated information ------------------------------------ We recommend that you test the Arkeia v7 server using the migrated information. To do this, follow the steps below: -- Check the backup list of the VTL. -- Check that you can restore some files that were on the FILE library. -- Check the content of the drivepacks that were holding a FILE library. -- Start a small backup using a VTL. 4. Running the migration procedure on a client machine. ======================================================= There is no need to immediately migrate the client to Arkeia version 7.0: an Arkeia version 7.0 server is backward-compatible and can backup and restore data to v6.y.x clients. 5. Obtaining help on the migration procedure. ============================================= For any problems or issues regarding the migration procedure from Arkeia v6.y.x to Arkeia v7.x, please contact the Arkeia Technical Support Team. The web page for the Technical Support Team is: http://www.arkeia.com/support.html Thank you for using Arkeia version 7. We hope this migration procedure will be useful to you! Arkeia Software.