Vembu StoreGrid Server Windows Installation Guide

StoreGrid Server installations (backup server and replication server installations) require MySQL database for StoreGrid's backend. To install StoreGrid and the MySQL database in your backup server (or in the replication server), all you need to do is download and run the StoreGrid Server installer. The StoreGrid Server installer will automatically download, install and configure MySQL database server. It will then download and install StoreGrid Server build.

During MySQL installation, it is recommended that you choose the default settings. For the MySQL data lacation, make sure you select a directory location where you have enough free space. StoreGrid stores about 1GB of meta-data in MySQL DBs for every 1 million files backed up. Therefore, make sure your MySQL data location has enough space to grow as client machines backup to the backup server.

1. StoreGrid Service Type:

   Select how you are going to provide backup service to your clients. You have two options,

   • Enable Reseller Management – If you are providing backup service through Resellers and would like create and manage Reseller accounts in the backup server, select this option.

   • Disable Reseller Management – If you are providing the backup server directly to your customers or using it for your own needs without Resellers, select this option.

2. Vembu StoreGrid License Agreement:

   Go through the license agreement, select "I accept the agreement" and proceed to the Next step.

3. Vembu StoreGrid - StoreGrid ID : (StoreGrid will skip this step and retain existing settings if it detects an earlier version installed)

   This will be used to identify this installation of StoreGrid. By default, StoreGrid takes the machine name. It is recommended that you enter a unique ID, like machinename.domain.name of this particular machine.

   Note: The StoreGrid ID value is case insensitive. The ID that you enter will be automatically converted to lower case.

4. Vembu StoreGrid Service Configuration :

   StoreGrid Servers are always installed as a Service. By default StoreGrid Service is selected to run from the Windows Local System Account. If you run StoreGrid service from the Local System Account, then StoreGrid will not be able to access Mapped Drives and UNC Paths which need User Logon information for accessibility. Hence, you can choose to run StoreGrid Service in a Windows User account.

   If you want to run StoreGrid service from a Windows User account, then select this option and provide the User Name and the Password for the user account in the appropriate fields and click Next. In this case, StoreGrid Service will always run from this user account.

   If your Windows user login is dependent on a Domain Controller, then install StoreGrid Service from the Windows Local System Account. You can then manually configure StoreGrid to run from a User account later by going to Control Panel -> Administrator Tools -> Services and changing the StoreGrid service options to run as a user.

   NOTE : Please make sure, the User account configured for StoreGrid Service has 'Logon As Service' permission in Windows security policies.

5. Vembu StoreGrid Mode Configuration :

   Select how you’d like StoreGrid to run on this machine. You have two options,

• Backup Server – Other computers can back up on to this computer.

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

Select one of the two options and click ‘Next’.

6. Vembu StoreGrid - StoreGrid ODBC Settings :

   StoreGrid uses the system DSN to connect to the MySQL server to store the metadata information of the backup server/replication server. Please enter the Data Source Name, Database Name which is already created during MySQL server installation. Please enter the User Name and Password to connect to the MySQL Server. It is recommended that you use the default values.

7. Cluster Configuration :

   Clustering will be disabled by default. If you would like to enable Clustering in your backup server, enter a name for your Cluster. Also mention the external IP or DNS lookup name at which the clients will connect to this cluster node for backup.

   NOTE : If you are adding an addition cluster node for your cluster, make sure you enter the same cluster name as the previous cluster node installation.

8. Choose Installation Location : (StoreGrid will skip this step and retain existing settings if it detects an earlier version installed)

   By default, StoreGrid will be installed under "Vembu\StoreGrid" in the "C:\Program Files" directory. Click Next to continue installation in the default directory. Click Browse to choose a different directory. Note that this will create the "Vembu\StoreGrid" directory under the directory you choose. Click Next to continue.

   If StoreGrid detects existing data left behind from a previous installation of StoreGrid (wherein you uninstalled the previous version but left some data behind) it will prompt you for a desired action. If no ‘old data’ was found in the installation directory or if you are simply upgrading from an existing installed version, StoreGrid will skip this step.

9. StoreGrid Server's Backup Storage Location : (StoreGrid will skip this step and retain existing settings if it detects an earlier version installed)

   By default, StoreGrid Server will store the backup data from the clients to the "<INSTALLATION_DIR>/Vembu/StoreGrid" directory. If you want to change the server's default backup location, please choose a different directory from the tree. Click Next to continue.

10. Vembu StoreGrid Configuration : (StoreGrid will skip this step and retain existing settings if it detects an earlier version installed)

    There are three parts to this step.

    1. Configure Web Server Port : StoreGrid's user interface is browser based. You have the option to configure the port used by StoreGrid web server here. Once configured you need to use this port to start the StoreGrid Web Console from your browser. By default StoreGrid Web server is configured to run on port 6060. Unless you are an advanced user, please leave this as is.

    2. Username & Password : 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. By default the username and password used by StoreGrid is "admin" and "admin". You have the option to change these default settings here.

    3. Advanced Port Configuration (Including HTTPS): Click on the Advanced Port Configurations (Including HTTPS) link to configure StoreGrid backup server port, UI communication port and HTTPS port. Provide valid TCP port numbers for Backup Server Port, UI Communication Port and HTTPS port. You will be able to configure 'Advanced Port Configuration' while upgrading StoreGrid too.

       1. Backup Server Port is the port through which StoreGrid clients will backup the data to the backup server. The default value is 32004.

       2. UI Communication Port is the port through which StoreGrid Apache/PHP modules communicate with StoreGrid to serve UI requests from the StoreGrid WebConsole. The default value is 32005.

       3. HTTPS Port: HTTPS Port is the port used to access the StoreGrid Webconsole in a secured manner through HTTPS protocol. Default value is 6061.

       4. Enable HTTPS: HTTPS Port is the secure webconsole port through which you can access the StoreGrid webconsole in secure manner. You should enable "Enable HTTPS" option to edit this value. If you enabled HTTPS option, then you can access the StoreGrid webconsole through https://<machine name>:<HTTPS port> URL. And also, if you try to access the StoreGrid webconsole through http://<machine name>:<webconsole port>, then you will be automatically redirected to https://<machine name>:<HTTPS port> url.

       5. Check Ports: You can use this small utility to check whether the configured StoreGrid ports are available for StoreGrid and not occupied by other applications. By clicking this button, it will popup a small dialog and show the current status of the configured StoreGrid ports.
          
          

          For example, if the Check Port Availability dialog shows status as "Webserver port: Available [6060]", it means, the 6060 TCP port is available for running StoreGrid Webserver.

11. Select Program Folder : (StoreGrid will skip this step and retain existing settings if it detects an earlier version installed)

    Click Next to select the Programs Folder to add the StoreGrid shortcuts (ideally, leave it as it is). Proceed to the next step to select required icons. For ease of use, allow the StoreGrid installer to create a desktop icon & a quick launch icon.

12. Click Next to review your settings. Thereafter, click Install, and proceed to install StoreGrid.

If you are updating from an earlier version, you will be informed that StoreGrid will now stop and restart after the installation.

13. After copying the StoreGrid files, a page will show the progress of StoreGrid installation. If StoreGrid installation completes successfully, you will be automatically redirected to the finished installation page. Otherwise, the installation progress page will show the error details.

14. If this is the first time you are using StoreGrid, have a look at the README file when prompted; it will help you get started real quick.

Note

• A shortcut to start StoreGrid and StoreGrid Web Console will be created on the System Tray and in the Start > Programs > Vembu StoreGrid menu.

• After successful installation, you can open the StoreGrid Web Console by right-clicking the StoreGrid icon in your system tray and selecting the StoreGrid Web Console from the menu, or alternatively, doing the same through the Start > Programs > Vembu StoreGrid > StoreGrid Web Console menu. You will have to login to the Web Console using the username and password you provided in the "Vembu StoreGrid Configuration" screen during the installation.

Problem Starting StoreGrid in Vista

If StoreGrid is installed under C:/Program Files in Vista, then make sure you run StoreGrid with the option "Run as Administrator". The reason been, Vista allows an application to access the 'Program Files' folder only when run as an administrator user. You can enable the 'Run as Administrator' option for the <StoreGrid Home>\bin\StoreGrid.exe application through it's file properties dialog through  'Compatibility' tab -> 'Privelege Level' -> 'Run this application as administrator' option.

If you don't have administrator access or if you don't want to run StoreGrid under the administrator account, make sure you install StoreGrid under your user account folder or other than the 'Program Files' folder.

1. What is a silent installation?

Some service providers prefer not to have their customers go through the step by step installation screens typical of most installations from within the windows operating system, and instead would like to install StoreGrid directly and 'silently' from the command line prompt.

2. How do I do a 'silent install' from the command line?

For command line/silent installation, just follow the simple steps below:

• There are two options available: SILENT & VERYSILENT.
• In a SILENT installation, during installation, the Installation Progress page is displayed once installation has started and till it is complete.
• In a VERYSILENT installation, no Installation Progress page will be shown.

Syntax to be followed:

<Build File Name> [/SILENT or /VERYSILENT] /AGREE_LICENSE="yes/no" /SG_ID="<StoreGrid ID Value>" /DIR="<StoreGrid Home Path>" /SG_Mode="StoreGrid Mode" /SG_ODBC_DSName="The ODBC Datasource Name." /SG_ODBC_HostName="The DB Server Host Name." /SG_ODBC_DBName="The ODBC Database Name." /SG_ODBC_User="The ODBC Datasource login User Name." /SG_ODBC_Pass="The ODBC Datasource login Password." /SG_Cluster_Enable="To enable clustering in this installation." /SG_Cluster_Name="If clustering is enabled, the cluster name for the cluster has to be provided." /SG_Public_LookupName_IP="This lookup name or ip will be used to connect to this particular cluster node." /SG_User="StoreGrid webconsole user name" /SG_Pass="StoreGrid webconsole Password" /SG_Port="StoreGrid webconsole port" /SG_PrevDataOption="delete/rename" /SG_BackupPort="The Backup server port." /SG_UIPort="The UI communication port." /SG_HTTPS="0/1" /SG_HTTPSPort="The HTTPS port." [/SG_WUser="Windows logon user name for StoreGrid service" /SG_WPass="Windows logon password for StoreGrid service"] /LOG="Installation log file name".

Note:

• /SILENT or /VERYSILENT must be the first argument immediately after the <build file name>
• Thereafter, there is no fixed order for providing the command line arguments.
• There should be a space between <build file name> and each command line arguments.
• Except user names and passwords, all other values are case insensitive
• We recommend that you provide the /LOG option the first couple of times that you use the silent installation so you can identify issues during the silent installation, if any.

Description of Arguments, etc (Arguments with * are mandatory):

^# - While upgrading StoreGrid, if these arguments not provided, the values will be taken from the previous installation. If it is a new installation, the default values as mentioned in the table will be used.

VERY IMPORTANT: SG_ID and AGREE_LICENSE are mandatory arguments (besides /SILENT or /VERYSILENT); all other arguments are optional.

Examples of valid Commands:

1. Silent Install for a user whose SG installation will be referred by the StoreGrid ID: backup.billg.com ; install in Backup Server mode; as a Service, with WebConsole username: bill and password: abc123 to access the StoreGrid webconsole which must run on port 6087. Listens for backups/restores at 3344 port; The webconsole will communicate the StoreGrid through 3355 port. The user would like to see the progress of the installation as it happens

Required command line is:

VembuStoreGrid_3_1_0_SP.exe
/SILENT
/AGREE_LICENSE="yes"
/SG_ID="backup.billg.com"
/SG_Mode="601"
/SG_User="bill"
/SG_Pass="abc123"
/SG_Port="6087"
/SG_BackupPort="3344"
/SG_UIPort="3355"
/SG_HTTPS="1"
/SG_HTTPSPort="6088"
[Note: All the command line options should come in single line.]

2. Silent Install for a user whose SG installation will be referred by the StoreGrid ID: replication.billg.com ; install in Replication Server mode; as a service, with WebConsole user name as default username: admin and default password: admin, to run StoreGrid WebConsole on the default port 6060. The user is not bothered about seeing the progress of the installation as it happens. Just install it!

Required command line is:

VembuStoreGrid_3_1_0_SP.exe
/SILENT
/AGREE_LICENSE="yes"
/SG_ID="replication.billg.com"
/SG_Mode="609"
[Note: All the command line options should come in single line.]