Knowledgebase: Solar Vault
Quick Install/Upgrade Guide
Posted by Support, Last modified by Support on 31 December 2013 05:55 PM
Windows XP / Vista / 7 / 2003 / 2008
    1. Download the SolarVault online data backup installer if you haven't already. Follow the instructions on the installation wizard to complete installation.
    2. When finished, a new icon (SolarVault SB (server)/ SolarVault WB (workstation)) will be installed to the system tray (near the clock) automatically and SolarVault SB / SolarVault WB will be launched automatically.
    3. Make sure https is selected and enter the backup server host name in the [Address] field and press the [Next] button.
    4. If you have a backup account already, logon to the server with your existing username and password (credentials were sent via e-mail)

      NOTE: If you are using a single backup account to backup multiple PC's or Servers and you already have existing backup sets created.... upon Login, the software will recognize other backup sets exist and prompt you for the encryption key. You may just click "Save" on each prompt as the encryption keys do not apply to the machine you are currently installing on.
  1. Create a backup set: If this is your first time logging in, you will be guided to create a backup set: VERY IMPORTANT: During the client software installation, you will come to the "New Backup Set Wizard" screen.  This is where you will create your personal encryption key (password) that is used when restoring your files when/if the time comes.  DO NOT LOSE THIS KEY!  Without it, you will not be able to restore your data! This is by design, so you and ONLY you can see and restore your data files.

      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. Setup the backup schedule by pressing the [Add] button (please note that you can add multiple backup schedules to a backup set and please select the "Run scheduled backup on this computer" checkbox if you would like to run Continuous Data Protection (CDP))
      4. Setup the encryption setting for your backup set. It is recommended you choose "Custom" here to create your own encryption key. If you leave it on "Default" your encryption key will be the same password you used to log in to the backup client at the beginning. Once the encryption key is set, it CANNOT be change.
      5. Press the [OK] button to complete the configuration of backup set. The scheduled backup will run automatically if you leave your computer on.
  2. To run a backup immediately, click [Backup] button on the left panel, select the backup set and press [OK] button.
  • Setup completed.
Mac OSX Upgrade (from 5.5.x)
    1. Download the SolarVault installation package if you haven't already.
    2. Expand the archive and execute the [SolarVault SB (server) / SolarVault WB (workstation)] package. (Mac OS X 10.7 doesn't come with Java by default but you can install it manually when prompted)
    3. Follow the instructions provided by the installation wizard (agree to uninstall previous version if prompted)
    4. Double click the desktop SolarVault SB / SolarVault WB icon to start.
    5. Make sure https is selected and enter the backup server host name in the [Address] field if it doesn't exist and press the [Next] button:
    6. Logon to the server with your existing username and password.
    7. To run a backup immediately, click [Backup] button on the left panel, select the backup set and press [OK] button.
    8. Upgrade completed.

Mac OSX installation (New Install)
    1. Download the SolarVault installation package if you haven't already.
    2. Expand the archive and run the installation wizard [SolarVault Pro / SolarVault Lite] package. (Mac OS X 10.7 doesn't come with Java by default but you can install it manually when prompted)
    3. Restart your Mac. Double click the desktop SolarVault Pro / SolarVault Lite icon to start.
    4. Make sure https is selected and enter the backup server host name in the [Address] field and press the [Next] button
    5. Select [already a user?] and logon to the server with your existing username and password that was sent to you via email.
    6. If this is your first time logging into the server, you will be guided to create a backup set:

      1. Setup the backup schedule by pressing the [Add] button (please note that you can add multiple backup schedules to a backup set and please select the "Run scheduled backup on this computer" checkbox if you would like to run Continuous Data Protection (CDP))
      2. Setup the encryption setting for your backup set. It is recommended you choose "Custom" here to create your own encryption key. If you leave it on "Default" your encryption key will be the same password you used to log in to the backup client at the beginning. Once the encryption key is set, it CANNOT be change.
      3. Press the [OK] button to complete the configuration of backup set Scheduled backup will run automatically if you leave your computer on
    7. To run a backup immediately, click [Backup] button on the left panel, select the backup set and press [OK] button.
    8. Setup completed.

Linux Upgrade

Typically the SolarVault client will auto-upgrade on Linux machines as long as the "Auto Update Agent" is running. You may check if the Auto-Update service is running by typing the following at the command prompt:

ps -ef | grep obmaua (output should be similar to this if it is running)
root     27847 27794  0 14:46 pts/1    00:00:00 grep obmaua

To stop or start the Auto-Update service in Linux, type the following:
sh /etc/init.d/obmaua start (or stop)

If you would rather not wait on the automatic update, please use the following instructions to manually upgrade.

    1. Download the SolarVault online data backup tarball release if you haven't already, and for the purpose of these instructions, copy it to /opt
    2. Stop current running services

      # sh /etc/init.d/obmscheduler stop
      # sh /etc/init.d/obmaua stop

    3. Rename current installation directory and create new one

      # mv /usr/local/obm /usr/local/obm_bak (assuming the OBM directory is installed in /usr/local)
      # mkdir /usr/local/obm

    4. Move installer to /usr/local/obm, unzip and install

      # mv /opt/SolarVault-nix.tar.gz /usr/local/obm/
      # cd /usr/local/obm
      # gunzip obm-nix.tar.gz
      # tar -xf SolarVault-nix.tar

    5. Install SolarVault SB and its related services by using the following commands:

      # ./bin/install.sh > install.log

      All installation information can be found in the file "install.log"

Notes:
For custom JRE - Install JRE v1.6 or above, and make note of the JRE installation path (e.g. /usr/java).

Create a symbolic link for JRE:
# ln –sf /usr/java /usr/local/obm/jvm

Set the $JAVA_HOME environment variable:
# export JAVA_HOME=/usr/java

Note: Custom Java Runtime (JRE) for SolarVault SB installation is only required when the client machine is not running on x86 or x64.


Linux installation (Fresh install)
    1. Download the SolarVault online data backup tarball release if you haven't already.
    2. Unpack the install file to /usr/local/obm

      # mkdir /usr/local/obm
      # cd /usr/local/obm
      # gunzip SolarVault-nix.tar.gz
      # tar -xf SolarVault-nix.tar

    3. Install SolarVault SB

      # ./bin/install.sh >install.log

      All installation information can be found in the file "install.log"

      The backup scheduler and autoupgrade services are automatically installed. Backup sets can now run at their scheduled times automatically.

    4. Please go to X Window or command line mode to continue installation.
Solaris Installation
    1. Download the SolarVault online data backup tarball release if you haven't already.
    2. Unpack the install file to /usr/local/obm

      # mkdir /usr/local/obm
      # cd /usr/local/obm
      # gunzip SolarVault-nix.tar.gz
      # tar -xf obm-nix.tar
    3. Remove bundled jvm

      # rm -rf /usr/local/obm/jvm
    4. Install J2SE Java Runtime Environment (JRE) 1.4.x or later to /usr/java
    5. Create a symbolic link for JRE

      # ln -s /usr/java /usr/local/obm/jvm
    6. Set the JAVA_HOME environment variable

      # JAVA_HOME=/usr/java; export JAVA_HOME
    7. Install SolarVault SB

      # ./bin/install.sh >install.log

      All installation information can be found in the file "install.log"

      The backup scheduler and autoupgrade services are automatically installed. Backup sets can now run at their scheduled times automatically.

 

Please go to X Window or command line mode to continue installation.


Backup client install for IBM, AIX, SCO, and HP Unix

FreeBSD Installation

  1. Download the SolarVault online data backup tarball release if you haven't already.
  2. Unpack the install file to /usr/local/obm

    # mkdir /usr/local/obm
    # cd /usr/local/obm
    # gunzip SolarVault-nix.tar.gz
    # tar -xf obm-nix.tar
  3. Remove bundled jvm

    # rm -rf /usr/local/obm/jvm
  4. Download J2SE Java Runtime Environment (JRE) 1.4.x or later

  5. Install J2SE Java Runtime Environment (JRE) 1.4.x or later to /usr/local/diablo-jre1.5.0
  6. Use following command to install package

    # pkg_add javavmwrapper-2.3.tbz
    # pkg_add diablo-jre-freebsd5.i386.1.5.0.07.01.tbz
  7. Create a symbolic link for JRE

    # ln -s /usr/local/diablo-jre1.5.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 types it should work.
    # setenv JAVA_HOME /usr/local/obm/jvm
  8. Verify the installed JRE

    $JAVA_HOME/bin/java –version

    See if the output does not contain warning

    With warning

    Java HotSpot(TM) Client VM warning: Can't detect initial thread stack location java version "1.4.2_12"
    Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_12-b03)
    Java HotSpot(TM) Client VM (build 1.4.2_12-b03, mixed mode)

    Without warning

    java version "1.5.0"
    Java(TM) 2 Runtime Environment, Standard Edition (build diablo-1.5.0-b01)
    Java HotSpot(TM) Client VM (build diablo-1.5.0_07-b01, mixed mode)
  9. Install SolarVault Pro

    # ./bin/install.sh >install.log

    All installation information can be found in the file "install.log"
  10. Install the backup scheduler and autoupgrade services

    Add two entries to system file /etc/rc.conf for auto starting backup scheduler and autoupgrade agent.

    # obmaua_enable="YES"
    # obmscheduler_enable="YES"

    Restart computer or run the following scripts

    # /usr/local/etc/rc.d/obmscheduler start &
    # /usr/local/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 installation.

X-Windows

  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 SolarVault Online Backup Manager

    # sh /usr/local/obm/bin/RunOBC.sh &
  3. (Optional) Enter the backup server host name in the [Address] field and press the [Next] button.
  4. If you don't have a backup account, register a trial user by the following steps:
    1. Enter the [Login Name], [Password] and [Confirm Password] of your choice
    2. Enter your [Email] in the text field 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 a different login name)
  5. If you have a backup account already, select [already a user?] and logon to the server with your existing username and password.
  6. If this is your first time logging into 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. Setup the backup schedule by pressing the [Add] button (please note that you can add multiple backup schedules to a backup set and please select the "Run scheduled backup on this computer" checkbox if you would like to run Continuous Data Protection (CDP))
    4. Setup the encryption setting for your backup set (if you don't know much about encryption, just accept the default values here)
    5. Press the [OK] button to complete the configuration of backup set
  7. To run a backup immediately, click [Backup] button on the left panel, select the backup set and press [OK] button.
  8. Setup completed.

Command Line Mode

    1. Use the web management console 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 Enter your [Email] in the text field provided
      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 to be remove and click the [Remove] link

NOTE: When creating a backup set for MySQL, the MySQL root account (or equivilent) cannot contain special characters - and must be upper/lower case letters and numbers only. Here is an example of how a MySQL backup set should appear in the web console.

  1. Using Backup Configurator

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

    Login Name: userXXX
    Password: *******************
    Backup Server URL: sXXX.solarvault.net
    Which Protocol ? (1) Http (2) Https : 2
    Use proxy ? (Y)es or (N)o : If you have a proxy choose "Y", otherwise "N" and skip to step 4
    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) : *******************
  3. 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.

    Important: You cannot change these parameters once they are set

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

    Encrypting Algorithm ?
    (1) Twofish (2) AES (3) Triple DES (4) No encryption : (Most widely used is AES)
    Encrypting Key: ******************* (Write down this key and store it safely! Without it you cannot restore!)
    Re-Enter Encrypting Key: *******************
    Encrypting Mode ? (1) ECB (2) CBC : 2
    Run scheduled backup on this computer ? (Y)es or (N)o : Y
  4. 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:
  5. You can then run a backup by executing the command below (where [BACKUP_SET] is the name of backup set to be run).

    # sh /usr/local/obm/bin/RunBackupSet.sh [BACKUP_SET]
  6. To start the "Online Backup Scheduler" service: sh "/etc/init.d/obmscheduler" start
  7. To start the autoupdate service: sh "/etc/init.d/obmaua" start
  8. Verify both services are set to run automatically by typing: chkconfig --list|grep service_name

    You should see: service_name 0:off 1:off 2:on 3:on 4:on 5:on 6:off

  • Setup completed.
* The backup scheduler and autoupgrade services are verified to install successfully on Solaris, FreeBSD and all major Linux distributions. If these services for other platforms cannot be installed, please refer to the specific OS manual for further information.