Blue Cactus Backups  
Installation Guide

Click on your operating system tab below for the correct installation instructions.

View demo video on Blue Cactus Pro Windows installation here.
 

Installation Guide - Blue Cactus / Blue Cactus Pro - Windows

System Requirement

Please click here for system requirements of Blue Cactus Pro and Blue Cactus v6.

Get Started

  1. Download the setup file and run it.
  2. Follow the instructions on the installation wizard to complete the installation.
  3. When finished, a new icon (Blue Cactus Pro / Blue Cactus) will be installed to the system tray (near the clock) automatically and Blue Cactus Pro / Blue Cactus will be launched automatically.
  4. (Optional) If you are using a proxy server to access the internet, please fill in the [Proxy setting] section and press the [Next] button.
  5. (Optional) If you do not have a backup account, you can register a trial user account by the following steps:
    1. Enter the [Login Name], [Password] and [Confirm Password] of your choice.
    2. Enter your [Email] in the textbox provided.
    3. Press the [Submit] button.
    4. You should be logged to the backup server already. (If the [Login Name] of your choice is already taken by another user, try again with a different login name.)
  6. If you have a backup account already, select [already a user?] and logon to the server with your existing username and password.
  7. If this is your first time logging onto the server, you will be guided to create a backup set:
    1. Enter a backup set name of your choice in the [Name] field and choose the type of backup set in the [Type] field.
    2. Select the files that you want to backup.
    3. For Blue Cactus Pro user, press the [Properties] button to review or make changes to the default backup schedule setting and then press the [Next] button. (Please note that you can add multiple backup schedules to a backup set by pressing the [Add] button and please ensure that the [Run scheduled backup on this computer] checkbox is checked if you would like to enable scheduled backup to run on this computer.)
    4. For Blue Cactus user, enter a backup schedule for unattended backups and then press the [Next] button. (Please ensure that the [Run scheduled backup on this computer] checkbox is checked iv. if you would like to enable scheduled backup to run on this computer.)
    5. Setup the encryption setting for your backup set. (If you do not know much about encryption, just accept the default values here.)
      • We highly recommend you choose the encrypted option for optimal security; if you choose non-encrypted backups, we are not liable for any data that is compromised.
      • When you choose the encrypted option, make sure to write down the encryption key and securely store it in two physical locations in case of disaster (i.e. office, home).  Without the encryption key, you cannot restore your data.  We do not store and cannot retrieve the encryption key.
    6. Press the [OK] button to complete the configuration of backup set
      Scheduled backup will run automatically if you leave your computer on.
  8. To run a backup immediately, click [Backup] button on the left panel, select the backup set and press [OK] button.
  9. Setup is now completed.

Installation Guide - Blue Cactus / Blue Cactus Pro - Mac OS X

System Requirement

Please click here for system requirements of Blue Cactus Pro and Blue Cactus v6.

Get Started

  1. Download the setup file.
  2. Expand the archive and run the Blue Cactus Pro / Blue Cactus installation wizard within the archive.
  3. Follow the instructions on the installation wizard to complete the installation.
  4. Restart your Mac. Double click the desktop Blue Cactus Pro / Blue Cactus icon to start.
  5. (Optional) If you are using a proxy server to access the internet, please fill in the [Proxy setting] section and press the [Next] button.
  6. (Optional) If you do not have a backup account, you can register a trial user account by the following steps:
    1. Enter the [Login Name], [Password] and [Confirm Password] of your choice.
    2. Enter your [Email] in the textbox provided.
    3. Press the [Submit] button.
    4. You should be logged to the backup server already. (If the [Login Name] of your choice is already taken by another user, try again with a different login name.)
  7. If you have a backup account already, select [already a user?] and logon to the server with your existing username and password.
  8. If this is your first time logging onto the server, you will be guided to create a backup set:
    1. Enter a backup set name of your choice in the [Name] field and choose the type of backup set in the [Type] field.
    2. Select the files that you want to backup.
    3. For Blue Cactus Pro user, press the [Properties] button to review or make changes to the default backup schedule setting and then press the [Next] button. (Please note that you can add multiple backup schedules to a backup set by pressing the [Add] button and please ensure that the [Run scheduled backup on this computer] checkbox is checked if you would like to enable scheduled backup to run on this computer.)
    4. For Blue Cactus user, enter a backup schedule for unattended backups and then press the [Next] button. (Please ensure that the [Run scheduled backup on this computer] checkbox is checked iv. if you would like to enable scheduled backup to run on this computer.)
    5. Setup the encryption setting for your backup set. (If you do not know much about encryption, just accept the default values here.)
      • We highly recommend you choose the encrypted option for optimal security; if you choose non-encrypted backups, we are not liable for any data that is compromised.
      • When you choose the encrypted option, make sure to write down the encryption key and securely store it in two physical locations in case of disaster (i.e. office, home).  Without the encryption key, you cannot restore your data.  We do not store and cannot retrieve the encryption key.
    6. Press the [OK] button to complete the configuration of backup set
      Scheduled backup will run automatically if you leave your computer on.
  9. To run a backup immediately, click [Backup] button on the left panel, select the backup set and press [OK] button.
  10. Setup is now completed.

Installation Guide - Blue Cactus / Blue Cactus Pro - Unix / Linux

System Requirement

Please click here for system requirements of Blue Cactus Pro and Blue Cactus v6.

 

Get Started - Linux

  1. Download the setup file.
  2. Login as root user on the machine.
  3. Change the default locale and charset to UTF-8. e.g.

    set LC_ALL=<selected language>.UTF-8
    export LC_ALL
    set LC_LANG=<selected language>.UTF-8
    export LC_LANG

     
  4. Unpack the install package to /usr/local/obm.

    mkdir -p "/usr/local/obm"
    cd "/usr/local/obm"
    gunzip obm-nix.tar.gz
    tar -xf obm-nix.tar

     
  5. (For custom JRE only) Install JRE v1.5 or above. (It is strongly recommend to use JRE v1.6 or above.) Please note down the JRE installation path, e.g. /usr/java
  6. (For custom JRE only) Set JAVA_HOME for Blue Cactus Pro.

    Create a symbolic link for JRE to the $JAVA_HOME:

    ln –sf "/usr/java" "/usr/local/obm/jvm"

    Or

    set the JAVA_HOME environment variable:

    export JAVA_HOME="/usr/java"
     
  7. Install Blue Cactus Pro and its related services by using these commands:

    cd "/usr/local/obm"
    ./bin/install.sh > install.log


    The installation information can be found in the files $OBM_HOME/install.log and $OBM_HOME/bin/config.log.
     
  8. Please go to X Window or command line mode to continue the installation.

Get Started - Solaris

  1. Download the setup file.
  2. Login as root user on the machine.
  3. Change the default locale and charset to UTF-8. e.g.

    set LC_ALL=<selected language>.UTF-8
    export LC_ALL
    set LC_LANG=<selected language>.UTF-8
    export LC_LANG

     
  4. Unpack the install package to /usr/local/obm.

    mkdir -p "/usr/local/obm"
    cd "/usr/local/obm"
    gunzip obm-nix.tar.gz
    tar -xf obm-nix.tar

     
  5. Remove bundled java, i.e. jre32 and jre64:

    rm –rf /usr/local/obm/jre32
    rm –rf /usr/local/obm/jre64

     
  6. Install JRE v1.5 or above to /usr/java. (It is strongly recommend to use JRE v1.6 or above.) Please note down the JRE installation path, e.g. /usr/java
  7. Set JAVA_HOME for Blue Cactus Pro.

    Create a symbolic link for JRE:

    ln -sf "/usr/java" "/usr/local/obm/jvm"

    Or

    set the JAVA_HOME environment variable:

    JAVA_HOME="/usr/java"; export JAVA_HOME
     
  8. Install Blue Cactus Pro and its related services by using these commands:

    cd "/usr/local/obm"
    ./bin/install.sh > install.log


    The installation information can be found in the files $OBM_HOME/install.log and $OBM_HOME/bin/config.log.
     
  9. Please go to X Window or command line mode to continue the installation.

Get Started - BSD

  1. Download the setup file.
  2. Login as root user on the machine.
  3. Change the default locale and charset to UTF-8. e.g.

    set LC_ALL=<selected language>.UTF-8
    export LC_ALL
    set LC_LANG=<selected language>.UTF-8
    export LC_LANG

     
  4. Unpack the install package to /usr/local/obm.

    mkdir -p "/usr/local/obm"
    cd "/usr/local/obm"
    gunzip obm-nix.tar.gz
    tar -xf obm-nix.tar

     
  5. Remove bundled java, i.e. jre32 and jre64:

    rm –rf /usr/local/obm/jre32
    rm –rf /usr/local/obm/jre64

     
  6. Download OpenJDK version 6 for your BSD release.

    For example, we are using FreeBSD 8.1 i386 for installation:

    Download OpenJDK version 6 from the following link:
    ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-8-stable/Latest/openjdk6.tbz

    For more reference, please refer to the following link:
    http://www.freebsdfoundation.org/downloads/java.shtml
     
  7. Install openJDK.

    For the example above, we can use this command to install the OpenJDK version 6 package:

    pkg_add -r openjdk6

    In case openjdk6 cannot be fetched by the above command:

    For FreeBSD 7 (amd64), use this command to install the OpenJDK version 6 package:
    pkg_add -r ftp://ftp.freebsd.org/pub/FreeBSD/ports/amd64/packages-7-stable/Latest/openjdk6.tbz

    For FreeBSD 7 (i386), use this command to install the OpenJDK version 6 package:
    pkg_add -r ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-7-stable/Latest/openjdk6.tbz

    For FreeBSD 8 (amd64), use this command to install the OpenJDK version 6 package:
    pkg_add -r ftp://ftp.freebsd.org/pub/FreeBSD/ports/amd64/packages-8-stable/Latest/openjdk6.tbz

    For FreeBSD 8 (i386), use this command to install the OpenJDK version 6 package:
    pkg_add -r ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-8-stable/Latest/openjdk6.tbz

    For OpenBSD 4.7 (i386), use this command to install the JRE version 1.7 package:
    pkg_add ftp://ftp.openbsd.org/pub/OpenBSD/4.7/packages/i386/jre-1.7.0.00b72p0.tgz

    For OpenBSD 4.8 (i386), use this command to install the JRE version 1.7 package:
    pkg_add ftp://ftp.openbsd.org/pub/OpenBSD/4.8/packages/i386/jre-1.7.0.00b72p1.tgz

    For OpenBSD 4.8 (amd64), use this command to install the JRE version 1.7 package:
    pkg_add ftp://ftp.openbsd.org/pub/OpenBSD/4.8/packages/amd64/jre-1.7.0.00b72p1.tgz

    For OpenBSD 4.9 (i386), use this command to install the JRE version 1.7 package:
    pkg_add ftp://ftp.openbsd.org/pub/OpenBSD/4.9/packages/i386/jre-1.7.0.00beta122p0v0.tgz

    For OpenBSD 4.9 (amd64), use this command to install the JRE version 1.7 package:
    pkg_add ftp://ftp.openbsd.org/pub/OpenBSD/4.9/packages/amd64/jre-1.7.0.00beta122p0v0.tgz

    For OpenBSD 5.0 (i386), use this command to install the JRE version 1.7 package:
    pkg_add ftp://ftp.openbsd.org/pub/OpenBSD/5.0/packages/i386/jre-1.7.0.00beta122p1v0.tgz

    For OpenBSD 5.0 (amd64), use this command to install the JRE version 1.7 package:
    pkg_add ftp://ftp.openbsd.org/pub/OpenBSD/5.0/packages/amd64/jre-1.7.0.00beta122p1v0.tgz

    Please note the default installation path should be /usr/local/openjdk6
     
  8. Set JAVA_HOME for Blue Cactus Pro.

    Create a symbolic link for openjdk6:

    For FreeBSD:
    ln -sf "/usr/local/openjdk6" "/usr/local/obm/jvm"

    If you are using csh as your shell, you need to type "rehash" and hit [Enter] to make the symbolic link take effect.

    For other shell, please use the following:
    setenv JAVA_HOME "/usr/local/openjdk6"

    For OpenBSD:
    ln -sf "/usr/local/jre-1.7.0" "/usr/local/obm/jvm"

    If you are using csh as your shell, you need to type "rehash" and hit [Enter] to make the symbolic link take effect.

    For other shell, please use the following:
    setenv JAVA_HOME "/usr/local/jre-1.7.0"
     
  9. Install Blue Cactus Pro and its related services by using these commands:

    cd "/usr/local/OBM"
    ./bin/install.sh > install.log


    The installation information can be found in the files $OBM_HOME/install.log and $OBM_HOME/bin/config.log.
     
  10. Enable the backup scheduler and autoupgrade services at machine startup by adding these entries in the system file /etc/rc.conf:

    obmaua_enable="YES"
    obmscheduler_enable="YES"


    Run the following scripts:

    /usr/local/etc/rc.d/obmscheduler start &
    /usr/local/etc/rc.d/obmaua start &


    For OpenBSD 4.9 or lower:
    Enable the backup scheduler and autoupgrade services at machine startup by adding these entries in the system file /etc/rc.local:

    if [ -x /etc/obmaua ] ; then
    /etc/obmaua start
    fi

    if [ -x /etc/obmscheduler ] ; then
    /etc/obmscheduler start
    fi


    Run the following scripts:

    /etc/obmscheduler start &
    /etc/obmaua start &


    For OpenBSD 5.0 or higher:
    Enable the backup scheduler and autoupgrade services at machine startup by adding this entry in the system file /etc/rc.conf.local:

    pkg_scripts="obmaua obmscheduler"

    or append to the existing entry, e.g. pkg_scripts="xxx yyy obmaua obmscheduler"

    Run the following scripts:

    /etc/rc.d/obmscheduler start &
    /etc/rc.d/obmaua start &


    The backup scheduler and autoupgrade services are automatically installed. Backup sets can now run at their scheduled times automatically.
     
  11. Please go to X Window or command line mode to continue the installation.

Get Started - X Window Mode

  1. Set the DISPLAY Environment Variables.

    Linux / Unix (sh, bash):

    DISPLAY=
    IP_ADDRESS_OF_XTERMINAL[:0.0]; export DISPLAY

    For example:

    DISPLAY=:0.0; export DISPLAY
    or DISPLAY=127.0.0.1; export DISPLAY
    or DISPLAY=127.0.0.1:0.0; export DISPLAY
    or DISPLAY=192.168.0.2; export DISPLAY
    or DISPLAY=192.168.0.2:0.0; export DISPLAY

    BSD (csh):

    setenv DISPLAY
    IP_ADDRESS_OF_XTERMINAL[:0.0]

    For example:

    setenv DISPLAY :0.0
    or setenv DISPLAY 127.0.0.1
    or setenv DISPLAY 127.0.0.1:0.0
    or setenv DISPLAY 192.168.0.2
    or setenv DISPLAY 192.168.0.2:0.0
     
  2. Run Blue Cactus Pro.

    sh /usr/local/obm/bin/RunOBC.sh &
     
  3. Enter the backup server host name in the [Address] field and press the [Next] button.
  4. (Optional) If you are using a proxy server to access the internet, please fill in the [Proxy setting] section and press the [Next] button.
  5. (Optional) If you do not have a backup account, you can register a trial user account by the following steps:
    1. Enter the [Login Name], [Password] and [Confirm Password] of your choice.
    2. Enter your [Email] in the textbox provided.
    3. Press the [Submit] button.
    4. You should be logged to the backup server already. (If the [Login Name] of your choice is already taken by another user, try again with a different login name.)
  6. If you have a backup account already, select [already a user?] and logon to the server with your existing username and password.
  7. If this is your first time logging onto the server, you will be guided to create a backup set:
    1. Enter a backup set name of your choice in the [Name] field and choose the type of backup set in the [Type] field.
    2. Select the files that you want to backup.
    3. Press the [Properties] button to review or make changes to the default backup schedule setting and then press the [Next] button. (Please note that you can add multiple backup schedules to a backup set by pressing the [Add] button and please ensure that the [Run scheduled backup on this computer] checkbox is checked if you would like to enable scheduled backup to run on this computer.)
    4. Setup the encryption setting for your backup set. (If you do not know much about encryption, just accept the default values here.)
      • We highly recommend you choose the encrypted option for optimal security; if you choose non-encrypted backups, we are not liable for any data that is compromised.
      • When you choose the encrypted option, make sure to write down the encryption key and securely store it in two physical locations in case of disaster (i.e. office, home).  Without the encryption key, you cannot restore your data.  We do not store and cannot retrieve the encryption key.
    5. Press the [OK] button to complete the configuration of backup set
  8. To run a backup immediately, click [Backup] button on the left panel, select the backup set and press [OK] button.
  9. Setup is now completed.

Get Started - Command Line Mode

  1. Use the web interface to add, update and remove backup sets.
    1. If you want to update a backup set, make changes to a backup set and press the [Update] button.
    2. If you want to add a new backup set, click the [Add] link.
    3. If you want to remove a backup set, select the backup set and click the [Remove] link.
  2. Using Backup Configurator.

    sh /usr/local/obm/bin/Configurator.sh
     
  3. Enter your Login Name, Password, Backup Server URL and proxy setting as shown below.

    Login Name: userXXX
    Password: *****************************
    Backup Server URL: xxx.yyy.com
    Which Protocol ? (1) Http (2) Https: 1
    Use proxy? (Y)es or (N)o: Y
    Proxy Type? (1) Http/Https Proxy (2) SOCKS: 1
    Enter proxy server: aaa.bbb.com
    Enter proxy port: xxx
    Enter proxy username (optional): administrator
    Enter proxy password (optional): ********************
     
  4. If you have created a new backup set using the web interface, you set the encrypting key, the encrypting algorithm and the encrypting mode of this backup set by following instructions below.

    Found new backup set 'xxx'
    Please enter the following values for this backup set:

    Encrypting Algorithm?
    (1) Twofish (2) AES (3) Triple DES (4) No Encryption:
    1
    Encrypting Key: *****************
    Re-Enter Encrypting Key: ******************
    Encrypting Mode? (1) ECB (2) CBC: 1
    Run scheduled backup on this computer? (Y)es or (N)o: Y
     
    • We highly recommend you choose the encrypted option for optimal security; if you choose non-encrypted backups, we are not liable for any data that is compromised.
    • When you choose the encrypted option, make sure to write down the encryption key and securely store it in two physical locations in case of disaster (i.e. office, home).  Without the encryption key, you cannot restore your data.  We do not store and cannot retrieve the encryption key.
       
  5. If you want to make any changes to the setting above, you can use the main menu below to do so.

    Main Menu:
    ----------
    (1). List Backup Setting
    (2). Change Password
    (3). Change Network Setting
    (4). Change run scheduled backup setting
    (5). Toggle Masked Field (Password, Encryption Key)
    (6). Generate Configuration Report (text format)
    (7). Quit

    Your Choice:

     
  6. You can then run a backup by executing the command below.

    sh /usr/local/obm/bin/RunBackupSet.sh [BACKUP_SET]

    where [BACKUP_SET] is the name of backup set to be run.
     
  7. Setup is now completed.