Home Print  
StoreGrid Vembu Technologies

Migrating from older version to v3.1

Migration from older version to v3.1 is not supported. v3.1 has to be installed as a fresh installation. Migration from v2.5.1 to v3.x will be supported in future.

Migrating from version 2.4 to 2.5.1

You can install StoreGrid v2.5.1 on top of the existing version 2.4 and StoreGrid will automatically migrate to v2.5.1. Before migrating to v2.5.1, please make a note of the following instructions:

  • To upgrade to v2.5.1, you should be currently running the v2.4.

  • To upgrade to v2.5.1, just install v2.5.1 on top of the v2.4 installation. DO NOT UNINSTALL v2.4.

  • If you are currently running a previous version, make sure you first upgrade to v2.4 and start StoreGrid to complete the migration process before installing v2.5.1.

Also ensure that your backup server is running the same (or higher) version than the clients backing up to it. For example: before upgrading clients to v2.5.1, you must ensure that your backup server has been upgraded to v2.5.1; we typically ensure backward compatibility for clients, for example, a v2.4 client can still backup to a v2.5.1 server (this way, you can upgrade your clients in a phased manner). In short, ALWAYS UPGRADE THE BACKUP (& REPLICATION) SERVERS FIRST.

Versions previous to v2.4 cannot be migrated directly to v2.5.1. If you are running StoreGrid version older than v2.4, follow the migration steps given in "Migrating from version 2.3.5 to 2.4" section below. You can download the v2.4 from http://www.storegrid.com/online-backup/storegrid-24-downloads.php?edt=pro.

Migrating from version 2.3.5 to 2.4

You can install StoreGrid v2.4 on top of the existing version 2.3.5 and StoreGrid will automatically migrate to v2.4 release. Before migrating to v2.4, please make a note of the following instructions:

  • To upgrade to v2.4 SP edition, you should be currently running the v2.3.5 SP edition.

  • To upgrade to v2.4, just install v2.4 on top of the v2.3.5 installation. DO NOT UNINSTALL v2.3.5.

  • If you are currently running a previous version, make sure you first upgrade to v2.3.5 and start StoreGrid to complete the migration process before installing v2.4.

Also ensure that your backup server is running the same (or higher) version than the clients backing up to it. For example: before upgrading clients to v2.4, you must ensure that your backup server has been upgraded to v2.4; we typically ensure backward compatibility for clients, for example, a v2.3.5 client can still backup to a v2.4 server (this way, you can upgrade your clients in a phased manner). In short, ALWAYS UPGRADE THE BACKUP (& REPLICATION) SERVERS FIRST.

Versions previous to v2.3.5 cannot be migrated directly to v2.4. You will have to first migrate them to v2.3.5 and install v2.4 on top of it. For versions previous to v2.2.1, first migrate them to v2.2.1 and to v2.3 and then to v2.3.5. You can download the v2.2.1 from http://www.storegrid.com/online-backup/storegrid-pro-221-downloads.php, version v2.3 from http://www.storegrid.com/online-backup/storegrid-23-downloads.php?edt=pro and version v2.3.5 from http://www.storegrid.com/online-backup/storegrid-235-downloads.php?edt=pro

Migrating from version lower than 2.3.5

If you are currently running a version previous to 2.3.5, then you need to first upgrade to v2.3.5 before installing v2.4.

It is very important that after every version upgrade, you need to start the StoreGrid application and login into the web console and confirm the upgrade has happened successfully before upgrading it to the next version. !!!!

As an example, if you are currently running StoreGrid v2.2, then you need to follow the steps given below to upgrade to v2.4

  1. Install StoreGrid v2.2.1 build on top of the existing v2.2 installation.

  2. Choose 'Start StoreGrid' option after completing the installation and wait for some time to let the StoreGrid application to complete the migration. If you log into the web console while the migration is in progress, you will be redirected to page that indicates the migration is in progress.

  3. Once the migration process is completed, login to the web console and verify all the configurations and backups are intact - VERY IMPORTANT

  4. Install StoreGrid v2.3 build on top of the existing v2.2.1 installation.

  5. Choose 'Start StoreGrid' option after completing the installation and wait for some time to let the StoreGrid application to complete the migration.

  6. Once the migration process completed, login to the web console and verify whether all the configurations are intact - VERY IMPORTANT

  7. Install StoreGrid v2.3.5 build on top of the existing v2.3 installation.

  8. Choose start StoreGrid option after completing the installation and wait for some time to let the StoreGrid application to complete the migration.

  9. Once the migration process is completed, login to the web console and verify whether all the configurations are intact - VERY IMPORTANT

  10. Install StoreGrid v2.4 build on top of the existing v2.3.5 installation.

  11. Choose start StoreGrid option after completing the installation and wait for some time to let the StoreGrid application to complete the migration.

  12. Once the migration process is completed, login to the web console and verify whether all the configurations are intact - VERY IMPORTANT

Migrating from version 2.3 to 2.3.5

You can install StoreGrid v2.3.5 on top of the existing version 2.3 and StoreGrid will automatically migrate to 2.3.5 release.

Versions older than v2.3 cannot be migrated directly to v2.3.5. You will have to first migrate them to v2.3 and install v2.3.5 on top of it. For versions older than v2.2.1, first migrate them to v2.2.1 and then to v2.3. You can download the v2.2.1 from http://www.storegrid.com/online-backup/storegrid-pro-221-downloads.php and version v2.3 from http://www.storegrid.com/online-backup/storegrid-23-downloads.php?edt=pro

If you login into the web console when the migration process is in progress, you will be directed to a page which indicates that migration is in process. The migration might take up to 20 minutes depending upon the amount of data to be migrated. Wait for some time and then try re-logging in. Please don't shutdown and restart StoreGrid as this will only further delay the migration.

Migrating from version 2.2.1 to 2.3

You can upgrade StoreGrid v2.2.1 to v2.3 by just installing v2.3 on top of the current installation. Versions older than v2.2.1 cannot be migrated directly to v2.3. You will have to first migrate them to v2.2.1 and then migrate v2.2.1 to v2.3. You can download the v2.2.1 from http://www.storegrid.com/online-backup/storegrid-pro-221-downloads.php

Migration might take some time depending upon the amount of data to be migrated. Please don't restart StoreGrid as this will only further delay the migration. If you log into the StoreGrid web console during migration, you will be directed to a page indicating that the migration process is in progress. Wait for sometime and then try logging back in. In the backup server. migration could take about 5 minutes for every 100,000 files backed up. Migration in the client should not take much time.

Migrating from version 2.0/2.0.1/2.1/2.1.1 to 2.2.1

Migrating to StoreGrid 2.2.1 is completely automatic.

All you have to do is to install StoreGrid 2.2.1 on top of your existing (2.0/2.0.1/2.1/2.1.1) StoreGrid installation.

Please migrate your Backup Server & Replication Server first. Thereafter, you can migrate your clients in a phased manner. Clients running version 2.0/2.0.1/2.1/2.1.1 will continue to backup to your backup server running v2.2.1 ! Section 1 below covers Server Side Migration, and Section 2 covers Client Side migration.

1. StoreGrid Server-side Migration

While updating a StoreGrid server installation to version 2.2.1, most of the migration procedures are internal and automatic. The migration on the StoreGrid Backup Server and the StoreGrid Replication Server may take some time based on the number of files backed up on the StoreGrid Server. For example, migrating 100,000 files will take about 10 minutes and 200,000 files will take about 20 minutes.

While updating a StoreGrid server installation to version 2.2.1, most of the migration procedures are internal and automatic. But the following changes to StoreGrid 2.2.1 needs to be understood by the service provider before deploying and using StoreGrid 2.2.1.

1.1. StoreGrid 2.2.1 Groups

From StoreGrid 2.2.1, all clients are organized under Groups. In StoreGrid 2.1.1 Professional Edition, the clients were listed directly in the 'Server Admin -> Client Management'. Now in StoreGrid 2.2.1, the clients will be by default organized under the 'Default Group'. Users can create multiple Groups (up to one level) and organize their clients based on their Groups, such as Departments, Office Branches, etc.,

NOTE: The Email Filtering configurations are not migrated from 2.1.1 to 2.2.1. Hence, please reconfigure the Email filtering options after upgrading to StoreGrid 2.2.1 Release.

Migrating from version 2.0/2.0.1/2.1 to 2.1.1

There is no special migration procedure if you are updating from 2.0/2.0.1/2.1 to 2.1.1. You can just install StoreGrid 2.1.1 on top of the existing 2.0/2.0.1/2.1 version and StoreGrid will automatically migrate to the 2.1.1 release. StoreGrid will not be functional while the migration is in progress. But the migration itself will take only a few seconds. While you update from Version 2.0.1/2.1 to 2.1.1 please note that:

  1. StoreGrid will not be able to schedule any backups while the migration is in progress.

  2. The StoreGrid Web Console, when accessed, will come up with a message that "Migration is in progress". StoreGrid Web Console features cannot be used while the migration is in progress.


Migrating from version 1.6 to 2.0

Vembu StoreGrid 2.0 is a major upgrade release over the StoreGrid 1.6 release. StoreGrid's architecture and infrastructure have been revamped and improved significantly keeping in mind scalability, performance and flexibility in terms of evolution of future versions of StoreGrid. Towards that end, StoreGrid 2.0 completely leverages an embedded RDBMS both in the client and the server side. Except for the backup files, which uses the native file system itself, every other information StoreGrid generates or uses like configurations, file meta-data, file signatures, events, version information, backup reports, restore reports etc. are all driven from the RDBMS. Leveraging an RDBMS gives StoreGrid the capability to evolve rapidly in terms of new features and user-interface improvements etc. without compromising on scalability and performance. With this major re-design of StoreGrid with the 2.0 version, we expect to deliver customer focused features at a more rapid pace than before.

Whether StoreGrid installation is a Client, Server, Or Client-Server Installation, the first time it runs, StoreGrid 2.0 automatically migrates all the file meta-data and configurations maintained in flat files or the 1.6 database to the newly created 2.0 database. The StoreGrid Client side migration is quite fast. Even for 1000s of files, the client side migration will take only a few minutes. On the StoreGrid server side, where the backup data is present, depending upon the number of files you have backed up earlier, the migration may take some time. The time taken for the migration on the server side depends upon the total number of files that were earlier backed up with StoreGrid 1.6. Migrating 10,000 files will take about 4 minutes and 100,000 files will take about 40 minutes.

StoreGrid will not be functional while the migration is in progress. While you upgrade from Version 1.6 to 2.0, please note the following points:

  1. StoreGrid 2.0 will automatically migrate your 1.6 data to 2.0 formats when it runs first time after the upgrade.

  2. StoreGrid 2.0 is not interoperable with StoreGrid 1.6. Hence make sure you upgrade and migrate both your client and server installations before you resume your backups. The recommended procedure is to update and migrate your StoreGrid servers first. StoreGrid 2.0 will put all the backup schedules in the client in suspended mode after the migration process.You need to resume them manually after making sure the backup servers also have been upgraded and migrated to 2.0.

  3. StoreGrid will not be able to schedule any backups while the migration is in progress.

  4. The StoreGrid Web Console, when accessed, will come up with a message that "Migration is in progress". StoreGrid Web Console features cannot be used while the migration is in progress.

  5. StoreGrid Migration process may use high CPU cycles and may slow down other processes on the machine/PC. Hence it is advisable to upgrade to StoreGrid 2.0 when you are not using the machine/PC for CPU intensive tasks.

Advanced Users

The following points should help you understand the internal migration process when you run StoreGrid 2.0 for the first time after upgrading from 1.6.

  1. StoreGrid 1.6 to 2.0 Client Side Migration

  2. The operations performed in client side migration are as follows:

    1. User Account Migration: Read the user lists from userfiles.lst and write to Client DB.

    2. Backup Configuration Migration: List the *.sbf, *.imm & *.scc files from <STOREGRID_HOME>/conf & add backup configuration to DB. After migration, the backups will be in suspended status. User has to resume the backup schedule manually only after making sure the backup servers the client was backing up to are also upgraded to the StoreGrid 2.0 version and the migration has taken place in those servers.

    3. Discovered Peer List Migration: Read the discovery.log (if not present, discovery.tmp) file from <STOREGRID_HOME> and add them to Discovery DB.

    4. Discovery Configuration Migration: Read the discovery.conf file from <STOREGRID_HOME>/conf and write to Discovery DB.

    5. Delete Configuration & Reports Migration: List the *.sdf files from <STOREGRID_HOME>/conf & write them to Client DB.

    6. File Meta Data Migration: Attach the 1.6 DB to 2.0 DB and copy the file meta-data information and signature data.

    7. Backup Reports Migration: Attach the 1.6 DB to 2.0 DB and copy the backup reports information.

    8. Restore Reports Migration: List the *.rpt files from <STOREGRID_HOME>/report/restore and add them to DB.

  3. StoreGrid 1.6 to 2.0 Server Side Migration

  4. The operations performed in server side migration are as follows:

    1. For each backup client backing up to the server, find the backup location from <SG_HOME>/conf/diskspaceconfiguration/and migrate the backed up files to a new 2.0 directory structure which is based on directory Ids. Note that StoreGrid 2.0 will move the backed up files from the original location to the new location.

    2. By default all the client's backup will be done under a directory called "1" under the backup location.

    3. Move Disk Space Configuration information of all clients to Server DB.



Migrating from version 1.2.1 to 2.0

If you are still using the 1.2.1 release and want to migrate from 1.2.1 to 2.0, then the migration is a two step process.

1. Firstly you need to migrate from 1.2.1 to 1.6 by installing StoreGrid 1.6. You can check whether the migration has completed by logging into the UI. The steps for migrating from 1.2.1 to 1.6 is given below.

2. After migrating to 1.6, then you can migrate StoreGrid to 2.0 by installing 2.0 on top of the 1.6 version. The steps for migrating from 1.6 to 2.0 is given above.

Migrating from version 1.2.1 to 1.6

NOTE: StoreGrid 1.6 is a minor bug fix release over 1.5.1. So there is no special migration procedure if you are updating from 1.5.1 to 1.6

Vembu StoreGrid 1.6 has some significant improvements in terms of how a StoreGrid client internally maintains metadata information.

In earlier versions , metadata information like the signature (used for incremental backups) and file statistics (modified time, created time etc.) were stored in flat files. This was relatively inefficient as the metadata occupied more space than necessary. StoreGrid 1.6 uses an embedded relational database (RDBMS) to store the metadata efficiently. Moving to an RDBMS also enhances StoreGrid's ability to provide more detailed reports.

The first time it runs, StoreGrid 1.6 automatically migrates the metadata maintained in flat files to the embedded RDBMS. Depending upon the number of files you had backed up earlier, the migration may take some time. The time taken for the migration depends upon the total number of files that were earlier backed up with StoreGrid 1.2.1. Migrating 10,000 files will take about 2 minutes and 100,000 files will take about 30 minutes.

StoreGrid will not be functional while the migration is in progress. While you update from Version 1.2.1 to 1.6 , please note that:

  1. StoreGrid will not be able to schedule any backups while the migration is in progress.

  2. The StoreGrid Web Console, when accessed, will come up with a message that "Migration is in progress". StoreGrid Web Console features cannot be used while the migration is in progress.

  3. StoreGrid Migration process may use high CPU cycles and may slow down other processes on the machine/PC. Hence it is advisable to update to StoreGrid 1.6 when you are not using the machine/PC for CPU intensive tasks.

  4. The last backup information in the backup reports will be reset after the migration, i.e. the last backup information like Total Files, Total Files Protected etc. will be set to zero. These fields will be updated once StoreGrid 1.6 runs and completes a backup.

For Advanced Users

The following points should help you understand the internal migration process when you run StoreGrid 1.6 for the first time after updating from 1.2.1

  1. StoreGrid 1.6 creates a relational database file "storegrid.db" in <INSTALLATION_HOME>/Vembu/StoreGrid/data directory.

  2. The 1.2.1 version metadata information available in the <INSTALLATION_HOME>/Vembu/StoreGrid/data/<backup-schedule> directory will be copied to the relational database. At the end of migration of every backup schedule, StoreGrid will rename the existing backup schedule metadata directories to <backup-schedule>_SG_1_2_1. StoreGrid 1.6 will not delete the 1.2.1 version's meta data information. All the directories renamed with _SG_1_2_1 can be deleted by the user manually after making sure StoreGrid 1.6 works correctly after the migration process.

  3. StoreGrid 1.6 will also migrate the reports available under <INSTALLATION_HOME>/Vembu/StoreGrid/report/backup to the relational database.

  4. In case StoreGrid is terminated during migration, StoreGrid will migrate the remaining metadata the next time StoreGrid is restarted.


Print  
© 2004-2010, Vembu Technologies Pvt. Ltd. Technical support-