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.
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.

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.

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.

Procedure

The trace configuration tools utility also includes the following settings:

Trace levels

The controls on the Level page are:

Off: No tracing is begun. This setting is the default state for the SafeLinx Client.

Performance: This level is used to trace the performance of the SafeLinx Client as it is operating.

IP: This level traces IP data received from and sent to the IP stack.

Low: This level helps with debugging, with minimal impact to performance.

High: This level is used when Low does not provide enough information. There is an impact on performance.

File

The controls on the File page are:

Buffering: Buffering the trace data in memory before writing it to the trace file reduces the impact of tracing on performance. Turn on buffering for all problems except program exceptions. Turn buffering off only when debugging exceptions in the SafeLinx Client where the SafeLinx Client does not close normally.

Flush push: When buffering is on, click Flush to write data from memory to the trace file.

Maximum file size: Use the Maximum File Size field to set the maximum size of your trace file.

Trace messages are stored in a file named ARTTRACE.TXT. When the file reaches its maximum size, it is renamed to ARTTRACE2.TXT and a new ARTTRACE.TXT file is created for active trace data. Only two trace files are kept, the active trace file and the most recent previous file.

Default: 1400 KB on Windows 2000.
Rance of Values: 64 KB to 99,999 KB.

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.