Vembu StoreGrid Professional Edition

Windows Installation Guide

The StoreGrid Windows version is available for download in the following URL: http://www.vembu.com/download.php

Download the Windows installer, VembuStoreGrid_2_5_1_Pro.exe

To install StoreGrid on Windows machines, follow the steps given below:

  1. Double click VembuStoreGrid_2_5_1_Pro.exe and follow the instructions in the installation wizard.

  2. Click Next to begin the installation process. Go through the license agreement, select "I accept the agreement" and proceed to the Next step. If you are updating from an earlier version, you will be asked to confirm this.

  3. Installation Configuration (Windows Application or Service):

    While updating to or installing StoreGrid 2.5.1, you can either install StoreGrid as a Windows Application or as a Windows Service.

    By default, StoreGrid will be installed as a Windows Application and it will run in the background. Note that if you choose this mode, StoreGrid will only start if the user who installed it logs in to the PC. If the user logs off, then StoreGrid will exit.

    Advanced users may choose to install StoreGrid as a Windows Service. Click on the link that says "Click here to install StoreGrid as a Windows service" and proceed to the next step.

  4. This step is applicable only if you have installed StoreGrid as a service. If you have installed StoreGrid as an application, please skip this Step and proceed to Step 5.

  5. If you want to run StoreGrid Service from the Windows Local System Account, then select this option. If you run StoreGrid service from the Local System Account, then StoreGrid will not be able to automatically collect information on User specific backup configurations like Outlook/Outlook Express backup, and IE Settings. You will need to manually select the required files and folders.

    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 be run from this user account. Hence, StoreGrid can correctly collect information on User specific backup configurations like Outlook/Outlook Express backup, and IE Settings.

    If your Windows user login is dependent on a Domain Controller, then run StoreGrid Service from the Windows Local System Account. You can 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 .

  6. Select how you’d like StoreGrid to run on this machine. You have four options:

    • Client & Server – This computer can back up on to other computers and vice versa. This setting is especially relevant if you are running StoreGrid as a peer to peer backup solution.

    • Client only – This computer can back up on to other computers. However, other computers cannot back up on to this computer.

    • Server only–Other computers can back up on to this computer. However, this computer cannot back up on to other computers.

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

    • Select one of the four options and click ‘Next’.

  7. (StoreGrid will skip this step and retain existing settings if it detects an earlier version installed) Enter a StoreGrid Identity. This will be used to identify this installation of StoreGrid on your network / your online backup service provider’s network. By default, StoreGrid takes the machine name. Ideally, enter the email ID of the client using this particular machine. Using an email ID ensures that your StoreGrid ID is truly unique. Note: The StoreGrid ID value is case insensitive. Hence, the 'StoreGrid ID' you have entered will be automatically converted to lower case.

    Enter a valid StoreGrid Group Name. The StoreGrid Group name is the 'name' under which your client is categorized (on the backup server). By default, this is set to "Default Group". Please leave this as the default "Default Group". You need not to provide this value if you are installing StoreGrid in Server Only or Replication Server mode.

  8. (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.

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

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

  11. (StoreGrid will skip this step and retain existing settings if it detects an earlier version installed) There are three parts to this step.

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

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

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

  13. (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.

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

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

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

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

  • StoreGrid will automatically migrate your old data to 2.5.1 after you start StoreGrid for the first time.

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

StoreGrid Silent Installation

  1. What is a silent installation?

  2. Some service providers prefer not to have their groups 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.

    The StoreGrid 'customized client build' you have been provided is capable of being installed from the command line exactly as described above. The same build will also work from within Windows(as a UI based installation) wherein you just double click the build file and follow the steps on the screen.

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

  4. 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="<Client identity>" /SG_GroupName="<Group Name>" /DIR="<StoreGrid Home Path>" /SG_Mode="StoreGrid mode" /SG_Type="service/application" /SG_User="StoreGrid webconsole user name" /SG_Pass="StoreGrid webconsole Password" /SG_Port="StoreGrid webconsole port" /SG_PrevDataOption="keep/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):

Argument Description Values Default Value Note
*/SILENT
*/VERYSILENT
You must specify either one of these options - - -
*AGREE_LICENSE Do you agree with the License Agreement? Yes / No No Hence this argument is necessarily required to be set to "Yes" to run the installation.
Please install StoreGrid from within the Windows UI if you would like to see the license agreement.
You may want to copy & paste this agreement on an html page on your website for your groups to read, if required.
*SG_ID StoreGrid client id. Must not be null or invalid id. Ideally, this should be an email ID as this is unique and easily remembered. In fact, if you can, insist that all your groups use email IDs as StoreGrid IDs. As your business grows, you'll be glad you did! - - More on valid client IDs:
  • Allowed characters: [A-Z][a-z][0-9][ - @ _ .]
  • Value must not contain more than two "@" characters
  • Must not start or end with special characters
  • Length must be 1 - 50 characters.
SG_GroupName StoreGrid Group Name. Must not be null or invalid value. - Default Group # More on valid Group Name
  • Allowed characters: [A-Z][a-z][0-9][ - @ _ .]
  • Length must be 1 - 50 characters.
DIR Installation location Any valid location C:\Program Files\ # This location is the StoreGrid Home.
SG_Mode Mode of StoreGrid installation 601/602/603/609 603 #
  • 601 - Server Only
  • 602 - Client only
  • 603 - Both Client and Server
  • 609 - Replication Server
SG_Type StoreGrid installation type Service / Application Application # If selected service option, please provide SG_WUser & SG_WPass also.
SG_WUser & SG_WPass If StoreGrid installation type (see above) is Service, pls. provide the logon account details. Valid Windows User name and Password - No additional details are required for installing for Local System Account.
SG_User & SG_Pass Authentication details for StoreGrid webconsole [username & password] - User name: admin
Password: admin
-
SG_Port StoreGrid Webconsole port number. Any valid TCP port number 6060 # -
SG_PrevDataOption During installation, if there is existing data from a previous installation of StoreGrid, what is to be done? Keep / Delete / Rename Keep -
SG_BackupPort The port through which StoreGrid clients will backup the data to the backup server. Any valid TCP port number between 1 to 65535 32004 # -
SG_UIPort The port through which StoreGrid Apache/PHP modules communicate with StoreGrid to serve UI requests from the StoreGrid WebConsole. Any valid TCP port number between 1 to 65535 32005 # -
SG_HTTPS You can enable the secure HTTPS web access by checking the "Enable HTTPS" check box. 0 / 1 0 # 0 - Disable
1 - Enable
SG_HTTPSPort HTTPS Port is the secure webconsole port through which you can access the StoreGrid webconsole in secure manner. Any valid TCP port number between 1 to 65535 6061 # Must not be same as the SG_Port / SG_UIPort / SG_BackupPort
SG_WValidate Option to enable or disable validation of Windows login details. Enable - 1
Disable - 0
Enable Some machines do not validate Windows login details correctly – may reject even when the login details are right. In such cases, turning this option off may be advisable. If this option is turned off and if the login details entered are wrong, then the user may not be aware that the login details are wrong till the backup is scheduled and fails to run.
SG_SSL_SERVERPORT_STATUS HTTPS Port is the secure webconsole port through which you can access the StoreGrid webconsole in secure manner. Enable - 1
Disable - 0
0 This status tells if the client needs to connect to the backup server through the SSL enabled backup port or not. If this option is enabled, valid SSL Backup port should be specified during silent installation. If this option is not provided during upgrade, then the previous installation value is taken.
SG_SSL_SERVERPORT Backup port with SSL security. Valid port value 32007 The backup port value with SSL security option. It should be the same at backup server and client system. If this option is not provided then the previous installation value is taken.

    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 client ID: billg@vembu.com ; install in both client-server mode; install as an application, the user will use the username: bill and password: abc123 to access the StoreGrid webconsole which must run on port 6087. Connects backup servers 3344 port for backup; The webconsole will communicate the StoreGrid application through 3355 port. The user would like to see the progress of the installation as it happens

    2. Required command line is:

      VembuStoreGrid_2_5_1_Pro.exe
      /SILENT
      /AGREE_LICENSE="yes"
      /SG_ID="billg@vembu.com"
      /SG_Mode="602"
      /SG_Type="Application"
      /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.]

    3. Silent Install for a user whose SG installation will be referred by the client ID: billg@vembu.com ; install in both client-server mode; install as an application (default), the user will use the default username: admin and default password: admin to access the StoreGrid webconsole which must run on the default port 6060. The user is not bothered about seeing the progress of the installation as it happens. Just install it!

    4. Required command line is:

      VembuStoreGrid_2_5_1_Pro.exe
      /SILENT
      /AGREE_LICENSE="yes"
      /SG_ID="billg@vembu.com"
      [Note: All the command line options should come in single line.]

    Contact us at for any additional help you may require with silent installations.