GigaVaultStorage FreeBSD (for FreeBSD 5.4 and above) Installation Guide

Download the Giga Vault Storage FreeBSD version (for FreeBSD 5.4 and above): GigaVaultStorage_2_4_FreeBSD.zip

GigaVaultStorage FreeBSD installation compiles and installs its own version of Apache, GD and PHP. So before installing GigaVaultStorage in FreeBSD machines, please check that the following packages were installed.

1. make, available from http://ftp.gnu.org/pub/gnu/make/

2. gcc, available from http://gcc.gnu.org/

3. g++, available from http://gcc.gnu.org/

4. libstdc++4, available from http://gcc.gnu.org/libstdc++/

The following 3rd-party libraries will be used by gd if found by configure. While gd will compile and install even without these, we suggest that at least zlib and libpng are installed, and recommend that freetype and jpeg are installed as well:

1. Data compression library: zlib, available from http://www.gzip.org/zlib/

2. Portable Network Graphics library; requires libpng, available from http://www.libpng.org/pub/png/

3. Free, high-quality, and portable font engine: FreeType 2.x, available from http://www.freetype.org

4. Portable JPEG compression/decompression library: JPEG library, available from http://www.ijg.org/

To install PHP following 3rd-party libraries are required :

1. Flex, available from http://flex.sourceforge.net/ -- Flex is a tool for generating programs that perform pattern-matching on text.

2. Bison, available from http://www.gnu.org/software/bison/ -- Bison is a general-purpose parser generator that converts a grammar description for an LALR context-free grammar into a C program to parse that grammar.

(OR)

3. libxml2, available from http://www.xmlsoft.org/ -- XML DOM library used by php's xml parser.

4. bzip2 , available from http://www.bzip.org/downloads.html -- Free, patent free , high-quality data compressor.

5. cURL , available from http://curl.haxx.se/download/ -- Free, patent free , high-quality data compressor.

6. libmcrypt , available from http://sourceforge.net/projects/mcrypt -- A simple crypting program.

7. mhash , available from http://sourceforge.net/project/showfiles.php?group_id=4286&package_id=4300 -- To support wide variety of hash algorithms.

To install Apache with HTTPS support, Open SSL libraries are required :

1. To enable https support in GigaVaultStorage, please ensure that openssl package is installed on your system before you enable https support. You can download the latest openssl version from http://www.openssl.org/source/.

Once you have ensured that the above packages are all available in your FreeBSD machine, follow the steps given below to install GigaVaultStorage:

1. Unzip the downloaded ZIP file.

2. Execute the bin file

GigaVaultStorage_2_4_SP_FreeBSD.bin

3. The first step in the installation is to choose the type of installation. You will be given two options:

1. You can install GigaVaultStorage in a newly created GigaVaultStorage user account, where the GigaVaultStorage user account will be automatically created with root privileges

2. You can install GigaVaultStorage in the current user account without root privileges.

Choose option 1, if you want GigaVaultStorage to have root privileges so that it can be configured to backup all the users data, MySQL, System Files etc. Note that GigaVaultStorage will be installed as a daemon process and will automatically start when the system boots up. You can START and STOP GigaVaultStorage by running the command "/etc/rc.d/gigavaultstorage start/stop".

Choose option 2, if you want GigaVaultStorage to only backup files in the current user directories. Note that GigaVaultStorage will be installed in the current user directory and has to be manually started every time the machine is rebooted. You can START and STOP GigaVaultStorage by running the script startGigaVaultStorage.sh and stopGigaVaultStorage.sh

4. If you chose option 1 in the above step, then you will either be asked to give the root password, or the installation will quit and ask you to login as root and start the installation process again. Once you give the root password, you will be asked to provide a password for the GigaVaultStorage user account which will be created. Note that GigaVaultStorage will be installed as a daemon process and will automatically start when the system boots up. You can START and STOP GigaVaultStorage by running the command "/etc/rc.d/gigavaultstorage start/stop".

   If you chose option 2, then you will be taken to the next step directly. Note that GigaVaultStorage will be installed in the current user directory and has to be manually started every time the machine is rebooted. You can START and STOP GigaVaultStorage by running the script startGigaVaultStorage.sh and stopGigaVaultStorage.sh

5. Read through the License Agreement carefully. If you agree, enter Yes to continue with the installation. If you do not agree, enter No to abort the installation.

6. By default GigaVaultStorage will be installed in the "Current Directory". Setup will install GigaVaultStorage under "GigaVaultStorageInc/GigaVaultStorage" in the "Current Directory" directory. To install in a different directory, enter the absolute path for GigaVaultStorage installation. Note that setup will create the "GigaVaultStorageInc/GigaVaultStorage" directory under the directory you entered.

7. Upgrading GigaVaultStorage from 2.3.5 to 2.4

GigaVaultStorageInc/GigaVaultStorage directory found in the installation path provides you with Yes/No options:

Choosing 'Yes' will upgrade GigaVaultStorage to the latest version.

Choosing 'No' will skip the upgrade process.

UPDATE GigaVaultStorage by retaining the previous backup data. Note that all backup data in GigaVaultStorage2.3.5 will be automatically migrated to 2.4 when GigaVaultStorage 2.4 starts for the first time.[ Recommended ]

GigaVaultStorage ID is the unique name with which your GigaVaultStorage installation is identified. By default, it takes your machine name as the GigaVaultStorage ID. But we recommend giving your email id as the GigaVaultStorage ID so that it is globally unique. Here you will be provided with these options:

• "Do you want to identify your machine name by other than hostname"

• If you enter "y/Y" then following text will displayed in terminal to enter GigaVaultStorage ID.

• "Enter GigaVaultStorage ID"

• Enter the GigaVaultStorage ID for your installation. We recommend using your email id for this.

Note: The GigaVaultStorage ID value is case insensitive. Hence, the 'GigaVaultStorage ID' you have entered will be automatically converted to lower case.

Customer Name: Enter valid GigaVaultStorage Customer Name. The GigaVaultStorage Customer name is the 'name' under which your client is categorized (on the backup server). By default, this is set to "Trial Customer". Your service provider can change this at his end, as required. If your service provider has given you a customer name, please enter it exactly as provided. Otherwise, please leave this as the default "Trial Customer".

GigaVaultStorage supports 'https protocol' to access the GigaVaultStorage webconsole in a secured manner. HTTPS is nothing but a combination of normal HTTP interaction over an encrypted Secure Sockets Layer (SSL) to ensure reasonable protection from eavesdroppers and man-in-the-middle attacks.

GigaVaultStorage uses the TCP port 6061 for https based WebConsole access. Hence if you choose https support, then you can access the GigaVaultStorage WebConsole through "https://<machine_name or IP_address>:6061". And also, if you try to access the GigaVaultStorage webconsole through http://<machine name>:<webconsole port>, then you will be automaticaly redirected to https://<machine name>:<HTTPS port> url.

Note : To enable https support in GigaVaultStorage, please ensure that openssl package is installed on your system before you enable https support. You can download the latest openssl version from http://www.openssl.org/source/.

Since GigaVaultStorage's user interface is browser based you need to configure a username and password to login to GigaVaultStorage Web Console. Note that you can add additional users, delete users, change password etc. from the Web Console UI after the installation.

By default GigaVaultStorage uses the 'Backup Server Port' 32004, which is used for all the client-server communications like Backup/Restore, and the 'UI Communication Port' 32005, which is used for communication between the GigaVaultStorage WebConsole and the GigaVaultStorage Application. If you want to have GigaVaultStorage using other than the default ports, here you will be provided with these options.

• "Do you want to change these ports from default value"

• If you enter "y/Y" then following text will displayed in terminal to enter GigaVaultStorage's Backup Server Port and the UI Communication Port.

• "Please enter a numerical whole number value for Backup Server Port"

• Enter the Backup Server Port value here.

• "Please enter a numerical whole number value for UI Communication Port"

• Enter the UI Communication Port value here.

GigaVaultStorage's user interface is browser based. By default GigaVaultStorage Web server is configured to run on port 6060 and 6061 (for HTTPS). From your browser you will have to type http://<Your Machine Name>:6060 to start the GigaVaultStorage Web Console.

Note:

After successful installation, you can open the GigaVaultStorage Web Console from your browser by typing http://<Your Machine Name>:6060. You will have to login to the Web Console using the username and password you provided in the "GigaVaultStorage Web Console Authentication" step during the installation.