Moving a Database to Another Location
Pre-requisites:
To move a CentraSite database through the CentraSite Command Line Interface, you must have the CentraSite Administrator role.
Under certain circumstances you might wish to move a CentraSite database from an existing CentraSite installation into another CentraSite installation, either on the same machine or on a different machine. Examples of such situations are:
![*](chapterTOC_bullet.png)
When resources for processing become insufficient.
![*](chapterTOC_bullet.png)
In a disaster recovery scenario.
![*](chapterTOC_bullet.png)
As part of a side-by-side product installation, whereby two versions of
CentraSite can exist on the same machine.
Moving a CentraSite database to another machine is not supported in the following scenarios:
![*](chapterTOC_bullet.png)
if the architectures of the source and the target machine is with different byte orders (big-endian versus little-endian)
![*](chapterTOC_bullet.png)
if the source machine is a UNIX system and the target machine is a Windows system.
If you are not sure whether moving a database is supported in your environment, contact a technical representative of Software AG.
The CentraSite registry or repository contains environment-dependent data. This data has to be adjusted to the new environment when the data is moved to another machine.
CentraSite provides a command tool named MoveCentraSiteRR for this purpose. The tool allows you to create a new database from an existing backup and to modify the data to the needs of the new environment.
The steps performed by the command tool are:
![*](chapterTOC_bullet.png)
Calculate database space sizes
![*](chapterTOC_bullet.png)
Delete the existing
CentraSite database
![*](chapterTOC_bullet.png)
Create a new
CentraSite database
![*](chapterTOC_bullet.png)
Adjust the environment specific data
![*](chapterTOC_bullet.png)
Create a new backup containing the modifications
Important:
The contents of the backup file overwrites the database of the target CentraSite installation.
![*](icon_task_xpe.png)
To move the database to another location
Run the command MoveCentraSiteRR. The syntax is of the format: C:\SoftwareAG\CentraSite\bin\cfg>MoveCentraSiteRR.cmd backup-filename [data-space-location]
The input parameters are:
Parameter | Description |
backup-filename | (Optional). Name of the existing backup file. |
data-space-location | The absolute path to the CentraSite database. Default value is C:\SoftwareAG\CentraSite\data. |
Example (all in one line):
C:\SoftwareAG\CentraSite\bin\cfg>MoveCentraSiteRR.cmd C:\SoftwareAG\CentraSite\data\AAB00001001461149722.2B0 C:\SOAPlatform\CentraSite\data