SERVO: To Watch Over, Keep, Protect, Observe To Preserve, Serve, GuardOnline BackupInstallation Guide - SERVO OBM•Operating System : Solaris, AIX, HP-UX, FreeBSD, SCO Unix and all major Linux distributions, e.g. Redhat, SUSE, Fedora Core 5, UBUNTU, MANDRIVA•Memory : 128 Mbytes•Disk Space : 100 Mbytes•Network Protocol : TCP/IP (Http/Https)Download SERVO Online Backup Manager- A full-featured backup software for servers (Linux / Unix Server, SQL Server, Exchange Server, Oracle, Lotus or MySQL)1.Download the setup file above2.Unpack the install file to /usr/local/obm mkdir /usr/local/obmcd /usr/local/obmgunzip obm-nix.tar.gztar -xf obm-nix.tar3.Install SERVO OBM./bin/install.sh >install.logAll 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 installation1.Download the setup file above2.Unpack the install file to /usr/local/obm mkdir /usr/local/obmcd /usr/local/obmgunzip obm-nix.tar.gztar -xf obm-nix.tar3.Remove bundled jvm rm -rf /usr/local/obm/jvm4.Install J2SE Java Runtime Environment (JRE) 1.4.x or later to /usr/java5.Create a symbolic link for JREln -s /usr/java /usr/local/obm/jvm6.Set the JAVA_HOME environment variableJAVA_HOME=/usr/java; export JAVA_HOME7.Install SERVO OBM./bin/install.sh >install.logAll 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. * 8.Please go to X Window or command line mode to continue installation1.Download the setup file above2.Unpack the install file to /usr/local/obmmkdir /usr/local/obmcd /usr/local/obmgunzip obm-nix.tar.gztar -xf obm-nix.tar 3.Remove bundled jvm rm -rf /usr/local/obm/jvm4.Download J2SE Java Runtime Environment (JRE) 1.4.x or laterDepending on your platform and BSD release, download the corresponding JRE and dependant packages.For example, we are using FreeBSD 6.1 i386 for installation:Download javavmwrapper-2.3.tbz and diablo-jre-freebsd5.i386.1.5.0.07.01.tbz in the following linkshttp://www.freebsd-fr.org/ports/java.html#javavmwrapper-2.3http://www.freebsdfoundation.org/downloads/java.shtmlhttp://www.freebsd.org/ports/java.html#diablo-jre-1.5.0.07.01_3 (See package dependancy of your machine)5.Install J2SE Java Runtime Environment (JRE) 1.4.x or later to /usr/local/diablo-jre1.5.0Use following command to install packagepkg_add javavmwrapper-2.3.tbzpkg_add diablo-jre-freebsd5.i386.1.5.0.07.01.tbz 6.Create a symbolic link for JREln -s /usr/local/diablo-jre1.5.0 /usr/local/obm/jvmIf 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 worksetenv JAVA_HOME /usr/local/obm/jvm7.Verify the installed JRE $JAVA_HOME/bin/java -versionSee if the output does not contain warningWith warningJava 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 warningjava 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)8.Install SERVO OBM./bin/install.sh >install.logAll installation information can be found in the file "install.log" * 9.Install the backup scheduler and autoupgrade servicesAdd 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 &10.Please go to X Window or command line mode to continue installation1.Set the DISPLAY environment variables Linux / Unix (sh, bash): DISPLAY=IP_ADDRESS_OF_XTERMINAL[:0.0]; export DISPLAYFor exampleDISPLAY=:0.0; export DISPLAYor DISPLAY=127.0.0.1; export DISPLAYor DISPLAY=127.0.0.1:0.0; export DISPLAYor DISPLAY=192.168.0.2; export DISPLAYor DISPLAY=192.168.0.2:0.0; export DISPLAY BSD (csh): setenv DISPLAYIP_ADDRESS_OF_XTERMINAL[:0.0]For examplesetenv DISPLAY :0.0or setenv DISPLAY 127.0.0.1or setenv DISPLAY 127.0.0.1:0.0or setenv DISPLAY 192.168.0.2or setenv DISPLAY 192.168.0.2:0.0 2.Run SERVO Online Backup Manager sh /usr/local/obm/bin/RunOBC.sh &3.(optional) Enter the backup server name in the [Address] field and press the [Next] button4.If you are using a proxy server to access the internet, please fill in the [Proxy setting] section and press the [Next] button5.If you don't have a backup account, register a trial user by the following stepsi.Enter the [Login Name], [Password] and [Confirm Password] of your choiceii.Enter your [Email] in the text field providediii.Press the [Submit] buttoniv.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)6.If you have a backup account already, select [already a user?] and logon to the server with your existing username and password7.If this is your first time logging into the server, you will be guided to create a backup seti.Enter a backup set name of your choice in the [Name] field, choose the type of backup set in the [Type] field and then press [Next] buttonii.Select the files that you want to backup and press the [Next] buttoniii.Setup the backup schedule by pressing the [Add] button (please note that you can add multiple backup schedules to a backup set)iv.Setup the encryption setting for your backup set (if you don't know much about encryption, just accept the default values here)v.Press the [OK] button to complete the configuration of backup set8.To run a backup immediately, click [Backup] button on the left panel, select the backup set and press [OK] button9.Setup completed10.To restore your files, please do the following stepsi.Click [Restore] button on the left panelii.Select the backup set containing the files you want to restore and then press [Next] buttoniii.Select all files that you want to restore using the file explorer on the right paneliv.If you want to restore your files to a folder other than the original folder, please make changes to the [Restore files to] sectionv.Press the [Start Restore] button1.Use the web interface to add, update and remove backup setsi.If you want to update a backup set, make changes to a backup set and press the [Update] buttonii.If you want to add a new backup set, click the [Add] linkiii.If you want to remove a backup set, Select the backup set to be remove and click the [Remove] link2.Using Backup Configuratorsh /usr/local/obm/bin/Configurator.sh3.Enter your Login Name, Password, Backup Server URL and proxy setting as shown below Login Name: userXXXPassword: *******************Backup Server URL: xxx.yyy.comWhich Protocol ? (1) Http (2) Https : 1Use proxy ? (Y)es or (N)o : YProxy Type ? (1) Http/Https Proxy (2) SOCKS : 1Enter proxy server : aaa.bbb.comEnter proxy port : xxxEnter proxy username (optional) : administratorEnter 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 belowImportant: You cannot change these parameters once they are setFound 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 : 1Encrypting Key: *******************Re-Enter Encrypting Key: *******************Encrypting Mode ? (1) ECB (2) CBC : 1Run scheduled backup on this computer ? (Y)es or (N)o : Y 5.If you want to make any changes to the setting above, you can use the main menu below to do soMain 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). QuitYour Choice:6.You can then run a backup by executing the command belowsh /usr/local/obm/bin/RunBackupSet.sh [BACKUP_SET]where [BACKUP_SET] is the name of backup set to be run7.Setup completed1.Run the uninstall scripts sh /usr/local/obm/bin/uninstall.shRemoving Scheduler from service using script name obmschedulerUsing init script path /etc/init.dUsing run level script path /etc/rc.dRemoving symbolic link from run levelsRemoving script file obmscheduler from /etc/init.dShutting down AutoUpdateAgentWaiting 5 seconds for AutoUpdateAgent to clean upRemoving AutoUpdateAgent from service using script nameUsing init script path /etc/init.dUsing run level script path /etc/rc.dRemoving symbolic link from run levelsRemoving script file obmaua from /etc/init.dOnline Backup Manager uninstall service is complete!It is now safe to remove files from /usr/local/obm2.Remove installed files and all application data rm -rf /usr/local/obmrm -rf ~/.obm 3.Uninstall 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
SERVO: To Watch Over, Keep, Protect, Observe
To Preserve, Serve, Guard
Online Backup
Installation Guide - SERVO OBM
•
Operating System : Solaris, AIX, HP-UX, FreeBSD, SCO Unix and all major Linux distributions, e.g. Redhat, SUSE, Fedora Core 5, UBUNTU,
MANDRIVA
•
Memory : 128 Mbytes
•
Disk Space : 100 Mbytes
•
Network Protocol : TCP/IP (Http/Https)
Download SERVO Online Backup Manager - A full-featured backup software for servers (Linux / Unix Server, SQL Server, Exchange Server,
Oracle, Lotus or MySQL)
1.
Download the setup file above
2.
Unpack the install file to /usr/local/obm
mkdir /usr/local/obm
cd /usr/local/obm
gunzip obm-nix.tar.gz
tar -xf obm-nix.tar
3.
Install SERVO OBM
./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
1.
Download the setup file above
2.
Unpack the install file to /usr/local/obm
mkdir /usr/local/obm
cd /usr/local/obm
gunzip obm-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 SERVO OBM
./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. *
8.
Please go to X Window or command line mode to continue installation
1.
Download the setup file above
2.
Unpack the install file to /usr/local/obm
mkdir /usr/local/obm
cd /usr/local/obm
gunzip obm-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
Depending on your platform and BSD release, download the corresponding JRE and dependant packages.
For example, we are using FreeBSD 6.1 i386 for installation:
Download javavmwrapper-2.3.tbz and diablo-jre-freebsd5.i386.1.5.0.07.01.tbz in the following links
http://www.freebsd-fr.org/ports/java.html#javavmwrapper-2.3
http://www.freebsdfoundation.org/downloads/java.shtml
http://www.freebsd.org/ports/java.html#diablo-jre-1.5.0.07.01_3 (See package dependancy of your machine)
5.
Install J2SE Java Runtime Environment (JRE) 1.4.x or later to /usr/local/diablo-jre1.5.0
Use following command to install package
pkg_add javavmwrapper-2.3.tbz
pkg_add diablo-jre-freebsd5.i386.1.5.0.07.01.tbz
6.
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
7.
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)
8.
Install SERVO OBM
./bin/install.sh >install.log
All installation information can be found in the file "install.log" *
9.
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 &
10.
Please go to X Window or command line mode to continue installation
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 SERVO Online Backup Manager
sh /usr/local/obm/bin/RunOBC.sh &
3.
(optional) Enter the backup server name in the [Address] field and press the [Next] button
4.
If you are using a proxy server to access the internet, please fill in the [Proxy setting] section and press the [Next] button
5.
If you don't have a backup account, register a trial user by the following steps
i.
Enter the [Login Name], [Password] and [Confirm Password] of your choice
ii.
Enter your [Email] in the text field provided
iii.
Press the [Submit] button
iv.
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)
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 into the server, you will be guided to create a backup set
i.
Enter a backup set name of your choice in the [Name] field, choose the type of backup set in the [Type] field and then press [Next] button
ii.
Select the files that you want to backup and press the [Next] button
iii.
Setup the backup schedule by pressing the [Add] button (please note that you can add multiple backup schedules to a backup set)
iv.
Setup the encryption setting for your backup set (if you don't know much about encryption, just accept the default values here)
v.
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 completed
10.
To restore your files, please do the following steps
i.
Click [Restore] button on the left panel
ii.
Select the backup set containing the files you want to restore and then press [Next] button
iii.
Select all files that you want to restore using the file explorer on the right panel
iv.
If you want to restore your files to a folder other than the original folder, please make changes to the [Restore files to] section
v.
Press the [Start Restore] button
1.
Use the web interface to add, update and remove backup sets
i.
If you want to update a backup set, make changes to a backup set and press the [Update] button
ii.
If you want to add a new backup set, click the [Add] link
iii.
If you want to remove a backup set, Select the backup set to be remove 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
Important: You cannot change these parameters once they are set
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
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 completed
1.
Run the uninstall scripts
sh /usr/local/obm/bin/uninstall.sh
Removing Scheduler from service using script name obmscheduler
Using init script path /etc/init.d
Using run level script path /etc/rc.d
Removing symbolic link from run levels
Removing script file obmscheduler from /etc/init.d
Shutting down AutoUpdateAgent
Waiting 5 seconds for AutoUpdateAgent to clean up
Removing AutoUpdateAgent from service using script name
Using init script path /etc/init.d
Using run level script path /etc/rc.d
Removing symbolic link from run levels
Removing script file obmaua from /etc/init.d
Online Backup Manager uninstall service is complete!
It is now safe to remove files from /usr/local/obm
2.
Remove installed files and all application data
rm -rf /usr/local/obm
rm -rf ~/.obm
3.
Uninstall 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
