The Basics
From UntangleWiki
Logging On To Untangle Server
- From Untangle for Ubuntu and Debian
- From Untangle for Windows
- From Untangle Virtual Appliance
- From Untangle Server XDs or Untangle Server ISO Image
Once you set up and configure the Untangle Server using the Installation Wizard, you can administer the Untangle Server from the Untangle Client. You can log on to the Untangle Server using one of two methods, but how you do it depends on your installation type:
- Connect directly using a monitor, keyboard, and mouse.
- Connect remotely using a browser.
From Untangle for Ubuntu and Debian
To launch the Untangle Client when directly attached:
- 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.
Launching Untangle Gateway Admin GUI
Launching Untangle Client from Command Line
From Untangle for Windows
To launch the Untangle Client from the desktop:
- From the desktop on which the Untangle Server is installed, double-click on the Untangle Admin Client icon. The Untangle Client Launcher launches in your browser.
- Type your username and password, and click the Login button. During initial installation of your Untangle Server, you set the username and password through the Untangle for Windows Setup Wizard. The Untangle Client launches.
From Untangle Virtual Appliance
From Untangle Server XDs or Untangle Server ISO Image
To launch the Untangle Client when directly attached:
Before You Begin: Ensure that the Untangle Server is turned on.
- Connect a monitor, keyboard, and mouse to the Untangle Server. Your monitor displays the Untangle logo and navigation bar.
- In the Navigation bar, click the Untangle Client button. The Untangle Client launches. If you have an Untangle for Ubuntu and Debian, go to Launching Untangle Client from Untangle for Ubuntu and Debian to determine how to launch the client.
- Type your username and password, and click the Login button. During initial installation of your Untangle Server, you set the username and password through the Installation Wizard. The Untangle Client launches.
To launch the Untangle Client from a browser:
Unless you have remote access enabled, you cannot log on from outside the protected network. You must first log on from within the protected network, then enable remote access.
Before You Begin: Ensure that the Untangle Server is turned on.
- Do one of the following:
- (Remote Logon) In your browser, type https:// followed by the External IP address of the Untangle Server, port number (default is 443). For example: https://72.14.207.1:443.
- (Local Logon) In your browser, type http://localhost/webui or type http:// followed by the Internal IP address of your Untangle Server. For example: http://198.168.1.1
- If you receive a warning, dismiss it as you are safe connecting to the Untangle Server.
- When prompted, provide a username and password to log on. During initial installation of your Untangle Server, you set the username and password through the Installation Wizard. The Untangle Client launches.
Note: You might receive a warning from your web browser regarding certificates.
Next Step: If you want to enable remote access so that you can log on to Untangle Server from outside the protected network, go to Enabling Remote Access To Untangle Server.
Restarting Untangle Server
If you have an Untangle Gateway Lite, go to Shutting Down/Rebooting Untangle Gateway Lite.
You can restart or reboot the Untangle Server without physical access to the system.
To reboot the Untangle Server:
- From the Navigation Pane, click the Config tab > Remote Admin. The Remote Admin Config windows launches.
- Click the Manual Reboot tab, and click the Reboot Untangle Server button.
Powering Off Untangle Server
If you have an Untangle Gateway Lite, go to Shutting Down/Rebooting Untangle Gateway Lite.
Do not use the power button on the front of the Untangle Server or the emergency power switch on the back of the Untangle Server to power off the Untangle Server.
These methods do not provide the Untangle Server a graceful shutdown. Instead, use the Untangle Server's direct-connect interface. For security, you cannot shut down the Untangle Server remotely.
To power off the Untangle Server:
- Connect a monitor, keyboard, and mouse to the Untangle Server. Your monitor displays the Untangle logo and Navigation bar.
- In the Navigation bar, click the Shutdown button. The Untangle Server shuts down.
Turning On and Off Software Products
When you first install a Software Product, it is turned off.
To turn on and off a Software Product:
- Click the toggle button to either the ON state or OFF state.
- Verify the Software Product's status using the following indicators:
- Status indicator light. This indicator has four possible colors.
- Gray indicates a Product is off and ready to be turned on.
- Yellow means a product is changing from off to on (or vice versa).
- Green shows a Product is on and behaving normally, while
- Red warns a product is on but an abnormal condition has occurred.
- Activity Meter. Each Software Product has one or more Activity Meter. Activity meters provide a quick view into the activity of a Software Product, and change in real time as a given Software Product processes network traffic. If the Activity meter indicates activity, the Software Product is turned on. You can obtain more detailed activity data from the Event Logs.
Resetting Untangle Server To Factory Defaults
You might want to reset the Untangle Server to factory defaults if you experience problems with your configuration, or if you want to experiment with a different configurations. If you forgot your admin password, you can change that password without resetting the Untangle Server to factory defaults. Go to Resetting the Password for Administrator's Account.
To return to factory defaults:
Warning: This procedure erases all configuration information from the Untangle Server.
Before You Begin: Back up your configuration just in case you'd like to return to this configuration: Backing Up Untangle Server's Configuration.
- Using a keyboard, video and mouse, connect directly to the Untangle Server. When connected directly to the Untangle Server, a window with Untangle's logo appears.
- Click Recover Utilities. A confirmation window appears.
- Click Yes to continue with the reset. The next screen offers a few options.
- Select the Return To Factory Defaults menu option. The Return To Factory Defaults window appears.
- Select Yes to return to factory defaults. When you log on to the Untangle Server, you are prompted to use the Setup Wizard to configure your Untangle Server, just as you did when you installed the Untangle Server the first time using the Untangle Server Quick Start Guide.
Removing Software Products
If you want to remove a Software Product in order to troubleshoot, turn off the Software Product instead. Removing a Software Product from a rack does not unsubscribe you from that Software Product.
Remove the Software Product from the required virtual rack(s) by doing one of the following:
Note:
- If you want to remove a Services Software Product, remove the Software Product from any rack that contains the Software Product.
- If you want to remove a Non-Services Software Product, remove the Software Product from all virtual racks.
- From the Software Product's faceplace, Shift-click on the power toggle. The Software Product disappears from the virtual rack, and now appears in your My Apps.
- From the Software Product's faceplace, click the Show Settings button, and click Remove button. The Software Product disappears from the virtual rack, and now appears in your Apps.
Accessing Event Logs
Most Software Products have an Event Log as part of their controls. Event logs present a table of significant events that the Untangle Server observed.
Event logs contain the underlying data from which the Untangle Server generates Untangle Reports. However, there are a few differences. Event logs provide real-time information whereas Untangle Reports provide next-day and weekly information. Moreover, the event logs show activity by IP address; Untangle Reports are more user-friendly because they show activity by user.
- Sometimes the events provide a dialog of which traffic was filtered:
... examined this web request from 1.2.3.4 and found no viruses ...
- Other times, the events indicate malicious content which was stopped by the Software Product:
... blocked email with subject Urgent Business Request as it was found to be a phishing email ...
To access an Event Log:
- From the Software Product, click the Show Settings button.
- Click the Event Log tab.
- In the drop-down list, select the types of events that you want to view, and click the Refresh button. To view all events, select All Events.
Verifying if a Network Computer is Accessible
Using the ping command, you can determine if a specific system is accessible on the network and what its IP address is, if you only know its hostname.
To verify if a system is accessible on the network:
- Launch a command prompt: Start > Run.
- Type either the IP address or the hostname of the system that you want to contact, then Enter.
> ping <hostname> > ping <IPAddress>
- If you receive a message like the following, the system was accessible:
PING myhost.dnsdojo.net (198.144.196.51) total tx: 5, total time: 4016.0 ms, percent answered: 20% sequence: 5 ttl: 64, delay: 0.047 ms, size: 45 bytes
- If you provide an incorrect hostname or the DNS Server does not know that hostname, you receive a Unable to resolve the host message.
Related Topics
- Swapping Network Interfaces
- Adding Network Cards
- Removing Network Cards
- Changing Untangle Server's Timezone
- Updating Registration Information
- Modifying Data Transfer Mode
- Policy Management
