Version 2.

Users Guide for the AT&T Global Network Client for Linux
The AT&T Global Network Client is a program that enables users to easily and securely connect their Linux computers to their companys private network. The program creates an encrypted SSL connection to an AT&T-managed VPN server over any Internet connection. The program also provides a number of other benefits: Connects through a proxy Provides both a graphical user interface (GUI) and an API for connecting Provides service-level reporting Provides enhanced trouble-shooting aids

System Requirements and Installation

The AT&T Global Network Client is supported on the following Linux distributions:
Red Hat Enterprise Linux 4 and 5 SUSE 10

The program is installed from a single RPM file. It must be installed as root (it does not require root authority to run). The majority of the files are installed to the /opt/agns directory. An icon launcher to start the GNOME GUI program is installed in the application, network category (typically Applications > Internet > AT&T Global Network Client). The program can be downloaded from: http://www.attnetclient.com/linux/cfu/

Using the Graphical User Interface

The AT&T Global Network Client GUI is started by clicking the installed launcher or by starting /opt/agns/bin/agnclient. To connect to your private network click the green Connect button and enter your credentials. After connecting, the main window shows the connection status. If your Internet connection is through a proxy, you should enter the proxy information into AT&T Global Network Client before connecting. To enter proxy information, click the proxy hyperlink which is just to the left of the Connect button on the main window. While connected you may leave the AT&T Global Network Client window visible, minimize it, or close it. If you close the window while the VPN is connected, you will be prompted to disconnect the VPN or leave it connected. (Since the VPN connection is maintained by a background program that is separate from the GUI program, you can close the main window and leave the VPN connected.) If you close the window and leave the VPN connected, you can restart the GUI program at any time to check the VPN connection status or disconnect.
2007 AT&T, All Rights Reserved.

Page 1

Users Guide for the AT&T Global Network Client for Linux

Version 2.0

Advanced Connections without using the GUI

The AT&T Global Network Client is designed with an API that allows user-level programs to initiate VPN connections. The GUI program (agnclient) is an example of such a program. The core of the AT&T Global Network Client is the agnclientd daemon. The API is defined in agnc.h and implemented in the shared library libagnc.so as shown in the following diagram.

The API is implemented in C. The header file agnc.h is installed in the /opt/agns/include directory. Sample source code for using the API is installed in the /opt/agns/src directory. A typical use of the API involves calls such as:
1. 2. 3. 4. 5. 6. agncOpen(); agncPostActionRequest( connect ); agncGetState(); agncGetConnectAttemptInfo(); agncPostActionRequest( disconnect ); agncClose();

An alternative to agnclient for command line interface (no GUI) users, NetVPN.sh, a shell script found in /opt/agns/bin, implements a simple client using the API via the binary /opt/agns/bin/vpnCLI. The user copies the NetVPN.sh file into a convenient location, edits the top portion of the file, defining settings appropriate for their account, and starts the VPN connection process by running the script either in the foreground or background. To disconnect, the user simply kills the script process (presses Control-C if running in the foreground). The command line interface for the client allows a user to connect server systems to the VPN and automate the connection process to start at boot time via an init script. Most users will use the standard agnclient GUI interface, however, and the script is intended for advanced users with the ability to navigate the Unix filesystem and edit files.

Support and Troubleshooting

The AT&T Global Network Client contains extensive problem determination tools and logging. To get help click Contact customer support on the main window. A support log (support.htm) can be generated by clicking Create support log on the customer support window. The support log contains detailed logging information that is useful for diagnosing problems.

2007 AT&T, All Rights Reserved

Page 2