Quick Install Guide for Untangle for Ubuntu

http://wiki.untangle.com/index.php/Quick_Install_Guide_for_Untangle_for_Ubuntu

ไว้แปลในวันว่าง ๆ อิ อิ

From UntangleWiki

Jump to: navigation, search

Contents [hide] 1 What is Untangle for Ubuntu? 2 About Automatic Logon & Session Management 3 Supported Linux Distributions 4 Known Issues 4.1 (Etch) Non-Free Distribution Required 4.2 (Hardy) Monitor Resolution Limited to 800 x 600 4.3 (Gutsy/Etch) Must Answer X11 Resolution Question 4.4 (Hardy) Network Manager Removal Returns Error 5 Installing Untangle for Ubuntu (...and Debian!) 6 Configuring Untangle Gateway Lite 7 Administering Untangle for Ubuntu 7.1 Launching Untangle Client from Untangle for Ubuntu 7.2 Launching Terminal Window from Default Desktop 7.3 Shutting Down/Rebooting Untangle for Ubuntu 7.4 Backing Up Untangle for Ubuntu Configuration 7.5 Upgrading Your Untangle for Ubuntu Instance

[edit]

---

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: Launch button for the Untangle client. Recovery tools. Shutdown/restart/screensaver buttons. Figure, Untangle Kiosk	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. Figure, Untangle Gateway Lite Default Desktop	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. Untangle Server fits into the existing system, rather than owning it as the normal ISO install does. Supports your desktop manager of choice.

[edit]

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.

[edit]

Supported Linux Distributions

Untangle supports the Untangle Server on the following Linux distributions:

• Debian (Etch 4.0) or
• Ubuntu

• Gutsy 7.10
• Server Edition (Hardy) 8.04
• Desktop Edition (Hardy) 8.04

[edit]

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'

[edit]

(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

[edit]

(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.

Figure, Ubuntu Bug 172821

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:	HorizSync 31.5 - 50.0 VertRefresh 50.0 - 60.0

[edit]

(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.

[edit]

(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.

Figure, Network Manager Error

[edit]

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:

1. From your existing Linux system:

 $ wget http://www.untangle.com/download/install52.sh

2. Run the Untangle install script:

 $ 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:

1. Verify that you meet all CPU and memory requirements. These requirements are the same regardless of the Untangle Server platform. Go to Hardware Requirements.
2. (Recommended) Install a fresh base supported Linux distribution, and select the default Linux install options.
3. (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.

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



Figure, Ubuntu Desktop
4. Update your Linux system by doing one of the following:
• Use Synaptic, the visual package manager.
• Use a command line (Terminal Window):

 $ sudo apt-get update;sudo apt-get dist-upgrade

5. Get Untangle install script by doing one of the following:
• (Easiest!) Directly from your Linux system:

 $ wget http://www.untangle.com/download/install52.sh

• 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:

 $ sudo apt-get install ssh

• If you don't want the server running, only the client:

 $ 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.

6. Determine if you need to perform any workarounds in advance of running the Untangle install script. Browse Known Issues.
7. 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:

 $ sudo bash install52.sh

• If you do not want the install script to prompt you for confirmations, run the command with the -y:

 $ sudo bash install52.sh -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.	Figure, Activation Key & Untangle Package Server	Identifies what's already on your Linux system to determine what additional packages need to be installed (for example, desktop).	Figure, Booting into Untangle Kernel
Automatically pre-configures packages (for example, ddclient, slapd) that are managed by Untangle Server.	Figure, Preconfiguring SLAPD Figure, Preconfiguring DCLIENT	Adds 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 VM
Congratulations! You successfully installed Untangle Gateway Lite	Figure, Successful Install

8. Verify that Untangle Server is the first kernel in the list of kernels:

 $ 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.

• If Untangle Server is the first kernel in the list, then reboot your system to boot the Untangle kernel:

 $ sudo reboot

• 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.

Figure, Verifying Kernel List

Figure, Booting into Untangle Kernel

[edit]

Configuring Untangle Gateway Lite

1. Log on to your Linux system—soon to be your Untangle Server, if you aren't already logged on.
2. Launch the Untangle Client. The first time that you launch the Untangle Client the Setup Wizard appears.
3. Follow the Setup Wizard's on-screen instructions to configure your Untangle Server.

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.

4. Add Software products. Go to Choosing Which Products To Install.

[edit]

Administering Untangle for Ubuntu

[edit]

Launching Untangle Client from Untangle for Ubuntu

1. Log on to your Linux system.
2. 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

[edit]

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.

Figure, Launching Terminal Window

[edit]

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:	$ init -0

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:	$ reboot

[edit]

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

[edit]

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.