Server Windows Installation Guide

Before installing as Backup Server (or) Replication Server in your machine, you should install MySQL Server in your machine (or) in any other dedicated machine where you wish to store 's metadata information.

To know more about MySQL Server installation and configuration, please refer the following link : MySQL installation guide for Windows

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

1. Download the Windows installer, _4_3_0_SP.exe. Double click _4_3_0_SP.exe and follow the instructions in the installation wizard. Click Next to begin the installation process.

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

3. License Agreement:

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

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

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

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

5. Service Configuration :

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

   If you want to run 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, Service will always run from this user account.

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

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

6. Mode Configuration :

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

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

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

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

7. - ODBC Settings :

   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.

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

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

   By default, will be installed under "" 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 "" directory under the directory you choose. Click Next to continue.

   If detects existing data left behind from a previous installation of (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, will skip this step.

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

    By default, Server will store the backup data from the clients to the "<INSTALLATION_DIR>/" 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. Configuration : ( 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 : 's user interface is browser based. You have the option to configure the port used by web server here. Once configured you need to use this port to start the Web Console from your browser. By default Web server is configured to run on port 6060. Unless you are an advanced user, please leave this as is.

    2. Username & Password : Since 's user interface is browser based you need to configure a username and password to login to 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 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 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 too.

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

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

       3. HTTPS Port: HTTPS Port is the port used to access the 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 webconsole in secure manner. You should enable "Enable HTTPS" option to edit this value. If you enabled HTTPS option, then you can access the webconsole through https://<machine name>:<HTTPS port> URL. And also, if you try to access the 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 ports are available for and not occupied by other applications. By clicking this button, it will popup a small dialog and show the current status of the configured 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 Webserver.

12. Select Program Folder : ( 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 shortcuts (ideally, leave it as it is). Proceed to the next step to select required icons. For ease of use, allow the installer to create a desktop icon & a quick launch icon.

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

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

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

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

Note

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

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

Problem Starting in Vista

If is installed under C:/Program Files in Vista, then make sure you run 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 < 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 under the administrator account, make sure you install 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 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="< ID Value>" /DIR="< Home Path>" /SG_Mode=" 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=" webconsole user name" /SG_Pass=" webconsole Password" /SG_Port=" 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 service" /SG_WPass="Windows logon password for 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 , 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 ID: backup.billg.com ; install in Backup Server mode; as a Service, with WebConsole username: bill and password: abc123 to access the webconsole which must run on port 6087. Listens for backups/restores at 3344 port; The webconsole will communicate the through 3355 port. The user would like to see the progress of the installation as it happens

Required command line is:

_4_3_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 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 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:

_4_3_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.]