Home
SafeLinx Clients
SafeLinx Clients can establish virtual private network (VPN) connections with mobile access services across various wireless and wireline network. SafeLinx Clients use these optimized, secure IP tunnels to communicate with resources on the internal network.
Windows
Install, configure, and use the SafeLinx Client component of HCL SafeLinx on Microsoft Windows systems.
Using the SafeLinx Client on Windows
This section describes the use of the SafeLinx Client on Windows.
Setting up a trace
You can set up a trace to record diagnostic information for the SafeLinx Client. For example, if the modem does not initialize, set up a trace to capture every message sent during the initialization process. Store these messages in the trace file. HCL service personnel might request a trace file from you to help diagnose a problem.

SafeLinx Clients
SafeLinx Clients can establish virtual private network (VPN) connections with mobile access services across various wireless and wireline network. SafeLinx Clients use these optimized, secure IP tunnels to communicate with resources on the internal network.
- Android
  Install, configure, and use the SafeLinx Client component of HCL SafeLinx for use on Android mobile devices.
- Linux
  Install, configure, and use the SafeLinx Client component of Windows HCL SafeLinx on Linux x86_64 systems.
- OS X
  Install, configure, and use the SafeLinx Client component of HCL SafeLinx for use on Mac OS X systems.
- Windows
  Install, configure, and use the SafeLinx Client component of HCL SafeLinx on Microsoft Windows systems.
  - Getting started
    To get started with the SafeLinx Client, review the software and hardware requirements, and then read the instructions on how to install the client.
  - Using the SafeLinx Client on Windows
    This section describes the use of the SafeLinx Client on Windows.
    - Creating a connection
      After downloading and installing the SafeLinx Client, network connections can be defined and added.
    - Starting a connection
      When you create a connection, you can start it or create a shortcut to it.
    - Checking that applications are running before connecting
      You can configure the SafeLinx Client to check that specific programs are running, such as antivirus or personal firewall software, before allowing the connection to start.
    - Automatically starting applications after connecting
      The SafeLinx Client can be configured to start applications automatically after a connection is established. The number of applications which you can autostart is restricted to 16. In addition to specifying the application name, you can also configure any parameters with which you want the application started.
    - Importing and exporting configuration files
      You can export the configuration file that controls how a SafeLinx Client connects to the network and then import the file to other clients to reuse those settings.
    - Viewing connection status on Windows™ operating systems
      The Status window displays information about your connection to the SafeLinx Server:
    - Modifying connection properties
      After you create a connection, you can modify the connection configuration. From the Connections window, right-click the icon that represents the connection, and select Properties.
    - Using cross network roaming
      Using seamless cross-network roaming, the SafeLinx Client connection and applications persist when switching networks in a multi-network (both IP and non-IP) environment. Persistence allows switching physical networks, while preserving both the connection and application session.
    - Limitations of cross-network roaming
      A third-party developer can extend the SafeLinx Client for access to network connectivity events for a specific radio modem. This extended connectivity occurs by developing a custom dynamic link library (DLL) designed for that modem.
    - Sharing the SafeLinx Client connection on Windows™
      You can share the SafeLinx Client connection through Internet Connection Sharing so you can connect multiple local area network computers to your intranet. You can use just one computer with a SafeLinx Client connection.
    - Setting up a trace
      You can set up a trace to record diagnostic information for the SafeLinx Client. For example, if the modem does not initialize, set up a trace to capture every message sent during the initialization process. Store these messages in the trace file. HCL service personnel might request a trace file from you to help diagnose a problem.
      - Using the trace viewer
        To view the trace file click the Tools menu in the Connections window, and select View Trace. This option loads the current trace file into the default editor. You can then save the file to a location of your choice.
      - Configure trace properties
        Configure the trace properties to record diagnostic information. After the initial SafeLinx Client installation, by default trace is turned on only during the connection attempt. To turn on tracing, select a trace level other than Off by using the trace configuration utility started by clicking Tools > Configure Trace.
    - Applying maintenance on Windows™ operating systems
      Links to code fixes, for entitled customers, are available from the HCL SafeLinx product support website.
    - Removing the SafeLinx Client from Windows
      The process varies slightly depending upon which version of Windows you are running.
  - Configuring clients with a configuration file
    The artour.ini file contains configuration information about your client and each connection you define. This file is modified when you create connections or modify their properties. It controls which fields and buttons are presented on the Connect window for each connection.

Setting up a trace

You can set up a trace to record diagnostic information for the SafeLinx Client. For example, if the modem does not initialize, set up a trace to capture every message sent during the initialization process. Store these messages in the trace file. HCL service personnel might request a trace file from you to help diagnose a problem.

Procedure

Trace Files

The SafeLinx Client has three possible trace files.
- arttrace.txt - Main SafeLinx Client trace file
- arttrace2.txt (created when buffer fills up for arttrace.txt)
- artginatrc.txt - Trace file for the Windows™ Integrated Login component.
The artginatrc.txt displays only on Windows XP. This file would be present only if the custom Windows Integrated Login component is installed. The tracing for the component is activated the same way in which the Main SafeLinx Client Traces are turned on. The detection of whether Windows Integrated Login tracing is on or off is ONLY done at device boot time.
By default the trace files are located:

SafeLinx Client for Windows 2000

Click Documents and Settings > All Users > Documents or Documents and Settings > All Users.Winnit > Documents.

SafeLinx Client for Windows XP

Click Start > My Documents > Shared Documents or Documents and Settings > All Users > Shared Documents.

By default the artginatrc.txt is in Documents and Settings > All Users > Shared Documents.
SafeLinx Client for Windows Vista

Click Start > Documents > Public > Public Documents.
You can configure a custom location for the SafeLinx Client trace files by using a setting within the artour.ini file. The artour.ini file is in:
- Windows 2000: C:\Documents and Settings\All Users\Application Data\HCL\SafeLinx Client
- Windows XP: C:\Documents and Settings\All Users\Application Data\HCL\SafeLinx Client
- Windows Vista: C:\Users\All Users\HCL\SafeLinx Client
- Windows 7: C:\Users\All Users\HCL\SafeLinx Client
In the [ SAFELINX ] section of the artour.ini file, you must add the setting TraceFolder=. With this setting all 3 of the SafeLinx Client trace files are written to this path: TraceFolder= <specify the directory you wish>(that is, c:\SafeLinx Client\Traces).

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box. Note: To report a problem or question about the product software, do not use this form. Instead, go to the HCL Software Support site.