Product Documentation

Connecting with the NetScaler Gateway Plug-in for Java

The NetScaler Gateway Plug-in for Java can be used on any user device that supports Java.

Note: Java Runtime Environment (JRE) Version 1.4.2 up to the most recent version of JRE is required for the following operating systems and web browsers.

  • Mac OS X
  • Linux
  • Windows XP (all versions), Windows Vista, Windows 7, and Windows 8
  • Internet Explorer
  • Firefox
  • Safari 1.2 up to the most recent version of the web browser

The NetScaler Gateway Plug-in for Java supports most TCP-based applications, but provides only some of the features of the NetScaler Gateway Plug-in for Windows or NetScaler Gateway Plug-in for Mac OS X.

Users do not require administrative privileges on the user device to use the NetScaler Gateway Plug-in for Java. For security reasons, you might want to require using this plug-in version for a particular virtual server, group, or user, regardless of which user device is used.

To configure NetScaler Gateway to install the NetScaler Gateway Plug-in for Java on user devices, configure a session policy and then bind it to the virtual server, group, or user.

If users log on from a computer running Windows 7, the proxy server information is not set automatically in Internet Explorer. Users must manually configure the proxy server on the computer running Windows 7.

To configure the NetScaler Gateway Plug-in for Java

  1. In the configuration utility, on the Configuration tab, in the navigation pane, expand NetScaler Gateway > Policies and then click Session.
  2. In the details pane, click the Profiles tab.
  3. Select a session profile and then click Open.
  4. On the Client Experience tab, next to Plug-in Type, click Override Global, select Java and then click OK.

To set the interception mode

After creating the session policy, create an intranet application to define the interception mode for users who log on with the NetScaler Gateway Plug-in for Java.

  1. In the configuration utility, on the Configuration tab, in the navigation pane, expand NetScaler Gateway > Resources and then click Intranet Applications.
  2. In the details pane, click Add.
  3. In Name, type a name.
  4. Click Proxy.
  5. In Destination IP Address, type the IP address.
  6. In Destination Port, type the port number.
  7. In Source IP Address, type the IP address.
  8. In Source Port, type the port number, click Create and then click Close.

If you do not specify a source IP address and port number, NetScaler Gateway automatically uses 127.0.0.1 for the IP address and 0 for the port.

Updating the HOSTS File on Windows-Based Computers

When users log on using the NetScaler Gateway Plug-in for Java on a computer running Windows Vista, Windows 7, or Windows 8, network traffic for TCP intranet applications is not tunneled. The HOSTS file is not updated automatically on computers running Vista and Windows 7. You must add the intranet applications manually to the HOSTS file.

On a Windows-based computer, you can edit the HOSTS file in Notepad or another text editor. If you edit the HOSTS file in Notepad, you must run Notepad as an administrator. Add the mapping entries for the intranet application for the NetScaler Gateway Plug-in for Java and then save the file.

Connecting with the NetScaler Gateway Plug-in for Java