V.2.

1 Installation Guide

Table of Contents
Chapter 1 Chapter 2 Chapter 3
Introduction ...................................................................................................... 3 System Requirements........................................................................................ 4 Supported Database Servers ............................................................................. 5 3.1 Microsoft SQL Server.................................................................................. 5 3.2 MySQL ........................................................................................................ 5 3.3 PostgreSQL ................................................................................................. 5

Chapter 4

Choosing an installation location ...................................................................... 6 4.1 Installing on the Application server ............................................................ 6 4.2 Installing on a Physical or Virtual Dedicated server ................................... 7 4.3 Installing on the Database server ............................................................... 7

Chapter 5

Installing GreenSQL ........................................................................................... 8 5.1 Installing GreenSQL on a Windows server .................................................. 8 5.2 Installing GreenSQL on a Linux server ...................................................... 11

Chapter 6

License Installation .......................................................................................... 12 6.1 To Apply GreenSQL license using the GreenSQL Wizard .......................... 12 6.2 To Apply GreenSQL license manually ....................................................... 13

Chapter 7

Uninstalling GreenSQL ..................................................................................... 14 7.1 Uninstalling GreenSQL on a Windows server ............................................. 14 7.2 Uninstalling GreenSQL on a Linux server ................................................... 15

1
Introduction
GreenSQL is a Unified Database Security solution that is installed as a front-end to databases, fully camouflaging and securing them. GreenSQL works as a SQL reverse proxy and provides several database security and acceleration features including automated learning mode, a database rule-based firewall, database audit, database intrusion detection and prevention, database caching, database masking and database virtual patching.

2
System Requirements
GreenSQL supports both x64 and x86 installations Operating Systems Windows Server 2003/2008 Linux distributions (tested on Ubuntu 9.04 or above and CentOS 5.4 or above) The following minimum system requirements must be met: Minimum memory, hard disk space and CPU 2048 MB of RAM 200 MB for Installation (Audit information and logging require more space depending on configured policies) At least 2 dedicated Cores (4 cores are required in environments with hundreds of transactions per second)

3
Supported Database Servers
The following Database servers are supported:

3.1 Microsoft SQL Server

Microsoft SQL Server 2000 Microsoft SQL Server 2005 Microsoft SQL Server 2008 Microsoft SQL Server 2008R2

3.2 MySQL

MySQL 4.x MySQL 5.x

3.3 PostgreSQL

PostgreSQL 8.x PostgreSQL 9.x

4
Choosing an installation location
GreenSQL can be installed in various configurations or architectures.

On the Application server On a Dedicated server (Physical or Virtual) On the Database server

This chapter describes the advantages or the main motivations for installing GreenSQL in each location.

4.1 Installing on the Application server

The following list describes the advantages of installing GreenSQL on the Application server:
1. Enables enforcement of the security policies before queries exit the Application

server. (Great advantage when the application server is located in a remote site or branch)
2. Performance acceleration - Achieved by the GreenSQL Caching module. Database is

queried less frequently, thus saving in Database server resources and network utilization.
3. Protects Database server's Operating System by preventing direct access to the

Database management system.

When installing GreenSQL on the application server, it is also recommended to install another instance of GreenSQL on a dedicated server to prevent unauthorised access from the remote application server (If the application server has been compromised) with the GreenSQL to the Database.

4.2 Installing on a Physical or Virtual Dedicated server

The following list describes the advantages of installing GreenSQL on a physical or virtual dedicated server:
1. Provides the best performance to the GreenSQL solution. 2. Provides full protection of the Database's Operating System and the Database

Management System.
3. Camouflaging of the Database server The IP address of the Database will not be

accessible. GreenSQL can be installed behind a firewall, for example in a DMZ.

4. Database and application performance acceleration - Achieved by the GreenSQL

Caching module. Database is queried less frequently, thus saving in Database server resources and network utilization.
5. Provides a front-end to your Databases to which all your applications, developers and

your IT personnel connect.

4.3 Installing on the Database server

GreenSQL is installed on the Database server usually when the Database and the application are located on the same server and it is difficult to produce another server at the time. Another situation where GreenSQL can be installed on the Database server is when the Database is located outside of the local network perimeter.

5
Installing GreenSQL
This chapter describes the installation procedure of GreenSQL. Follow the instructions below to install GreenSQL on the server.

5.1 Installing GreenSQL on a Windows server

After requesting to download GreenSQL and registering at the GreenSQL website, an email is sent to you with the installation file and license key. To install GreenSQL, follow the instructions below and proceed to the next chapter License Installation. Execute the GreenSQL installation by double-clicking the installation file. The installation wizard will appear, presenting the License Agreement.

Click I Agree to accept the license agreement. The Choose Components page is displayed.

To prevent a creation of Start Menu Shortcuts, remove its selection. Click Next. The Choose Install Location window appears.

To modify the GreenSQL program directory, select Browse, choose a different location for the program directory and click Install. Otherwise, simply click Install. Once the GreenSQL installation completes, the following window appears.

Click Close. GreenSQL is now active and running.

GreenSQL installation automatically launches your default browser on its logon page. To access GreenSQL management console, either click the GreenSQL Management icon found in the Windows Start menu Programs/All Programs GreenSQL or open your favorite internet browser and browse to the following location: https://[Server_IP_Address]:5000 (Where Server_IP_Address is any one of the servers IP addresses) Default username: admin Default password: pwd Once the GreenSQL management console appears, install the license. For license installation instructions, see: License Installation.

5.2 Installing GreenSQL on a Linux server

After requesting to download GreenSQL and registering at the GreenSQL.com website, an email is sent to you with the installation file and license key. To install GreenSQL, follow the instructions below and proceed to the next chapter License Installation. GreenSQL installation requires root permissions. Execute the GreenSQL installation file as follows: sh greensql.run

When the installation is completed, read the End User License Agreement found at: /opt/greensql/license.txt To access GreenSQL management console, open your favorite internet browser and browse to the following location: https://[Server_IP_Address]:5000 (Where Server_IP_Address is any one of the servers IP addresses) Default username: admin Default password: pwd Once the GreenSQL management console appears, install the license. For license installation instructions, see: License Installation.

6
License Installation
6.1 To Apply GreenSQL license using the GreenSQL Wizard
GreenSQL wizard will guide you through the first steps with GreenSQL including the License installation. The wizard will pop up on your first logon to GreenSQL Management.

Click on the Next button

Type (Or paste) into the text box, the serial number sent to you by e-mail. If you have not received a trial key by email or you have downloaded GreenSQL from a third-party website please click here to obtain your license key. The next two wizard steps will provide you the option to configure your Database Server and Proxy setup.

Once license has been installed or Database Server was configured Wizard will not show up on next logons.

6.2 To Apply GreenSQL license manually

1. Click the System icon from any of the GreenSQL applications pages. 2. Click on License in the left-hand functions table. The license installation page is displayed.

3. Type (Or paste) into the text box, the serial number sent to you by e-mail. 4. Click the Update button to install the license. Within a couple of minutes, the following screen will appear:

To buy or upgrade GreenSQL license, contact GreenSQL sales at: http://www.greensql.com/contact

7
Uninstalling GreenSQL
7.1 Uninstalling GreenSQL on a Windows server
GreenSQL uninstaller requires administrative permissions. Click on the uninstall.exe file and click on the Uninstall button.

During the installation the following message box will pop up

Click Yes to delete all log files.

7.2 Uninstalling GreenSQL on a Linux server

GreenSQL uninstaller requires root permissions. Execute the GreenSQL installation file as follows: sh greensql.run --uninstall