Vembu StoreGrid FreeBSD (for FreeBSD 6.1 and above) Client Installation Guide

Download the zip file:

1. For FreeBSD 6.1 : VembuStoreGrid_3_1_0_SP_FreeBSD_Client_Only.zip

Vembu StoreGrid FreeBSD installation compiles and installs its own version of Apache, GD and PHP. So before installing StoreGrid 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 StoreGrid, 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 StoreGrid:

1. Unzip the downloaded ZIP file.

2. Execute the bin file

VembuStoreGrid_3_1_0_SP_FreeBSD_Client_Only.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 StoreGrid in a newly created StoreGrid user account, where the StoreGrid user account will be automatically created with root privileges

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

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

Choose option 2, if you want StoreGrid to only backup files in the current user directories. Note that StoreGrid 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 StoreGrid by running the script startStoreGrid.sh and stopStoreGrid.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 StoreGrid user account which will be created. Note that StoreGrid will be installed as a daemon process and will automatically start when the system boots up. You can START and STOP StoreGrid by running the command "/etc/rc.d/storegrid start/stop".

   If you chose option 2, then you will be taken to the next step directly. Note that StoreGrid 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 StoreGrid by running the script startStoreGrid.sh and stopStoreGrid.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 StoreGrid will be installed in the "Current Directory". Setup will install StoreGrid under "Vembu/StoreGrid" in the "Current Directory" directory. To install in a different directory, enter the absolute path for Vembu StoreGrid installation. Note that setup will create the "Vembu/StoreGrid" directory under the directory you entered.

7. Upgrading StoreGrid from 3.0 to 3.1

   Vembu/StoreGrid directory found in the installation path provides you with Yes/No options:

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

   Choosing 'No' will skip the upgrade process.

   StoreGrid can be upgraded to v3.1 from StoreGrid version 3.0

8. Assign a StoreGrid ID:

StoreGrid ID is the unique name with which your StoreGrid installation is identified. By default, it takes your machine name as the StoreGrid ID. But we recommend giving your email id as the StoreGrid 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 StoreGrid ID.

• "Enter StoreGrid ID"

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

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

9. Vembu StoreGrid Web Console Authentication:

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

10. Configure Backup Server Port and UI Communication Port

By default StoreGrid 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 StoreGrid WebConsole and the StoreGrid Application. If you want to have StoreGrid 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 StoreGrid'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.

11. This installs the product and complete the installation process. After successful installation, you are provided with an option to start the StoreGrid. After the installation, You can start StoreGrid by executing the script "startStoreGrid.sh" from the directory "<INSTALLATION_HOME>/Vembu/StoreGrid/".

Note:

After successful installation, you can open the StoreGrid 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 "Vembu StoreGrid Web Console Authentication" step during the installation.