DEVACAPS - Data Evacuation and Protection Services

New Orleans (504) 250-6407
Thibodaux (985) 228-1028
 

DEVACAPS StoreGrid 2.1 Installation Guide

The Linux version of StoreGrid is available for download at the following URL: http://www.DEVACAPS.com/downloads/downloads.html

Download the FreeBSD installer, DevaCaps_2_1_SP_FreeBSD.zip

DEVACAPS 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.

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:

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

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

  • 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)

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

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

1. Unzip the downloaded ZIP file.

2. Execute the bin file VembuStoreGrid_2_1_SP_FreeBSD.bin

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

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

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

Choose option A, if you want StoreGrid to have root privileges so that it can be configured to backup user 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". You can check the status of StoreGrid application by running the command "/etc/rc.d/storegrid status".

Choose option B, 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 A, 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". You can check the status of StoreGrid application by running the command "/etc/rc.d/storegrid status".

If you chose option B, 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 from StoreGrid 2.0/2.0.1 to 2.1

If Vembu/StoreGrid directory is found in the installation path. You will be provided with three update options.

  • UPDATE Vembu StoreGrid by retaining the previous backup data. Note that all backup data in StoreGrid 2.0/2.0.1 will be automatically migrated to 2.1 when StoreGrid 2.1 starts for the first time.[ Recommended ]

  • RENAME previous backup data folders and continue with updating Vembu StoreGrid.

  • DELETE previous backup data and continue with updating Vembu StoreGrid. You will lose all your previous configuration and other backup metadata and also any backup data from other users backing up to this computer. [ Not Recommended ]

8. Configure StoreGrid as :

You need to choose one of the options (Client-Server, Client, Server). The four modes are explained in detail below.

  • Client-Server - This option will configure this StoreGrid installation to run in full peer mode, which means StoreGrid can function both as a client backing up local files/folders to other StoreGrid peers and also as a server which can be used for backing up data from other StoreGrid peers.

  • Client - This option will configure this StoreGrid installation to run only as a client (half peer), which means StoreGrid can backup local files/folders to other StoreGrid peers but cannot accept backup data from other StoreGrid peers.

  • Server - This option will configure this StoreGrid installation to run only as a server (half peer), which means StoreGrid can accept backup data from other StoreGrid peers but cannot backup local files/folders to other StoreGrid peers.

  • Replication Server – Other StoreGrid backup servers can replicate their data to this server for redundancy.

9. 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 provided with these option:

  • "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 for Vembu StoreGrid 2.1 Service Provider Edition"

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

10. 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.

11. Web Server Port

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

12. 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.


DEVACAPS.com

Data Evacuation and
Protection Service

Your data is too important
to leave behind.