This is an old revision of the document!
Table of Contents
BlueOnyx General Migration Utility (GMU)
Brief Summary
The BlueOnyx General Migration Utility (GMU) has been created to allow easy migrations from non-BlueOnyx servers to BlueOnyx 5209R. For this purpose it uses a custom Perl script to gather as much needed info as it can from a non-BlueOnyx server and then builds an XML file and tarballs that contain all info that is needed to perform an import on BlueOnyx 5209R.
On BlueOnyx 5209R we do have a script that can perform the import. This guide explains the usage.
Please note: Currently the only supported platform for exports to BlueOnyx are Verio FreeBSD and Verio CentOS-4 servers that run the Verio GUI. Support for further platforms will be added later (think Plesk & cPanel).
How to export:
What you need:
- 'root' access to a supported export platform (Verio FreeBSD 6.4 or Verio CentOS4.9)
- A couple of GB of free space on that server.
Setup of the exporter:
Login as 'root' on the server on which you want to generate the export. Or login as user with “wheel” access and perform “su -” to gain 'root' access.
Make sure you have enough disk space for the export and note which partition has the most space. This usually ought to be /home/. You can check the available disk space with the command “df -h”.
Download the migration utility:
cd /home wget http://devel.blueonyx.it/pub/BlueOnyx/TAR/Verio-to-BlueOnyx-5209R-exporter.tar.gz tar zxvf Verio-to-BlueOnyx-5209R-exporter.tar.gz cd Verio-to-BlueOnyx-5209R-exporter/migrator
Inside that directory is the script 'verio-export-to-blueonyx.pl', which is the only script you will need to run during the export.
To run the script you prefix it with './' - Example:
export_box# ./verio-to-blueonyx-exporter.pl -h
#####################################################################
# verio-to-blueonyx-exporter.pl: BlueOnyx Generic Migration Utility #
#####################################################################
#
# Verio (FreeBSD and CentOS) to BlueOnyx 5209R exporter.
# This utility parses the Apache and Sendmail config (and
# cpx.conf) to generate an XML file and Tarballs that allow
# you to import all Vsites and Users on BlueOnyx 5209R.
usage: verio-export-to-blueonyx.pl [OPTION]
-c export configuration only
-d export dir (assumes /home/Verio-to-BlueOnyx-5209R-exporter/migrator/data/) unless specified
-s SCP target details (like 'root@host:/dir/')
-h help, this help text
export_box#
The command line parameter '-h' displays the above help text.
Explanation of the command line options:
| Switch | Value | Meaning |
|---|---|---|
| -c | <none> | If you do not want to export any TarBalls with Vsite and User data, then you can use the '-c' switch. This will only export the configuration and information about Vsites and Users. |
| -d | <local directory> | This allows you to specify where the exported XML (and TarBalls) will be stored on the export server. If not specified, then the 'data' directory inside the directory where the script resides will be used. |
| -s | <root@target.com:/dir/> | If the server on which you generate the export does not have enough diskspace to store all TarBalls, then you can use the '-s' switch and can specify the full username, hostname and directory on a remote server. During export every TarBall is then generated locally and right after creation this TarBall is sent via 'scp' command over SSH to the remote server where you want to import. After the transmission the locally stored TarBall is deleted to conserve space. Please note: For this to work you need to exchange SSH keys. The export server must be allowed to login (w/o password) via SSH key on the target server. |
| -h | <none> | Display the help text and exit. |
xxxx
