View source for Setup Your Secure Web Gateway on your preferred Linux distribution


= Overview =

SafeSquid Appliance Builder (SAB) is an optimized version of Ubuntu Linux, optimized for easy setup of your secure web gateway. The SAB installs the Ubuntu Linux operating system, downloads and deploys the SafeSquid for Linux installation package, and the necessary dependencies. SafeSquid can also be installed on any other Linux operating system like Red-Hat, SuSe, CentOS, etc.

Choose this method of installation only if you want to setup SafeSquid on already existing infrastructure or if you want to use other Operating System in Linux family other than Ubuntu. It requires some additional configurations like Monit and bind services used by SafeSquid.

= Prerequisites =

You must install required dependencies and other supporting services required for some modules of SafeSquid to work smoothly.

You can check and install required&nbsp;dependencies [[Setup_Your_Secure_Web_Gateway_on_your_preferred_Linux_distribution#Dependency_Check.C2.A0|below]].

Monit and Bind are other supporting services required by&nbsp;SafeSquid to work smoothly

Check - [[Setup_Monit_for_SafeSquid_Monitoring|Configure Monit for SafeSquid Monitoring]]

Check - [[Bind_Configuration_with_SafeSquid|Bind Configuration with SafeSquid]]

= Download latest version in Linux server =

Go to the linux server and change the directory to “/usr/local/src” by using below command<br/> <span style="font-size:large">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<code>cd /usr/local/src</code></span>

Use "wget" command to download the latest SafeSquid package on&nbsp;the Linux machine on which you want to install the Safesquid. The command&nbsp;will download the tarball file.<br/> <span style="font-size:large">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<code>wget [http://downloads.safesquid.net/appliance/binary/safesquid_latest.tar.gz http://downloads.safesquid.net/appliance/binary/safesquid_latest.tar.gz]</code></span>

[[File:Wget.jpg|center|947x275px|Wget.jpg|link=]]

= Extract the tarball =

Extract the files from tar by using below command.<br/> <span style="font-size:large">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <code>tar -zxvf safesquid_latest.tar.gz</code></span>

The output&nbsp;of the above command is shown&nbsp;below.

[[File:Untar1.jpg|center|947x476px|Untar1.jpg|link=]]

All the files will be extracted in the directory having&nbsp;name "_mkappliance"'''.'''

You have to execute/run&nbsp;the '''setup.sh''' script to install SafeSquid.<br/> <span style="font-size:large">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <code>_mkappliance/installation/setup.sh</code></span>

Output after script execution is shown below.

[[File:Setupsh.jpg|center|947x385px|Setupsh.jpg|link=]]

Installation completes if you did not get any error.

= Dependency Check&nbsp; =

You can check if any of the '''dependencies '''missing for SafeSquid&nbsp;by using the "ldd" command as shown below.

&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<span style="font-size:large"><code>ldd /opt/safesquid/bin/safesquid</code></span>

Output for the above command is shown below.
<div style="background:#eee; border:1px solid #ccc; padding:5px 10px">root@safesquid:/opt/safesquid/bin# ldd /opt/safesquid/bin/safesquid<br/> &nbsp; &nbsp; &nbsp; &nbsp; linux-vdso.so.1 => &nbsp;(0x00007ffebebdb000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libldap_r-2.4.so.2 => /usr/lib/x86_64-linux-gnu/libldap_r-2.4.so.2 (0x00007ff03107e000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libpam.so.0 => /lib/x86_64-linux-gnu/libpam.so.0 (0x00007ff030e70000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; liblber-2.4.so.2 => /usr/lib/x86_64-linux-gnu/liblber-2.4.so.2 (0x00007ff030c61000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libgssapi.so.3 => /usr/lib/x86_64-linux-gnu/libgssapi.so.3 (0x00007ff030a23000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libdl.so.2 => /lib/x86_64-linux-gnu/libdl.so.2 (0x00007ff03081f000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libresolv.so.2 => /lib/x86_64-linux-gnu/libresolv.so.2 (0x00007ff030604000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libstdc++.so.6 => /usr/lib/x86_64-linux-gnu/libstdc++.so.6 (0x00007ff030300000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libm.so.6 => /lib/x86_64-linux-gnu/libm.so.6 (0x00007ff02fffa000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libgcc_s.so.1 => /lib/x86_64-linux-gnu/libgcc_s.so.1 (0x00007ff02fde4000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libpthread.so.0 => /lib/x86_64-linux-gnu/libpthread.so.0 (0x00007ff02fbc6000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007ff02f7fd000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libsasl2.so.2 => /usr/lib/x86_64-linux-gnu/libsasl2.so.2 (0x00007ff02f5e2000)</div> 
If any dependency is missing, then you might get error as shown&nbsp;below.
<div style="background:#eee; border:1px solid #ccc; padding:5px 10px">root@safesquid:/opt/safesquid/bin# ldd /opt/safesquid/bin/safesquid<br/> &nbsp; &nbsp; &nbsp; &nbsp; linux-vdso.so.1 => &nbsp;(0x00007ffebebdb000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libldap_r-2.4.so.2 => /usr/lib/x86_64-linux-gnu/libldap_r-2.4.so.2 (0x00007ff03107e000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libpam.so.0 => /lib/x86_64-linux-gnu/libpam.so.0 (0x00007ff030e70000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; liblber-2.4.so.2 => /usr/lib/x86_64-linux-gnu/liblber-2.4.so.2 (0x00007ff030c61000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libgssapi.so.3 => /usr/lib/x86_64-linux-gnu/libgssapi.so.3 (0x00007ff030a23000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libdl.so.2 => /lib/x86_64-linux-gnu/libdl.so.2 (0x00007ff03081f000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libresolv.so.2 => /lib/x86_64-linux-gnu/libresolv.so.2 (0x00007ff030604000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libstdc++.so.6 => /usr/lib/x86_64-linux-gnu/libstdc++.so.6 (0x00007ff030300000)<br/> &nbsp;&nbsp; &nbsp; &nbsp; '''&nbsp;libgmp.so.3==> not found'''<br/> &nbsp; &nbsp; &nbsp; &nbsp;&nbsp;libm.so.6 => /lib/x86_64-linux-gnu/libm.so.6 (0x00007ff02fffa000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libgcc_s.so.1 => /lib/x86_64-linux-gnu/libgcc_s.so.1 (0x00007ff02fde4000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libpthread.so.0 => /lib/x86_64-linux-gnu/libpthread.so.0 (0x00007ff02fbc6000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007ff02f7fd000)<br/> &nbsp; &nbsp; &nbsp; &nbsp; libsasl2.so.2 => /usr/lib/x86_64-linux-gnu/libsasl2.so.2 (0x00007ff02f5e2000)</div> 
If you notice that&nbsp;any of the dependencies&nbsp;are not present&nbsp;then, you should install that dependenies&nbsp;to make SafeSquid work.

= Start the SafeSquid =

Further you need to '''Start''' the SafeSquid service by using below command

<span style="font-size:large">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<code>/etc/init.d/safesquid start</code></span>

= Testing =

You can check whether SafeSquid service is running or not by using these commands.<br/> <span style="font-size:large">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<code>pidof safesquid</code>&nbsp; &nbsp;OR&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<code>netstat -tulnp | grep&nbsp;"safesquid"</code></span>

[[File:Status check.jpg|center|950x127px|Status check.jpg|link=]]

By default SafeSquid will listen on PORT 8080. If you observe SafeSquid is listening on any one of the ports shown in the image, then its&nbsp;confirm that SafeSquid has started.
<div style="background:#eee; border:1px solid #ccc; padding:5px 10px"><span style="font-size:medium">'''Note&nbsp;:'''</span>&nbsp;This installation does not include the Monit and Bind configurations.</div> 
= See Also =

1. [[Setup_Monit_for_SafeSquid_Monitoring|Monit configuration for SafeSquid Monitoring]]

2. [[Bind_Configuration_with_SafeSquid|Bind configuration in SafeSquid Server]]

3. [[Configure HTTPS Inspection|Configure HTTPS inspection]]

4. [http://docs.safesquid.com/wiki/How_to_integrate_AD_or_OpenLDAP_with_SafeSquid Integrate AD or OpenLDAP with SafeSquid]

&nbsp;

{{Seo|keywords=secure web gateway on linux,setup secure web gateway|description=Setup Your Secure Web Gateway on Linux}}

[[Category:How To]]
[[Category:SafeSquid Installation]]