QuickStart Guide: Untangle for Windows

From UntangleWiki

Jump to: navigation, search

Contents

Why Untangle for Windows?

Using Untangle for Windows Re-RouterTM Technology (Untangle for Windows), you can run an Untangle Server on a Windows XP machine. With Untangle for Windows, the Untangle Server installs as a virtual machine on a Windows computer. You don't need to know what a virtual machine is—just that the computer can be a dual-purpose computer that's running Windows because the Untangle Server installs as a virtual machine. In other words, that computer can be both your Windows desktop, which you use for creating your presentations and emailing customers, and the Untangle Server. No dedicated hardware is required.

With Untangle for Windows, the Untangle Server does not need to deploy as either a router or bridge as is the case with other installations. Instead, simply deploy the Untangle Server as a Re-RouterTM. Re-RouterTM deployment is the easiest, fastest, and cheapest way to get an Untangle Server up and running. Why? Because:

In such a deployment, the Untangle Server truly becomes a plug-and-play device. Simply install the Untangle software on an existing PC or laptop that's running a supported operating system, give the Untangle Server an IP address and password, and watch it do its job.

Once Untangle for Windows is up and running, you can customize the pre-installed Software Products as you would any Untangle Server (see Untangle Server User's Guide).

How Does Untangle for Windows Work?

Untangle for Windows reroutes all inbound and outbound traffic (but not traffic between network clients) through the Untangle Server. With re-routing technology, Untangle for Windows pretends to be your existing router. Untangle for Windows is not the actual router, but all the clients on the network believe it is.

Each network client stores information about the router. Untangle for Windows simply tells these clients that it is the gateway for the network. As a result, all traffic goes through to the Untangle Server, delivering the complete benefits of the Untangle Server to you with no dedicated hardware and no network reconfiguration.

Basically, if your network were a school classroom, the network clients are the the students, and Untangle for Windows is a substitute teacher that replaces the permanent teacher. At anytime, you can specify that the permanent teacher take over: simply uninstall or shut down Untangle for Windows.

Requirements

Windows Platforms

  • Windows XP Home Edition
  • Windows XP Professional Edition

Network

  • Wired connection. Untangle for Windows requires a wired connection, as shown in Figure, Untangle Server as Re-RouterTM. You cannot deploy Untangle for Windows on a Windows XP computer that is connected to the network using a wireless network adapter. This limitation is related to how VMware Player bridges network adapters. However, you can have a wireless network and still have the Untangle Server protect that network.

CPU/Memory/Hard Drive

  • CPU: 1.0 Ghz
  • Memory: 1 GB
  • Hard Drive: 20 GB

Switches

Untangle for Windows cannot operate in a network that uses advanced smart switches. Smart switches prevent Untangle for Windows from re-routing traffic. Advanced smart switches can be very expensive ($700 US) relative to retail switches (for example, most NetGear switches aren't advanced). Most of the time small offices do not use smart switches, so if your company is small, you're probably safe in assuming that your network doesn't have a smart switch.

If your switch is on the following list, then it's a smart switch.

  • AT&T 2Wire 2700HG-B DSL Gateway
  • Catalyst 4500 Series
  • Catalyst 3750
  • Catalyst 3560
  • Linksys SPS224G4
  • Juniper EX 3200 24P

Deploying Untangle for Windows

Task Go to
1. Learn about Untangle for Windows. About Untangle for Windows
How Does Untangle for Windows Work?
2. Prepare to install. Preparing To Install Untangle for Windows
3. Install Untangle for Windows. Installing Untangle for Windows
4. Verify your installation. Verifying Your Untangle for Windows Installation

Preparing To Install Untangle for Windows

Although Untangle for Windows can run on a dual-purpose computer, don't use the desktop computer during installation. Of course, you can launch a browser and surf the web if you'd like, but don't do any important work. Let me explain. Toward the end of the installation Untangle for Windows needs to reboot the computer. If you haven't saved your data, you will lose it.

To prepare for your installation:

Before You Begin:

  1. Verify that your network is flat. Untangle for Windows only operates in a flat network. A flat network is one with a single private address range (examples are 10.0.0.x, 192.168.0.x, 172.16.0.x). A network with an embedded router is not flat.
  2. Verify that your network is supported. Refer to Figure, Untangle Server as Re-RouterTM.
  3. Choose the dual-purpose computer on which you want to run Untangle for Windows. You only need to install one Untangle for Windows environment on one desktop to protect your entire network: you cannot install two in your network.
    Warning: Choose a desktop that is always powered on and connected to the network. In other words, don't choose a computer that an employee needs for customer site visits. Consider using an existing print server, file server, or backup server.
  4. Verify that your computer meets all the Requirements. Remember, your deployment requires only one network card, unlike all other deployments. By the way, most of the memory isn't used by Untangle for Windows; rather, the virtualization software and Windows operating system consume most of the memory.
  5. Log on to the Windows computer on which you plan to install Untangle for Windows.
  6. On the computer that you chose, save and close all open applications. If you do not save and close open applications, Untangle for Windows will do so for you when it reboots after the install. You will lose data if you do not save your data now.
  7. Disable both standby and hibernate modes. These modes cause the computer to go to sleep. Untangle for Windows must be awake at all times, in order to process network traffic.
    1. Choose Start > Control.
    2. Double-click on the Power Options icon, then change as follows:
    3. Figure, Change Power Options
      Enlarge
      Figure, Change Power Options
  8. If the computer has a wireless network card, disable it. The Untangle Server must have a wired connection, not a wireless connection. It's easy to unintentionally use the wireless connection if the wireless network card is not disabled. To disable it:
    1. Choose Start > Control.
    2. Double-click on the Network Connections icon.
    3. Right-click on the Wireless Network Connection icon, and select Disable.

Installing Untangle for Windows

You only need to install one Untangle for Windows on your network to protect your entire network. An Untangle Server includes a Software Product for Anti-virus, along with several other Software Products that offer protection and security. If you purchased a product like Symantec Anti-Virus, you'd need to install this software on all desktops in your company—not with Untangle Server. You only need one Untangle Server on one desktop.

After you install Untangle for Windows, computers on the network will temporarily lose their network connections. Don't worry. This is a brief transition and only lasts 5 minutes.

To install Untangle for Windows:

Before You Begin: Preparing for your installation.

  1. Using a network cable, connect the Windows computer to the network. Untangle for Windows must have a wired connection, not a wireless connection.
    Figure, Untangle Server as a Re-RouterTM
    Figure, Untangle Server as a Re-RouterTM
  2. Log on to the Windows computer on which you want to install Untangle for Windows.
  3. From a browser, Download Untangle for Windows. The file is large, and takes about 30 minutes to download (on a broadband connection). Feel free to take a coffee break.
  4. Double-click on the .exe file that you just downloaded. The .exe file appears as an Untangle icon on your desktop.
    After a few minutes the installer finishes loading and the Untangle for Windows Setup Wizard launches.
  5. Click Next, complete the Registration, and click Next again.
  6. In the Administrative Settings window, specify your password, then click Next. This is the password for your Untangle Server. Keep this password secure and handy.
    Figure, Specify Admin Password
    Enlarge
    Figure, Specify Admin Password
  7. In the Network Settings window, choose your network settings, then click Next.
    If you choose to use a static IP address, you can be certain that the IP address that the installer pre-populates is good. The installer is clever in that it knows your network's current IP address range.
  8. Follow the remaining on-screen instructions to install the software. Accept all defaults. The actual install takes several minutes. Time for another coffee break! The system reboots after the installation completes.
  9. Verify the installation.

Verifying Your Installation

If you can connect to the Internet, if the Untangle Server is running, and if have an Untangle shortcut on your desktop, then you've successfully installed Untangle for Windows.

To verify your installation:

  1. Ensure that you can connect to the Internet.
    After you install Untangle for Windows, the computers on the network will temporarily lose their network connections. However, this is a brief transition. If it's been 5 minutes, you should be able to connect to the Internet.
  2. Check the status of Untangle for Windows. Right-click on the Untangle icon in the system tray.
    • If Untangle Server is working correctly, status indicates Running.
    • If Untangle software is still installing, status indicates Installing. The piece that takes the longest to install is the virtualization software (VMware Player), especially if you don't have a lot of computer memory.
    Figure, Verify Status of Untangle Server
    Enlarge
    Figure, Verify Status of Untangle Server
  3. Verify that a Launch Untangle Admin Client icon appears on your desktop.
  4. Launch the Untangle Client.

Working with Untangle for Windows

Logging on To Untangle for Windows

Launching Untangle Client from Untangle for Windows

Uninstalling Untangle for Windows

If you deployed Untangle for Windows as a way to evaluate/try the product in your production environment and now you want to deploy the Untangle Server as a router or a bridge, uninstall Untangle for Windows first. After you uninstall the Untangle Server, the network returns to normal within a few minutes.

To uninstall your installation:

  1. Back up your configuration. You can restore to a new Untangle Server using this configuration.
  2. Stop the virtual machine on which Untangle for Windows is running. Right-click on the Untangle icon in the system tray, select Stop, then Quit.
  3. Uninstall Untangle for Windows as you would any Windows application. Untangle for Windows consists of two parts. You must uninstall these parts in a specific order:
    1. Uninstall Untangle for Windows.
    2. Uninstall VMware Player.
    Figure, Uninstall Untangle for Windows
    Enlarge
    Figure, Uninstall Untangle for Windows

    Note: If you forget to stop the virtual machine on which Untangle for Windows is running, the following error message appears: Setup has detected VMware software running on the machine. Please power off or suspend all virtual machines and close all VMware applications before attempting to uninstall this product. In this case you, must go to Windows Task Manager, select the following processes, then click the End Process button to stop the virtual machine:

    • vmware-vmx.exe
    • vmnetdhcp.exe
    • vmplayer.exe
    • vmware-authd.exe
    • vmnat.exe
    • vmount2.exe

Shutting Down Untangle for Windows

If you need to troubleshoot something on your network, and you want to rule out Untangle for Windows as the cause of the problem, simply shut down Untangle for Windows. If you discover that Untangle for Windows was the problem, please let us know.

After you shut down Untangle for Windows, the network returns to normal within a few minutes. Your Untangle Server data is safe during a shutdown. All your Untangle Server data resides on the desktop until you uninstall.

To shut down Untangle for Windows:

  1. In the system tray, right-click on the Untangle icon.
  2. Click Stop.

Starting Untangle for Windows

If you need to troubleshoot something on your network, and you want to rule out Untangle for Windows as the cause of the problem, simply stop Untangle for Windows, then restart it. If you discover that Untangle for Windows was the problem, please let us know. After you start Untangle for Windows, the network returns to normal within a few minutes.

To start Untangle for Windows:

  1. In the system tray, right-click on the Untangle icon.
  2. Click Start.

Disconnecting Untangle for Windows

If you shut down Untangle for Windows, but the Untangle Server still seems to be routing traffic, you can disconnect Untangle for Windows.

The difference between disabling and disconnecting is that if you disconnect Untangle for Windows, that computer can't be used. This is okay because a disconnect is intended to be temporary. If you want to completely remove Untangle for Windows from your environment, uninstall it.

After you unplug the network cable from the computer running Untangle for Windows, the network returns to normal within a few minutes.

Figure, Disconnect Untangle for Windows
Figure, Disconnect Untangle for Windows

Troubleshooting Untangle for Windows Problems

Symptom What's this mean? What do I do?
Tried to launch the Untangle Client, but browser displays Failed to Connect error.

Untangle for Windows might not be running.

Start Untangle for Windows.

The Untangle for Windows icon is missing from my system tray.

In the system tray there are two options worth discussing: Stop and Quit. You might have selected Quit instead of Stop. Quit simply removes Untangle for Windows from your system tray.

To add the Untangle icon to your system tray, go to Start > Program Files > Untangle > Untangle.

The Untangle for Windows icon in my system tray indicates a status of Starting. Untangle for Windows has been in this state for over 10 minutes.

This is normal if you just finished an initial installation. Otherwise, it sounds like your Untangle Server cannot boot and is in an abnormal state.

Go to Start > Programs > VMware > VMware Console. Don't use this under any other conditions because this action results in an ungraceful shutdown. It will take several minutes before Untangle for Windows boots and indicates Running.

Personal tools