Installing on Debian Sarge

From UntangleWiki

Jump to: navigation, search

This howto covers how to install untangle from packages on a debian sarge server.

Contents

[edit]

Why install from packages?

Some users wish to install untangle in a more customized environment. Some users have not had success with the knoppix based installer on certain hardware configurations. This approach may help and is much easier than building from source. Basic knowledge of debian is required.

WARNING: This howto will be outdated as of version 5.1 (Thunderbird). Thunderbird will officially support ubuntu gutsy and/or debian sid.

[edit]

Step 1 - Install Debian Sarge

Download a Debian Sarge installer CD. ftp://ftp.ch.debian.org/debian-cd/3.1_r5/i386/iso-cd/debian-31r5-i386-binary-1.iso

Go through the whole installation appropriate for your machine. After the first reboot, DO NOT choose http as your source for packages (choose cdrom or skip this step). If you do choose http, you'll be updated to etch (the current stable)

[edit]

Step 2 - Install whatever packages you wish

This step is optional. Install whatever packages you normally like. In my case, I do: 

 apt-get install zsh rsync ssh emacs21 sudo less
[edit]

Step 3 - Edit your sources.list

Since Sarge is no longer the stable Debian version, you will have to either change or delete this line in your sources.list if it's there, otherwise you'll get a dependency error in Step 5. 

 deb http://security.debian.org/ stable/updates main contrib


Edit your sources.list or run the following command: 

 cat >> /etc/apt/sources.list << EOF
 deb http://ftp.debian.org/debian sarge main contrib non-free
 deb http://security.debian.org/ sarge/updates main contrib
 deb http://user:metavize@updates.untangle.com/untangle stable main upstream
 EOF
[edit]

Step 4 - Install the untangle kernel

WARNING: this overwrites your kernel config - so if you are running this on an existing server make sure you know what you are doing! Run the following commands: 

 apt-get install untangle-linux-image-2.6.16-ck11-untangle-cd-486 untangle-linux-2.6.16-ck11-config
 reboot
[edit]

Step 5 - Install the untangle vm and associated packages

Run the command: 

 apt-get install untangle-appliance-int untangle-client
 reboot

This will take a while, untangle-appliance-int is the top level package for an untangle server Answer all debconf questions as the default, except the java license question

Also reconfigure debconf to not ask so many questions 

 dpkg-reconfigure debconf

Answer "noninteractive" and "critical"

[edit]

Step 6 - Configure your untangle server

This step can be done two ways. Configure X and do so locally by running 'untangle-client'. Or do so remotely using another machine. To do this get the IP address of the untangle server via 'ifconfig' and connect remotely to this IP from another PC by opening a browser to https://IP. This will allow you to login and complete the wizard. You may be disconnected to the wizard after changing your External IP address settings, but you can just log in again to the new IP once that is done.

[edit]

Step 7 - Turn off upgrades

You will need to turn off automatic upgrades in Config->Upgrades->Settings. Automatic Upgrade runs 'apt-get dist-upgrade' every night which will not work in a typical debian setup.

[edit]

Known Issues

  • Boot-up progress bar doesn't work - this is fine it just doesn't show progress
  • untangle-vm bootup can be excessively slow due to more entries in /etc/apt/sources.list
  • The default settings of the untangle-vm aren't like a fresh install
  • /etc/apt/sources.list seems to get overwritten at times (after upgrade?)
Retrieved from "http://wiki.untangle.com/index.php/Installing_on_Debian_Sarge"
Personal tools