Using NetExtender

NetExtender is an SSL VPN client for Windows, Mac, or Linux users that is downloaded transparently and that allows you to run any application securely on you company’s network. Using Point-to-Point Protocol (PPP), NetExtender allows remote clients seamless access to resources on your local network. Users can access NetExtender two ways:

Topics:

User Prerequisites

Prerequisites for Windows Clients:

Windows clients must meet the following prerequisites in order to use NetExtender:

Prerequisites for MacOS Clients:

MacOS clients meet the following prerequisites in order to use NetExtender:

Prerequisites for Linux Clients:

Linux clients must meet the following prerequisites in order to use NetExtender:

User Configuration Tasks

SonicWALL NetExtender is a software application that enables remote users to securely connect to the remote network. With NetExtender, remote users can virtually join the remote network. Users can mount network drives, upload and download files, and access resources in the same way as if they were on the local network.

 

Table 143. Installation and usage instructions by platform

Platform

Sections

Windows

MacOS

Linux

Installing NetExtender Using the Mozilla Firefox Browser
To use NetExtender for the first time using the Mozilla Firefox browser, perform the following:
1
2
Click the NetExtender button.

3
4
The Allowed Sites - Software Installation dialog is displayed, with the address of the Virtual Office server in the address field. Click Allow to allow Virtual Office to install NetExtender, and click Close.

5
Return to the Virtual Office dialog and click NetExtender again.
6
The Software Installation dialog is displayed. After a five second countdown, the Install Now button becomes active. Click it.
7

8
When NetExtender completes installing, the NetExtender Status dialog displays, indicating that NetExtender successfully connected.

Closing the dialog (clicking on the x icon in the upper right corner of the window) does not close the NetExtender session, but minimizes it to the system tray for continued operation.

9
 

Table 144. NetExtender status window

Field

Description

Status

Indicates what operating state the NetExtender client is in, either Connected or Disconnected.

Server

Indicates the name of the server to which the NetExtender client is connected.

Client IP

Indicates the IP address assigned to the NetExtender client.

Sent

Indicates the amount of traffic the NetExtender client has transmitted since initial connection.

Received

Indicates the amount of traffic the NetExtender client has received since initial connection.

Duration

The amount of time the NetExtender has been connected, expressed as days, hours, minutes, and seconds.

10

11
Installing NetExtender Using the Internet Explorer Browser

SonicWALL SSL VPN NetExtender is fully compatible with Microsoft Windows Vista 32-bit and 64-bit, and supports the same functionality as with other Windows operating systems.

Internet Explorer Prerequisites

It is recommended that you add the URL or domain name of your firewall to Internet Explorer’s trusted sites list. This will simplify the process of installing NetExtender and logging in, by reducing the number of security warnings you will receive.

To add a site to Internet Explorer’s trusted sites list, complete the following procedure:
1
In Internet Explorer, go to Tools > Internet Options.
2
Click on the Security tab.
3
Click on the Trusted Sites icon and click on the Sites... button to open the Trusted sites window.

4
Enter the URL or domain name of your firewall in the Add this Web site to the zone field and click Add.
5
Click OK in the Trusted Sites and Internet Options windows.
Installing NetExtender from Internet Explorer
To install and launch NetExtender for the first time using the Internet Explorer browser, perform the following:
1
2
Click the NetExtender button.

3

4
Click Instructions to add SSL VPN server address into trusted sites for help.

5
In Internet Explorer, go to Tools > Internet Options.
6
Click on the Security tab.
7
Click on the Trusted Sites icon and click on the Sites... button to open the Trusted sites window.

8
Enter the URL or domain name of your firewall in the Add this Web site to the zone field and click Add.
9
Click OK in the Trusted Sites and Internet Options windows.
10
Return to the SSL VPN portal and click on the NetExtender button. The portal will automatically install the NetExtender stand-alone application on your computer. The NetExtender installer window opens.

11
12
If a warning message that NetExtender has not passed Windows Logo testing is displayed, click Continue Anyway. SonicWALL testing has verified that NetExtender is fully compatible with Windows Vista, XP, 2000, and 2003 and later.

13
When NetExtender completes installing, the NetExtender Status window displays, indicating that NetExtender successfully connected.

Launching NetExtender Directly from Your Computer

After the first access and installation of NetExtender, you can launch NetExtender directly from your computer without first navigating to the SSL VPN portal.

To launch NetExtender, complete the following procedure:
1
Navigate to Start > All Programs.
2
Select SSL VPN NetExtender folder, and then click on SonicWALL SSL VPN NetExtender. The NetExtender login window is displayed.
3
The IP address of the last server you connected to is displayed in the SSL VPN Server field. To display a list of recent servers you have connected to, click on the arrow.

4
5
6
Configuring NetExtender Preferences

Complete the following procedure to configure NetExtender preferences:

1
2
Click on Preferences... The NetExtender Preferences dialog displays.
3
The Connection Profiles tab displays the SSL VPN connection profiles you have used, including the IP address of the server, the domain, and the username.

4
To delete a profile, highlight it by clicking on it and then click the Remove buttons. Click the Remove All buttons to delete all connection profiles.
5
The Settings tab allows you to customize the behavior of NetExtender.

6
To have NetExtender automatically connect when you start your computer, check the Automatically connect with Connection Profile checkbox and select the appropriate connection profile from the drop-down menu.
7
To have NetExtender launch when you log in to your computer, check the Automatically start NetExtender UI. NetExtender will start, but will only be displayed in the system tray. To have the NetExtender log-in window display, check the Display NetExtender UI checkbox.
8
Select Minimize to the tray icon when NetExtender window is closed to have the NetExtender icon display in the system tray. If this option is not checked, you will only be able to access the NetExtender UI through Window’s program menu.
9
10
Select Automatically reconnect when the connection is terminated to have NetExtender attempt to reconnect when it loses connection.
11
Select Uninstall NetExtender automatically to have NetExtender uninstall every time you end a session.
12
Select Disconnect an active connection to have NetExtender log out of all of your SSL VPN sessions when you exit a NetExtender session
13
Click Apply.
Configuring NetExtender Connection Scripts

SonicWALL SSL VPN provides users with the ability to run batch file scripts when NetExtender connects and disconnects. The scripts can be used to map or disconnect network drives and printers, launch applications, or open files or websites.

To configure NetExtender Connection Scripts, perform the following tasks.
1
Right click on the NetExtender icon in the task bar and click on Preferences... The NetExtender Preferences dialog displays.
2
Click on Connection Scripts.

3
To enable the domain login script, select the Attempt to execute domain login script checkbox. When enabled, NetExtender attempts to contact the domain controller and execute the login script.
4
To enable the script that runs when NetExtender connects, select the Automatically execute the batch file “NxConnect.bat” checkbox.
5
To enable the script that runs when NetExtender disconnects, select the Automatically execute the batch file “NxDisconnect.bat” checkbox.
6
To hide either of the console windows, select the appropriate Hide the console window checkbox. If this checkbox is not selected, the DOS console window will remain open while the script runs.
7
Click Apply.
Configuring Batch File Commands

NetExtender Connection Scripts can support any valid batch file commands. For more information on batch files, see the following Wikipedia entry: http://en.wikipedia.org/wiki/.bat. The following tasks provide an introduction to some commonly used batch file commands.

To configure the script that runs when NetExtender connects, click the Edit “NxConnect.bat” button. The NxConnect.bat file is displayed.
To configure the script that runs when NetExtender disconnects, click the Edit “NxDisconnect.bat” button. The NxConnect.bat file is displayed.
8
By default, the NxConnect.bat file contains examples of commands that can be configured, but no actual commands. Too add commands, scroll to the bottom of the file.

To map a network drive, enter a command in the following format:

net use drive-letter\\server\share password /user:Domain\name

For example to if the drive letter is z, the server name is engineering, the share is docs, the password is 1234, the user’s domain is eng and the username is admin, the command would be the following:

net use z\\engineering\docs 1234 /user:eng\admin

net use drive-letter: /delete

For example, to disconnect network drive z, enter the following command:

net use z: /delete

net use LPT1 \\ServerName\PrinterName /user:Domain\name

For example, if the server name is engineering, the printer name is color-print1, the domain name is eng, and the username is admin, the command would be the following:

net use LPT1 \\engineering\color-print1 /user:eng\admin

net use LPT1 /delete

C:\Path-to-Application\Application.exe

9

C:\Program Files\Microsoft Office\OFFICE11\outlook.exe

start http://www.website.com

C:\Path-to-file\myFile.doc

When you have finished editing the scripts, save the file and close it.

Configuring Proxy Settings

SonicWALL SSL VPN supports NetExtender sessions using proxy configurations. Currently, only HTTPS proxy is supported. When launching NetExtender from the web portal, if your browser is already configured for proxy access, NetExtender automatically inherits the proxy settings.

To manually configure NetExtender proxy settings, perform the following tasks.
1
Right click on the NetExtender icon in the task bar,
2
Click Preferences... The NetExtender Preferences dialog displays.
3
Click Proxy.

4
Select the Enable proxy settings checkbox.
5
Automatically detect settings - To use this setting, the proxy server must support Web Proxy Auto Discovery Protocol (WPAD)), which can push the proxy settings script to the client automatically.
Use automatic configuration script - If you know the location of the proxy settings script, select this option and enter the URL of the scrip in the Address field.
Use proxy server - Select this option to enter the Address and Port of the proxy server. Optionally, you can enter an IP address or domain in the BypassProxy field to allow direct connections to those addresses that bypass the proxy server. If required, enter a User name and Password for the proxy server. If the proxy server requires a username and password, but you do not specify them in the Preferences window, a NetExtender pop-up window will prompt you to enter them when you first connect.

6
Click the Internet Explorer proxy settings button to open Internet Explorer’s proxy settings.
Viewing the NetExtender Log

The NetExtender log displays information on NetExtender session events. The log is a file named NetExtender.dbg. It is stored in the directory: C:\Program Files\SonicWALL\SSL VPN\NetExtender. To view the NetExtender log, right click on the NetExtender icon in the system tray, and click View Log.

To view details of a log message, double-click on a log entry, or go to View > Log Detail to open the Log Detail pane.

To save the log, either click the Export icon or go to Log > Export.

To filter the log to display entries from a specific duration of time, go to the Filter menu and select the cutoff threshold.

To filter the log by type of entry, go to Filter > Level and select one of the level categories. The available options are Fatal, Error, Warning, and Info, in descending order of severity. The log displays all entries that match or exceed the severity level. For example, when selecting the Error level, the log displays all Error and Fatal entries, but not Warning or Info entries.

To view the Debug Log, either click the Debug Log icon or go to Log > Debug Log.

To clear the log, click on Log > Clear Log.

Disconnecting NetExtender
To disconnect NetExtender, perform the following steps:
1
2

You can also disconnect by double clicking on the NetExtender icon to open the NetExtender window and then clicking the Disconnect button.

When NetExtender becomes disconnected, the NetExtender window displays and gives you the option to either Reconnect or Close NetExtender.

Upgrading NetExtender

NetExtender can be configured by the administrator to automatically notify users when an updated version of NetExtender is available. Users are prompted to click OK and NetExtender downloads and installs the update from the firewall.

If auto-update notification is not configured, users should periodically launch NetExtender from the Virtual Office to ensure they have the latest version. Check with your administrator to determine if you need to manually check for updates.

Uninstalling NetExtender

The NetExtender utility is automatically installed on your computer. To remove NetExtender, click on Start > All Programs, click on SonicWALL SSL VPN NetExtender, and then click on Uninstall.

You can also configure NetExtender to automatically uninstall when your session is disconnected. To do so, perform the following steps:

1
Right click on the NetExtender icon in the system tray and click on Preferences... The NetExtender Preferences window is displayed.
2
Click on the Settings tab.
3
Select Uninstall NetExtender automatically to have NetExtender uninstall every time you end a session.
Verifying NetExtender Operation from the System Tray

To view options in the NetExtender system tray, right click on the NetExtender icon in the system tray. The following are some tasks you can perform with the system tray.

Displaying Route Information

To display the routes that NetExtender has installed on your system, click the Route Information option in the system tray menu. The system tray menu displays the default route and the associated subnet mask.

Displaying Connection Information

You can display connection information by mousing over the NetExtender icon in the system tray.

Installing NetExtender on MacOS

SonicWALL SSL VPN supports NetExtender on MacOS. To use NetExtender on your MacOS system, your system must meet the following prerequisites:

To install NetExtender on your MacOS system, perform the following tasks:
1
2
Click the NetExtender button.
3

4

5

Using NetExtender on MacOS
1
To launch NetExtender, go the Applications folder in the Finder and double click on NetExtender.app.

2
3
4
5
Click Connect.
6
You can instruct NetExtender remember your profile server name in the future. In the Save profile drop-down menu you can select Save name and password (if allowed), Save username only (if allowed), or Do not save profile.
7

8
9

10

11

12
Click Save to save the diagnostic report using the default nxdiag.txt file name in your NetExtender directory.
Installing and Using NetExtender on Linux

SonicWALL SSL VPN supports NetExtender on Linux. To use NetExtender on your Linux system, your system must meet the following prerequisites:

To install NetExtender on your Linux system, perform the following tasks:
1
2
Click the NetExtender button. A pop-up window indicates that you have chosen to open the NetExtender.tgz file. Click OK to save it to your default download directory.

3
To install NetExtender from the CLI, navigate to the directory where you saved NetExtender.tgz and enter the tar -zxf NetExtender.tgz command.

4
Type the cd netExtenderClient command.
5
Type ./install to install NetExtender.
6
Launch the NetExtender.tgz file and follow the instructions in the NetExtender installer. The new netExtender directory contains a NetExtender shortcut that can be dragged to your desktop or toolbar.

7
The first time you connect, you must enter the server name or IP address in the SSL VPN Server field. NetExtender will remember the server name in the future.

8
9
The first time you connect, you must enter the domain name. NetExtender will remember the domain name in the future.
10
To view the NetExtender routes, go to the NetExtender menu and select Routes.

11

12

13
Click Save to save the diagnostic report using the default nxdiag.txt file name in your NetExtender directory.