1. Home
  2. How To
  3. Install Guides
  4. Linux Bundle Install Guide

Linux Bundle Install Guide

At Snapt we believe in giving you the flexibility to use our product regardless of the Linux environment which you decide to use.

If you are making use of your own Ubuntu image and not a Snapt image then follow the following instructions below.


Please note the difference between Option 1 and Option 2

Option 1: This option does not include your trial/paid license information and serializing the install will need to performed afterward.

Option 2: This option includes your license information with the download package. (Can you used for trial installations)

You can find our images that you need by visiting our Downloads Page.

Option 1: Blank Framework

Step 1: Connecting to your VM

Before we start off this bundle install, you’ll have to connect to your VM via your preferred method. Being via the VMware Console, Putty etc.

Sometimes you’ll be asked to accept the fingerprint key, this can be done by either typing in the word “yes” or just “y”

Step 2: Download

Visit our Downloads Page and choose Linux option

 

You’ll have to transfer the download package to your server through your preferred method (SFTP, FTP, SCP).

We can also use the following command to download the file directly to your server:

Standard Linux:

wget https://shop.snapt.net/download/Snapt-Linux-Default-Linux.tar.gz

Redhat Linux:

wget https://shop.snapt.net/download/Snapt-Linux-Redhat-Fedora-CentOS.tar.gz

Step 3: Extracting

Next, we’ll need to extract the contents of the file we just downloaded.

Please note: Depending on your setup, and/or user permission of the current logged in user, you might need to run the below command as sudo

This can be done by the following command:

tar -C / -xvf ./Snapt-Linux-*.tar.gz

Alternative command:

sudo tar -C / -xvf ./Snapt-Linux-*.tar.gz

Step 4: Installing

Please note: The following command will need to be run as the root user (Administrator)

If root

/usr/local/snapt/start.sh

If Not root

sudo /usr/local/snapt/start.sh

Step 5: You’re done – almost!

Now you’ve successfully installed the base Snapt framework, but we’re not completely done yet – we still need to install 2 more additions.

Installing additional items (if they aren’t already installed)

If you have not already then you will need to install HAproxy and Nginx.

Simple run the following command to install them:

apt-get install haproxy nginx –y

Once installed you will need to run our custom Nginx compile which will add extra modules required by the Snapt Accelerator and WAF. Please follow the below guide:

Custom compile Nginx, Naxsi, and PageSpeed

 

Step 6: Logging In

You should now be able to access the Snapt Management UI if the above start script run without any errors

You can verify this by going to http://{server.ip.address}:8080 and you’ll be greeted with the following screen.

Snapt Shop Login

On this page, you’ll be required to login with your username and password used during your trial signup/Snapt Shop Account.

If you don’t have a username and password yet, you can register here

Applying your license

After you’ve logged in using your username and password, you’ll be presented to select your demo serial number or any other already purchased serials. Select the serial you want to use and click on “Finalize”

Now you’re done.

Option 2: Serial/License Framework

Step 1: Login to your online account

Firstly, to get Snapt installed with your serial and license file compiled all within, you’ll have to start off by first logging into our account.

https://shop.snapt.net

Snapt Shop Login 2

Step 1: Connecting to your VM

Before we start off this bundle install, you’ll have to connect to your VM via your preferred method. Being via the VMware Console, Putty etc.

Sometimes you’ll be asked to accept the fingerprint key, this can be done by either typing in the word “yes” or just “y”

Step 2: Download

On the top navigation bar, you’ll click through to “Download” and then you’ll select “Snapt for Linux”.

Step 3: Serial Selection

After clicking through to “Select OS” you’ll need to select the serial number we want to use within the Bundled Snapt Framework.

Please note: You might not see an option to select a serial number. This only happens when you have 1 serial allocated to your account.

Download

After making your selection of the serial number you want to use, selected the OS type, and bit size, you’ll proceed to click on the “Download!” button. This will start the build process of inserting your license information into the package that will auto download after the process has been completed.

Transfer

Now, you’ll need to transfer the downloaded file over to your environment by making use of your preferred transfer method. (SFTP, FTP, SCP)

Step 4: Extracting

Next, we’ll need to extract the contents of the file we just downloaded. This can be done by the following command:

tar -C / -xvf ./SnaptBundle-*.tar.gz

Step 5: Installing

Please note: The following command will need to be run as the root user (Administrator)

If root

/usr/local/snapt/start.sh

If Not root

sudo /usr/local/snapt/start.sh

Just the last few bits (If they are needed)

If you have not already then you will need to install HAproxy and Nginx.

Simple run the following command to install them:

apt-get install haproxy nginx –y

Once installed you will need to run our custom Nginx compile which will add extra modules required by the Snapt Accelerator and WAF. Please follow the below guide:

Custom compile Nginx, Naxsi, and PageSpeed

Step 6: Logging In

You should now be able to access the Snapt Management UI if the above start script run without any errors

You can verify this by going to http://{server.ip.address}:8080 and you’ll be greeted with the following screen.

Snapt Defaults

The default username and password for Snapt are as follow:

Username: admin

Password: admin

Configuring your Load Balancer

For the Load Balancer to fully function, we need to complete the integration with the Snapt UI/Interface and HAProxy. This process is pretty easy and the UI/interface will guide you through the process. Let’s Start

Step 1: Install the Balancer module

After you’ve successfully logged into Snapt for the first time, you’ll have to install the Load Balancer Module. The reason why you need to install the Load Balancer module is that Snapt is a modular and scalable solution. Meaning that you can choose which of the vast amounts of modules you want to use. And adapt your installation based on your unique use case.

Navigate to Setup > Modules & Plugins > Add Plugins and then click on the “Install” button to start the process of download and installing the Snapt Balancer Module

For offline installation of modules and plugins, please click here for a guide.

Step 2: Confirming the integration

After the module has been successfully installed, you’ll see it in your top navigation bar.

Now, let’s hover over “Balancer” and click on “Balancer Dashboard

Here we can see that Snapt was able to detect that we have all the required underlying prerequisites, but we do not have any configurations yet. Let’s continue by clicking on “Continue Integration

Note: If the installation of the prerequisites failed to install, you won’t be able to continue with the integration.

On the next page, you’ll proceed with the integration by clicking on “Finalize Integration

After the Integration has been finalized, you’ll be presented with the following three options:

1. Start fresh install wizard

2. Start existing install wizard

3.Skip the wizard

As per the banner on-screen, a fresh install is highly recommended, unless the installation of the Snapt framework was to integrate into an existing HAProxy configuration.

Updated on April 3, 2019


Was this article helpful?

Related Articles