Snapt Bundle - Full install guide
At Snapt we believe in giving you the flexibility to use our product regardless of the Linux environment. We believe in giving you the flexibility to use our product regardless of the environment.
If you are not using a snapt image and your own Ubuntu image the installation instructions are as follows until Step 4. If you are using a Snapt Image skip Step 1-4 and proceed to Step 5
Transfer the file via SCP (if it's a remote server) into your Ubuntu environment
scp -r /home/snapt/documents/SnaptBundle-10106570.tar.gz root@(yourserversip)/home/root
Extract the downloaded file into / by running:
tar -C / -xvf BundleFileName.tar.gz
This command will start the Snapt service and you will be able access it from a browser on port 8080 eg. http://192.168.56.101:8080
To install HAproxy and Nginx (if you have not already installed it)
Simply run the command:
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:
Please Note: The Snapt bundle only includes the Snapt framework – HAProxy and Nginx (which are required by the Balancer and Accelerator modules respectively) are not installed with the bundle.
The Snapt UI is now active and running on port 8080. You can access this from your web browser using the IP assigned to your web service plus: 8080. Eg:
Once the required packages have been installed, the next step would be to go through the Snapt Balancer and Accelerator install wizards to ensure Snapt correctly integrates with these packages accordingly.
The wizard will guide you to through the default setup screen.
NB: If for some reason you get logged out of the wizard the default username and password for the Snapt UI is:
How to set up the Balancer
Navigating to Balancer > Dashboard will redirect you to the installer.
From here, the system should detect the installed HAproxy package, and you can click the Continue Integration button.
Next, confirm the default paths for the haproxy binary and config file.
Next you will be provided a summary of the integration options, and you can then click the button to “Continue to the Dashboard”
At this point, you will be prompted with 3 options:
- Start fresh install wizard
- Start existing install wizard
- 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.
For the purposes of this guide we’ll go with the “Start fresh install wizard” option.
You will be directed to the Installation Wizard and be prompted to either Start the Wizard or Skip.
By clicking Start you will first have the opportunity to specify a few Balancer defaults:
Thereafter you can configure a few Snapt specific Balancer options, such as the Live Dashboard refresh interval.
Lastly, you will need to configure the Balancer logging options.
Then, with the wizard completed, you will be prompted with a progress confirmation screen. From here you can click Finished.
You will be directed to the Snapt Balancer dashboard, and from here you can use the Create a load balancer to get started configuring your Balancer groups.
How to set up Accelerator
Exactly like the described in the Balancer section, you will be directed to the installer once you navigate to Accelerator > Dashboard
The system should detect the installed Nginx package and prompt you to Continue Integration.
Again, similar to the Balancer, it will prompt you to confirm the paths to various Nginx related files.
Next, you will be provided with a summary of the installation, allowing you to Continue to the Dashboard.
You will be directed to the Snapt Accelerator dashboard, and from here you can start the Quick Setup to start adding your front-end and back-end servers.