GO-Global Client Readme Version 3.1.1

Contents 1.   System Requirements 2.   Running the Windows Client 3.   Running the Netscape Plug-in 4.   Running the ActiveX Control  5.   Running the Java Client 6.   Running the Linux Client 7.   Running the Mac X11 Client 8.   Running the Windows CE Client 9.    Running the Solaris Client 10. General Notes

The Windows Client supports Windows 98/XP, Windows 2000, Windows Server 2003, and Windows NT 4.0.

The Windows CE Client supports Windows CE 4.2 or later on Mitsubishi's TX120 device and Mintwave's ACC-Lite and ACC-mini devices. SEH (the C++ Structured Exception Handling component) and RTTI (the Run-Time Type Information component) are
required to run GO-Global on a Windows CE device. To determine if these components exist on the device, open ceconfig.h found in the Windows folder. If the following lines: 
#define COREDLL_CRT_RTTI 1 
#define COREDLL_CRT_CPP_SEH 1 
are included in this file, RTTI and SEH are supported.

The Microsoft ActiveX Control supports Windows 98/XP, Windows 2000, Windows Server 2003, and Windows NT 4.0 with Internet Explorer 6.0.

The Linux Client supports but is not limited to the following Linux distributions: Red Hat Linux 7.3, 8, and 9; Red Hat Enterprise Linux WS 3; Mandrakelinux 10; Xandros Desktop 2; and Turbolinux Desktop 10.

The Mac X11 Client supports Mac OS X 10.3 with Apple's X11 library implementation.

The Netscape Plug-in for Windows supports Windows 98/XP, Windows 2000, Windows Server 2003, and Windows NT 4.0 with Netscape Navigator 7.2 and Mozilla Firefox 1.0 or later. 

The Netscape Plug-in for Linux supports but is not limited to the following distributions: Red Hat Linux 7.3, 8, and 9; Red Hat Enterprise Linux WS 3; Mandrake 10; Xandros 2; and Turbolinux 10 with Netscape Navigator 7.2 and Mozilla Firefox 1.0 or later.

The Java Client supports the following platforms: 
  •  Windows 98/XP, Windows 2000, Windows Server 2003, Windows NT 4.0 with Internet Explorer 6.0, Netscape Navigator 7.2, and Mozilla Firefox 1.0 or later.
  •  OS/2 with Netscape Navigator 4.61
  •  Macintosh 8.6 and 9 with Internet Explorer 5.1
  •  Red Hat Linux 7.3, 8, and 9; Red Hat Enterprise Linux WS 3; Mandrakelinux 10; Xandros Desktop 2; and Turbolinux Desktop 10 with Netscape Navigator 7.2 and Mozilla Firefox 1.0 or later. 

The Solaris Client supports Sun Solaris 8 or later on SPARC platforms.

Clients must have TCP/IP as a network protocol. 

Back to top

With the Windows Client, you can log on to a GO-Global Server from the Start menu or from a Windows shortcut. 

2.2   Running the Windows Client from the Start Menu
1.  Click the Start button on the Windows taskbar. 
2.  Click Programs | GraphOn GO-Global| GO-Global Client.
3.  Type your server address in the Connection dialog and click Connect. You can create a shortcut to the specified server by selecting the check box on the Connection dialog. Once the shortcut is set up, you will bypass the Connection dialog when connecting to the specified server. 
4.  When the Logon dialog appears, type the following information: 
    • Your network user name in the User name box. 
     • Your network password in the Password box. 

2.3   Running the Windows Client from a Shortcut 
A shortcut named GO-Global Client is created during installation of the Windows Client. This shortcut launches the Program Window. 
1.  Double-click the GO-Global Client icon. 
2.  Type your server address in the Connection dialog and click Connect. If you would like to create a shortcut to the specified server, select the check box. Once the shortcut is set up, you will bypass the Connection dialog when connecting to the specified server. 
3.  When the Logon dialog appears, type the following information: 
    • Your network user name in the User name box. 
    • Your network password in the Password box. 

2.4    Creating GO-Global Shortcuts
Additional shortcuts can be created for launching specific applications, among other options. 
1.  Right-click on the desktop. 
2.  Click New | Shortcut. 
3.  In the Create Shortcut dialog box, browse to the GO-Global Client Executable, e.g., \Program Files\GraphOn\GO-Global Client\ggw.exe. 
4.  Type a name for the shortcut and click Finish.

2.5    Using Command-line Arguments
For users running the Windows Client, command-line arguments can be used to make the logon process easier. Command-line arguments allow users to directly launch an application, among other options, as described below. 

1.  Right-click on the GO-Global shortcut and click Properties. 
2.  In the Shortcut tab, place your cursor in the Target edit box and append any of the following command-line arguments after the quote ("): 
 

-h	The GO-Global Server address or host name.
-u	The client's network user name.
-p	The client's network password.
-a	The display name of the application to be launched. The application's display name must be identical to the application name in the Program Window.
-r	Startup parameters for the application.
-c	Compression is enabled by default. To disable compression, remove -c from the command-line.
-ac	Determines how printers are initialized at startup. When -ac is followed by all, all client printers are automatically configured. When -ac is followed by none, client printers are not automatically configured. When -ac is followed by default only the default printer is configured automatically. This is the default setting.
-hp	Modifies the host port setting for the Application Publishing Service.

Example:...\ggw.exe" -h server -u username -p password -c  -ac all -hp 443

• Startup parameters passed on by the -r argument are specific to each application. Please refer to the application's documentation for information about launch parameters.

• Command-line arguments are optional and case-insensitive. Arguments can be appended in any order, with the exception of -r. If -r is used, it must be the last argument on the command-line and it must be used with the -a argument.

• In order to accommodate spaces in user names, passwords, or application display names, quotation marks must be included when using command-line arguments. For example, user name Jim C would be specified as -u "Jim C".

Back to top

To run the Netscape Plug-in for Windows
1.   Start Netscape Navigator.
2.   In the Location box, type http:// followed by the server name and GO-Global logon page. For example, http://server/logon.html.
3.   Select the Netscape Plug-in link from the list of Windows clients. If you have the choice of running the Plug-in in loose or embedded windows mode, select embedded windows if you would like to run the Program Window inside the browser. Select loose windows if you would like to run the Program Window outside the browser. 
4.   When the Logon dialog appears, type the following information: 
     • Your network user name in the User name box. 
     • Your network password in the Password box. 

3.2  Running the Netscape Plug-in for Linux
The Netscape Plug-in for Linux is available for users of Red Hat Linux running Netscape Navigator. 

To install the Netscape Plug-in for Linux
1.   Start Netscape Navigator.
2.   In the Location box, type http:// followed by the server name and the GO-Global logon file. For example, http://server/logon.html.
3.   Select the appropriate Netscape Plug-in link from the list of Linux clients. This Web page will either prompt you to download the Netscape Plug-in or will launch the Logon dialog automatically.
4.   Install the Plug-in from your home directory with the following command:
     tar zxf ggw-plugin.tgz
 

To run the Netscape Plug-in for Linux 
1.   Start Netscape Navigator.
2.   In the Location box, type http:// followed by the server name and the
GO-Global logon file. For example, http://server/logon.html.
3.   Select the appropriate Netscape Plug-in link from the list of Linux clients.
4.   When the Logon dialog appears, type the following information:
     • Your network user name in the User name box. 
     • Your network password in the Password box. 

Back to top

To run the ActiveX Control
1.   Start Internet Explorer. 
2.   In the Address box, type http:// followed by the server name and GO-Global logon page. For example, http://server/logon.html.
3.   Select Microsoft ActiveX Control from the list of Windows clients. If you have the choice of running the Plug-in in either loose or embedded window mode, select embedded windows if you would like to run the Program Window inside the browser. Select loose windows if you would like to run the Program Window outside the browser.
4.   Trust the digitally signed ActiveX control. 
5.   When the Logon dialog appears, type the following information: 
    • Your network user name in the User name box. 
    • Your network password in the Password box. 

Back to top

To run the Java Client
1.  Start Netscape Navigator or Internet Explorer. 
2.  In the Location box, type http:// followed by the server name and the logon file containing the Java applet. For example, http://server/logon.html.
3.  Select either the signed or unsigned Java Client from the list of GO-Global clients. 
4.  When the Logon dialog appears, type the following information: 
    • Your network user name in the User name box. 
    • Your network password in the Password box. 

If you wish to take advantage of the client integration features of GO-Global, and you are not concerned with the Java applet having access to your file system and clipboard, select the signed Java Client. Otherwise, select the unsigned Java Client. This will prevent the applet from accessing your machine's file system, making the clipboard, client printing, and client file access features unavailable.

Back to top

6.1  To install the Linux Client
1.   Launch your Web browser.
2.   In the Location box, type http:// followed by the server name and GO-Global logon file. For example, http://server/logon.html. 
3.   Click the Linux Client link from the list of Linux clients.
4.   Save the GO-Global package.
5.   Launch the Linux Console and become root (Super User). 
6.   Install the package using: rpm –Uvh. (For example, rpm –Uvh ggw.rpm) 

6.2   To run the Linux Client
1.   Type ggw. 
2.   Type your server address in the Connection dialog.
3.   When the Logon dialog appears, type the following information: 
    • Your network user name in the User name box. 
     • Your network password in the Password box. 

6.3   Command-Line Arguments
The Linux Client supports the following command-line arguments:
 

-h	The GO-Global Server address or host name.
-u	The client's network user name.
-p	The client's network password. Please note that if you specify a password on the command-line, the password may be visible to other users running process reporting tools such as ps. To protect the user's password, use -p - to request the password at startup.
-a	The display name of the application to be launched. (The application's display name must be identical to the application name in the Program Window.)
-r	Startup parameters for the application.
-c	Enables compression.
-f or -l	The -l argument runs the Linux Client in a loose window mode. This is the default setting. To enable the restricted frame option, i.e., to have all of the session's windows embedded within a frame on the client computer, append -f to the command line.
-hp	Modifies the host port setting for the Application Publishing Service.
-ac	Determines how printers are initialized at startup. When -ac is followed by all, all client printers are automatically configured. When -ac is followed by none, client printers are not automatically configured. When -ac is followed by default only the default printer is configured automatically. This is the default setting.

Example: ggw -h server1 -p - password -ac all -hp 443

• Startup parameters passed on by the -r argument are specific to each application. Please refer to the application's documentation for information about launch parameters.

• Command-line arguments are optional and case-insensitive. Arguments can be appended in any order, with the exception of -r. If -r is used, it must be the last argument on the command-line, and it must be used with the -a argument. 

• In order to accommodate spaces in user names, passwords, application display names, or application arguments, quotation marks must be included when using command-line arguments. For example, the argument -a "Corel Ventura" would launch Corel's Ventura application. Likewise, user name Jim C would be specified as -u "Jim C"

• The Linux Client can be uninstalled by typing rpm -e ggw. 

Back to top

7.1  To install the Mac X11Client 
1.   Launch your Web browser.
2.   In the location box, type http:// followed by the server name and the GO-Global logon file. For example, http://server/logon.html.
3.   Click the Mac X11 Client link from the list of clients.
4.   Download and unzip ggw.tgz.
5.   Open Terminal.
6.   Change to the directory created during the unzipping of ggw.tgz.
7.   Type chmod a+x InstallMacX.sh.
8.   Press Return.
9.   Type sudo ./InstallMacX.sh.
10. Press Return.
11. If prompted, type your password and press Return.

7.2   To run the Mac X11 Client 
1.   Launch X11. 
2.   Type ggw.
3.   Press Return. 
4.   Type the server address in the Connection dialog. 
5.   When the Logon dialog appears, type the following information: 
    • Your network user name in the User name box. 
     • Your network password in the Password box. 

7.3   Command-Line Arguments
The Mac X11 Client supports the following command-line arguments:
 

-h	The IP address of the GO-Global Server.
-u	The client's network user name.
-p	The client's network password. Please note that if you specify a password on the command-line, the password may be visible to other users running process reporting tools such as ps. To protect the user's password, use -p - to request the password at startup.
-a	The display name of the application to be launched. (The application's display name must be identical to the application name in the Program Window.)
-r	Startup parameters for the application.
-c	Enables compression.
-f	By default, the Mac X11 Client runs in loose window mode. The command-line argument -f will run the Mac X11 Client in a restricted frame mode
-hp	Modifies the host port setting for the Application Publishing Service.
-ac	Determines how printers are initialized at startup. When -ac is followed by all, all client printers are automatically configured. When -ac is followed by none, client printers are not automatically configured. When -ac is followed by default only the default printer is configured automatically. This is the default setting.

Example: ggw -h 196.125.101.222 -p - password -ac all -hp 443

7.4   To uninstall the Mac X11 Client

1.  Open Terminal. 
2. Change to the directory with the unzipped ggw files. 
3. Type chmod a+x InstallMacX.sh. 
4. Press Return. 
5. Type sudo ./InstallMacX.sh -uninstall. 
6. Press Return.
7. If prompted, type your password and press Return. 

8.1 Installing the Windows CE Client
Once the Windows CE Client has been installed, you can log on to a GO-Global Server from the Start menu, from a desktop shortcut, or directly from the GO-Global executable.

The Windows CE install program attempts to delete GO-Global.CAB at the end of installation. As such, we recommended setting the GO-Global.CAB file permission to read-only before installing it on the client device.

To install the Windows CE Client
Launch GO-Global.CAB from the corresponding CPU folder on the client device. 
For example, Clients\CE\X86\GO-Global.CAB

To install the Windows CE Client on devices without .CAB file support
1. Locate the following files from the appropriate CPU folder in the Clients/CE/CPU/Programs, (for example, Clients\CE\X86\Programs\*.*):
ggw.exe
clipc.dll
cs.dll
dc.dll
filec.dll
pbru.dll
sc.dll
scres.dll
sndc.dll
2. Copy these files to a common directory on the client device. 

8.2   Running the Windows CE Client from the Start Menu
Users running CE devices with taskbar support can run the Windows CE Client from the Start menu.  

To run GO-Global from the Start menu
1. Click the Start button on the Windows taskbar. 
2. Select Programs | GraphOn GO-Global | GO-Global Client.
3. Type your server address in the Connection dialog. 
4.  When the Logon dialog appears, type the following information: 
     • Your network user name in the User name box. 
     • Your network password in the Password box. 

8.3   Running the Windows CE Client from a Shortcut
On Windows CE devices that support desktop shortcuts, a Windows shortcut named GO-Global Client is created during installation of the Windows CE Client. This shortcut launches the Program Window.

To run the Windows CE Client from a shortcut
1. Double-click the GO-Global Client shortcut.
2. Type your server address in the Connection dialog. 
3. When the Logon dialog appears, type the following information: 
     • Your network user name in the User name box. 
     • Your network password in the Password box. 

8.4   Running the Windows CE Client from the GO-Global Executable
Users with CE devices that do not support the shortcut or start menu launching options can run GO-Global directly from the GO-Global client executable. 

To run the Windows CE Client
1. Run ggw.exe on the client device. 
2. Type the server address in the Connection dialog and click Connect. 
3. When the Logon dialog appears, type the following information: 
     • Your network user name in the User name box. 
     • Your network password in the Password box. 

8.5   Using Command-line Arguments
If a shortcut for ggw.exe can be created on the CE device's desktop, command-line arguments can be used to expedite the logon process. For example, the command-line arguments -a allows users to directly launch an application. Command-line arguments can also be used to pass on application specific startup parameters and to enable compression. 

To run GO-Global using command-line arguments
1.  Right-click on the GO-Global shortcut and click Properties. 
2.  In the Shortcut tab, place your cursor in the Target edit box and append any of the following command-line arguments after the quote ("): 
 

-h	The GO-Global Server address or host name.
-u	The client's network user name.
-p	The client's network password.
-a	The display name of the application to be launched. The application's display name must be identical to the application name in the Program Window.
-r	Startup parameters for the application.
-c	Compression is enabled by default. To disable compression, remove -c from the command-line.
-hp	Modifies the host port setting for the Application Publishing Service.

Example: ...\ggw.exe" -c -h server -u username -p password  -hp 443

8.6   Running the GO-Global Client on a WBT Device
You can also launch GO-Global from a WBT (Windows Based Terminal) device that already has GO-Global installed on it.

To setup up a GO-Global connection
1. Select the Configure tab from the Terminal Connection Manager.
2. Click the Add button
3. Select GO-Global Client from the drop-down list
4. Click OK.
5. Type a connection name in the Connection Name box.
6. Optionally enter any command-line options for this connection in the Command-Line Option box.
7. Click Next.
8. If your connection name is valid, the following message is displayed: "A connection has been created with the name." Click Finish. The new connection will be displayed in the Terminal Connection Manager.

The connection name cannot be longer than 32 characters, cannot begin with a space, and cannot contain the following characters: / \ : * ? " < > | , . [ ] ( ) Also, the connection name cannot match the name of an existing GO-Global connection.

To edit the name or command-line options of a connection
1. In the Configure tab of the Terminal Connection Manager select the desired connection to modify.
2. Click Edit. 
3. Optionally make changes to the name and command-line options for this connection.
4. Click OK.

To delete a connection
1. In the Configure tab of the Terminal Connection Manager select the desired connection to delete.
2. Click Delete.

To run a GO-Global connection
1. Click the Connections tab of the Terminal Connection Manager. 
2. Select the desired connection to run.
3. Click the Connect button.
4. Type your server address in the Connection dialog.
5. When the Logon dialog appears, type the following information:
     • Your network user name in the User name box. 
     • Your network password in the Password box.       
 

9.2   To run the Solaris Client
1.   In the Solaris console, type ggw. 
2.   Type your server address in the Connection dialog.
3.   When the Logon dialog appears, type the following information: 
     • Your network user name in the User name box. 
     • Your network password in the Password box. 

9.3   Command-Line Arguments
The Solaris Client supports the following command-line arguments:
 

-h	The GO-Global Server address or host name.
-u	The client's network user name.
-p	The client's network password. Please note that if you specify a password on the command-line, the password may be visible to other users running process reporting tools such as ps. To protect the user's password, use -p - to request the password at startup.
-a	The display name of the application to be launched. (The application's display name must be identical to the application name in the Program Window.)
-r	Startup parameters for the application.
-c	Enables compression.
-f or -l	The -l argument runs the Solaris Client in a loose window mode. This is the default setting. To enable the restricted frame option, i.e., to have all of the session's windows embedded within a frame on the client computer, append -f to the command line.
-ac	Determines how printers are initialized at startup. When -ac is followed by all, all client printers are automatically configured. When -ac is followed by none, client printers are not automatically configured. When -ac is followed by default only the default printer is configured automatically. This is the default setting.
-hp	Modifies the host port setting for the Application Publishing Service.

Example: ggw -h server1 -p - password -hp 443
 

9.4    To uninstall the Solaris Client
1. Open Terminal. 
2. Login as root with the following command: su
3. Change to the directory containing InstallSolX.sh. 
4. Type the following command: ./InstallSolX.sh -uninstall 

9.2   Server Address 
In the Connection dialog, type the host name of the GO-Global Server. If your client doesn't recognize Windows host names, you can type the IP Address of the GO-Global Server instead. 

9.3   User Authentication 
The GO-Global Server first tries to authenticate users on the local machine, followed by the local machine's domain, and lastly on trusted domains. You can override this default behavior and specify a specific domain by typing the domain name followed by a backslash and your network user name in the User name box of the Logon dialog. For example, NORTH\johnw.

9.4   Client File Access 
GO-Global allows users to access files stored on the client computer and to save files locally. Client drives are designated with a Client prefix. For example, Client A (J:), Client C (K:). To open or save a file locally, select the desired local drive from the drop-down menu of the Open or Save As dialog box. See your system administrator for more information.

9.5   Client Clipboard
GO-Global allows client and server-based applications to exchange information using the clipboard. You can cut and copy information from applications running on your client machine and paste it into applications running on a GO-Global Server, and vice versa. See your system administrator for more information.

9.6   Client Printing
GO-Global provides transparent access to client-side printers for users running the Windows Client, the Linux Client, the Netscape Plug-in, the Microsoft ActiveX Control, and the signed version of the Java Client. Depending on the server configuration, GO-Global will automatically detect your printer information once you have logged on to GO-Global. If the GO-Global Server is not set to automatically configure client printers or is unable to locate your printer driver, you can manually configure a printer driver using the Program Window's Client Printer Wizard. Access the Client Printer Wizard by clicking File | Printers | Configure Client Printer.

9.7 Session Reconnect
Session reconnect allows sessions to be maintained on a GO-Global Server without a client connection. If your connection to the server is lost, intentionally or unintentionally, your session and applications remain running on the GO-Global Server for the length of the time specified by the administrator. Through the Program Window, you can disconnect rather than exit from GO-Global, and you will be able to return to your session in the exact state you left it. To disconnect a session, click File | Disconnect. If the administrator has not enabled the session reconnect feature, the Disconnect option will not appear in the Program Window's File menu.
 

Back to top