Quick Install Guide for Untangle for Ubuntu
http://wiki.untangle.com/index.php/Quick_Install_Guide_for_Untangle_for_Ubuntu
ไว้แปลในวันว่าง ๆ อิ อิ
From UntangleWiki
Contents[hide] |
What is Untangle for Ubuntu?
Starting with the Untangle Server 5.2 release, you can install the Untangle Server onto an existing Linux systems of specific distributions. Untangle Server no longer needs to have its own operating system. Basically, now there are two ways to install an Untangle Server:
| Product | Install Method | GUI | Advantage |
|---|---|---|---|
| Untangle Gateway (Traditional) | Untangle ISO ISO distribution that installs Untangle Gateway and a base Linux distribution (sarge). In this case, Untangle delivers bootable ISO distribution installer. The installer checks your machine for compatibility, partitions the drive, installs the base Linux distribution (sarge), then reboots the Untangle Server. Your new Untangle Server is ready! | The Untangle Gateway's Untangle Kiosk (untangle-kiosk) consists of:
 | This solution is perfect for those that don't want to fuss with an operating system. |
| Untangle for Ubuntu (NEW) | Untangle install script In this case, you boot the Linux ISO. The installer partitions your disk and installs the Linux distribution. Then, you check your machine for compatibility and install Untangle Server. The server becomes a fully functioning Untangle Gateway. All core Untangle Server services and the administration client are supported. | Instead of the traditional Untangle Kiosk, use the Untangle Gateway default desktop manager to launch Untangle Client, backup and restore your Untangle Server, shutdown/restart your Untangle Server, and to launch screensaver.  | This solution is especially useful to MSPs that have internal business requirements that mandate a specific Linux distribution. This solution is also useful for open-source developers.
|
About Automatic Logon & Session Management
The main part of the Untangle kiosk is the automatic login and X session management. There is a user created named kiosk, and this user is automatically logged into a minimal appliance-like X desktop. The user has an invalid password, so the user cannot log into the system in any other way (such as ssh). Your existing Linux system already has a login mechanism—the original user that Linux created at during initial distribution install time. For Debian, you can also log on as root. So the Untangle Gateway Lite, Untangle install script doesn't change the login system. You'll need to login after rebooting if you need to launch the administration client. Note that the virtual machine (untangle-vm) runs even if you never log on.
Note: Be aware that Untangle Server is designed for deployment on network gateways, where logins to the system are restricted to only authorized users. Do not give untrusted users accounts on the system.
Supported Linux Distributions
Untangle supports the Untangle Server on the following Linux distributions:
- Debian (Etch 4.0) or
- Ubuntu
Known Issues
Description: Upgrading to a newer upstream kernel may cause the system to no longer run the Untangle tested kernel.
Workaround: After upgraded edit /boot/grub/menu.lst to use the Untangle kernel.
Description: Email configuration tab is greyed out
Workaround: This is because the email relay setup is handled by the OS (Debian/Ubuntu) - typically this is done via exim and can be reconfigured using 'dpkg-reconfigure exim4-config'
(Etch) Non-Free Distribution Required
Description: An Etch bug requires that you have a non-free distribution. If you don't, the install script will fail quite early complaining that packages cannot be found.
Workaround: Before running the install script on etch, edit /etc/apt/sources.list. Add contrib and non-free to the first two lines, and non-free to the second two lines. Server names can vary, but here's an example:
Before:
deb http://mirrors.kernel.org/debian/ etch main
deb-src http://mirrors.kernel.org/debian/ etch main
deb http://security.debian.org/ etch/updates main contrib
deb-src http://security.debian.org/ etch/updates main contrib
After:
deb http://mirrors.kernel.org/debian/ etch main contrib non-free
deb-src http://mirrors.kernel.org/debian/ etch main contrib non-free
deb http://security.debian.org/ etch/updates main contrib non-free
deb-src http://security.debian.org/ etch/updates main contrib non-free
(Hardy) Monitor Resolution Limited to 800 x 600
Description: When you install Untangle Server in a virtual machine (VMWare guest), and proceed to use the Untangle Setup Wizard to configure your Untangle Server, the wizard's text boxes don't display properly, preventing you from using the wizard. This problem is the result of Ubuntu bug #172821, which causes screen resolution to be limited to 800 x 600.
Workaround: You have two options:
- Manually increase the resolution.
Figure, Using Desktop Manager to Increase Monitor Resolution
- Edit the Monitor section of /etc/X11/xorg.conf, adding the following lines:
VertRefresh 50.0 - 60.0
(Gutsy/Etch) Must Answer X11 Resolution Question
Description: Untangle Gateway Lite needs to pre-configure X11. There is an upstream bug that prevents full pre-configuration of X11, even when you run the Untangle install script with -y option.
Workaround: Answer yes to the X resolution question.
(Hardy) Network Manager Removal Returns Error
Description: During installation on a Linux system with a pre-existing desktop, Untangle install script removes Network Manager. During this process, an error is returned. There is a minor upstream bug that produces this error.
Workaround: Simply ignore the message.
Installing Untangle for Ubuntu (...and Debian!)
This installation runs for one hour and has a few interactive prompts, so consider using the shortcut installation below. Also, you can run the Untangle install script more than once if necessary. All install actions are idempotent, so if you need to quit the install—no problem. The results will be unchanged.
For the impatient:
- From your existing Linux system:
- Run the Untangle install script:
$ wget http://www.untangle.com/download/install52.sh
$ sudo bash install52.sh -y
The -y option tells the install script not to ask for confirmations, but to just do the install. If you run without the -y option, answer yes to all questions asked during the install.
For the meticulous:
- Verify that you meet all CPU and memory requirements. These requirements are the same regardless of the Untangle Server platform. Go to Hardware Requirements.
- (Recommended) Install a fresh base supported Linux distribution, and select the default Linux install options.
- (Ubuntu Server Edition) Install your favorite desktop manager. Ubuntu Server Edition does not install a desktop. If you install Ubuntu Server Edition, the Untangle install script automatically installs a lightweight desktop manager.
- Update your Linux system by doing one of the following:
- Use Synaptic, the visual package manager.
- Use a command line (Terminal Window):
- Get Untangle install script by doing one of the following:
- (Easiest!) Directly from your Linux system:
- Click here to download the Untangle install script (install52.sh), then transfer the Untangle install script to the system using SCP, or a USB key. Also, install the SCP packages on your Linux system, if you haven't already:
- If you want to install the server:
- If you don't want the server running, only the client:
- Determine if you need to perform any workarounds in advance of running the Untangle install script. Browse Known Issues.
- Run the Untangle install script, by doing one of the following:
- If you want to see the install step-by-step, run the following command, then answer yes to all questions asked during the install:
- If you do not want the install script to prompt you for confirmations, run the command with the -y:
- Downloads a library key from Untangle
- Adds Untangle package server to system's configured package servers (/etc/apt/sources.list.d)
- Installs the untangle package server key into the system.
- Verify that Untangle Server is the first kernel in the list of kernels:
- If Untangle Server is the first kernel in the list, then reboot your system to boot the Untangle kernel:
- If Untangle Server isn't the first kernel in the list, adjust the default line in the /boot/grub/menu.lst file, then reboot your system to boot the Untangle kernel.
Fluxbox:
$ sudo apt-get install fluxbox x-window-system-core xdm
Default GNOME desktop:
$ sudo apt-get install ubuntu-desktop
$ sudo apt-get install gdm
$ sudo /etc/init.d/gdm start
(Optional) $ sudo dpkg-reconfigure xserver-xorg
$ sudo apt-get update;sudo apt-get dist-upgrade
$ wget http://www.untangle.com/download/install52.sh
$ sudo apt-get install ssh
$ sudo apt-get install openssh-client
Note: After installing the ssh package, you might need to use the rehash command, or log in again so that your shell recognizes the newly installed scp binary.
$ sudo bash install52.sh
$ sudo bash install52.sh -y
Figure, Activation Key & Untangle Package ServerIdentifies what's already on your Linux system to determine what additional packages need to be installed (for example, desktop). 
Figure, Booting into Untangle KernelAutomatically pre-configures packages (for example, ddclient, slapd) that are managed by Untangle Server. 
Figure, Preconfiguring SLAPD
Figure, Preconfiguring DCLIENTAdds all additional packages, the Untangle Linux kernel, and the Untangle light gateway itself (untangle-gateway-light) are downloaded and installed. 
Figure, Downloading Untangle Packages
Figure, Adding Untangle Packages
Figure, Installing Untangle VMCongratulations! You successfully installed Untangle Gateway Lite 
Figure, Successful Install
$ vi /boot/grub/menu.lst
Linux keeps a list of kernels that it can boot. Linux is normally configured to boot the first kernel on its list. In most cases, Untangle Server is the first kernel on the list, so a simple reboot works fine. However, it is possible that the Untangle kernel is not the first kernel on the list, and so won't be automatically selected at boot time.
$ sudo reboot
Figure, Verifying Kernel List
Configuring Untangle Gateway Lite
- Log on to your Linux system—soon to be your Untangle Server, if you aren't already logged on.
- Launch the Untangle Client. The first time that you launch the Untangle Client the Setup Wizard appears.
- Follow the Setup Wizard's on-screen instructions to configure your Untangle Server.
- Add Software products. Go to Choosing Which Products To Install.
Note: Since your system already had network settings and a name, the Setup Wizard automatically displays this information. Simply click Next to approve. You can also adjust the values as needed.
Administering Untangle for Ubuntu
Launching Untangle Client from Untangle for Ubuntu
- Log on to your Linux system.
- Do one of the following to launch the setup wizard:
- (If Your Didn't Have a Desktop Manager) Right-click on the desktop manager background and select Network > Untangle Gateway Administration.
- (If You Had a Desktop Manager) Click on the Untangle client in the Applications menu.
Figure, Launching Untangle Gateway Admin GUI
Figure, Launching Untangle Client from Command Line
Launching Terminal Window from Default Desktop
To launch a terminal window:
From the default Desktop Manager, right-click on the desktop manager background and select Accessories > Terminal.
Shutting Down/Rebooting Untangle for Ubuntu
To shut down:
Do one of the following:
- (From Default Desktop) Right-click on desktop:
Figure, Shutting Down Untangle Gateway Lite from Default Desktop
- (From Terminal Window: Run the following command:
To reboot:
Do one of the following:
- (From Default Desktop) Right-click on desktop:
Figure, Rebooting Untangle Gateway Lite from Default Desktop
- (From Terminal Window) Run the following command:
Backing Up Untangle for Ubuntu Configuration
Unlike with Untangle Gateway, Untangle Gateway Lite doesn't provide console-based recovery tools (untangle-restore-tools) for recovery of the system. In the light install, most of these tools (returning to factory defaults, for example) do not exist.
However, the Untangle Gateway Lite provides an on-system backup & restore utility. Also, backup and restore are still available off-system from the regular administration client.
To backup all Untangle settings to the local hard drive:
& sudo /usr/share/untangle/bin/backup-ut /usr/share/untangle/dump
To backup all Untangle settings to a local drive, mounted in /media/flashdrive:
& sudo /usr/share/untangle/bin/backup-ut /media/flashdrive
Upgrading Your Untangle for Ubuntu Instance
With Untangle Gateway Lite, Untangle Server is being installed on an existing system, and the selected package servers (called software sources on Ubuntu) include both the Untangle Server and the original distribution (Ubuntu or Debian) servers. So Untangle Server's automatic upgrade mechanism, which can ask no questions of the user, is not appropriate.
Automatic upgrading is initially turned off for Untangle Gateway Lite, and Untangle does not recommend turning it on. Instead, upgrade your Untangle Server using your usual distribution upgrade method, usually the Upgrade manager or the Synaptic package manager. When upgrading, there are two simple rules to remember:
- A non-Untangle package has a package name that does not start with untangle. When upgrading a non-Untangle package, answer n (the default) if the manager asks about a configuration file modified by Untangle.
- An Untangle package has a package name that starts with untangle. When upgrading an Untangle package, answer y (allow new Untangle package to replace the configuration file) if the manager asks about a configuration file not modified by Untangle.
