Jump to main content
Welcome to the HCL SafeLinx documentation, where you can find information about how to install, maintain, and use HCL SafeLinx.
What's new in SafeLinx 1.2?
HCL SafeLinx 1.2 introduces the following new functionality.
This information provides an overview for network administrators planning to install HCL SafeLinx. It contains the minimum information that is needed to get you started. For detailed information about installing HCL SafeLinx, see the installation information in the section adminguide/admin_guide.html.
Release Notes
The Release Notes are available on the HCL Customer Support site and provide information about fixes, known issues, system requirements, and installation.
System requirements
Review the system requirements for using HCL SafeLinx.
Preparing the network environment
Preparation of your network environment depends on the setup of specific resources and the requirements of your operating system.
One final worksheet is needed to help you gather the information for verifying a successful installation. You need to define at least one user that is a SafeLinx Client who can connect to the SafeLinx Server.
This section describes how to plan for, install, configure, operate, and manage the SafeLinx Server.
HCL SafeLinx uses standards-based protocols to enable secure access from mobile computing devices outside the firewall to business applications and data on your organization's internal network.
HCL SafeLinx includes a range of options for configuring the security of your network, applications, and data.
Installation planning
Before you install HCL SafeLinx, verify that you meet the hardware and software requirements, and that the network connections that you want to use are available.
Roadmaps: Installing and setting up SafeLinx
The following "roadmap" topics guide you through installing and initially configuring SafeLinx. Refer to the topic that corresponds to your relational database and server operating system.
Installing and initial configuration
Initial configuration and installation of HCL SafeLinx varies based on your operating system and relational database.
Adding a secure login profile
By default, the SafeLinx Administrator communicates with the access manager over an unencrypted connection. If you want the connection between the SafeLinx Administrator and the access manager to use transport layer security (TLS) protocols, add a secure login profile to the SafeLinx Administrator.
Adding and configuring resources
After you complete the installation and initial configuration, continue to prepare the deployment by configuring other network resources.
The SafeLinx Administrator administration client is the primary tool for viewing, adding, configuring, and managing HCL SafeLinx resources. Along with the SafeLinx Administrator, you can use the HCL SafeLinx Monitor to view information about packet flow through the SafeLinx Server. You can also use a set of command line tools to perform common SafeLinx Server tasks.
Programming reference
There are several programming considerations of which you might want to take advantage.
Database schema information
HCL SafeLinx uses a DB2, Oracle, MySQL, or SQL database to store tables of information about current and past activity of SafeLinx Server sessions. The following tables are created and accessed by using the qualifier name wg for DB2 installations.
Step by step: Nomad configuration
Here are step-by-step instructions that serve as an example of how to install and configure HCL SafeLinx for Nomad on MySQL on Linux.
The SafeLinx Administrator is a Java application that lets administrators configure, monitor, and maintain the resources of one or more SafeLinx Servers.
Controlling resources and organizational units
SafeLinx gives you control over all resources and organizational units.
Customizing network configuration
SafeLinx lets you customize your network configuration.
Configuring for security
SafeLinx includes options for configuring security.
Managing administrators
SafeLinx provides the tools to manage administrators.
Managing users
SafeLinx provides the tools to manage users.
Troubleshooting problems
SafeLinx helps you troubleshoot problems.
What is...
SafeLinx Administrator Help identifies and clarifies necessary topics.
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.
Install, configure, and use the SafeLinx Client component of HCL SafeLinx for use on Android mobile devices.
Install, configure, and use the SafeLinx Client component of Windows HCL SafeLinx on Linux x86_64 systems.
Install, configure, and use the SafeLinx Client component of HCL SafeLinx for use on Mac OS X systems.
Install, configure, and use the SafeLinx Client component of HCL SafeLinx on Microsoft Windows systems.
Use this section to assist you with problems that you might experience, including problems with installation.
Before you open a ServiceNow ticket with HCL® Support
To decrease the time to problem resolution, whenever you submit a ServiceNow ticket, it is important to provide HCL Support with the information needed to diagnose the cause of a problem. HCL SafeLinx provides a support utility, SafeLinx Support, that you can run to automatically collect and send relevant system information. In addition, before contacting Support, you should prepare by completing a support checklist in which you collect and record other information about your environment.
Collecting troubleshooting information to provide to HCL Support
The SafeLinx Support Utility command collects information to assist HCL Support in resolving existing HCL SafeLinx ServiceNow tickets. The command collects information about the current SafeLinx Server configuration, along with diagnostic data, such as traces and system dumps in a file, which you then upload to the HCL Support site.
Determining the version of code installed
HCL SafeLinx has several components that might have separate and distinct software versions and build levels, which are important to provide to the support center.
Troubleshooting checklists
Use the following checklists to help you eliminate possible problem areas and find solutions.
Determining the status of resources
To check the actual status of the network interface, use the IP netstat and ifconfig commands.
Verifying SafeLinx Server processes
Learn the names of the processes that SafeLinx Server starts and how to list them for your operating system.
Port number information
Review the port numbers required for use by the SafeLinx Server and the instructions about changing them.
Supported locales
This topic describes which national language locales are supported and which locales are used by default.
Using access manager logs
The access manager and secure access manager have files that log messages about the communication between the SafeLinx Server and the access manager. They also log messages between the SafeLinx Administrator and access manager. The access manager passwords are in-the-clear in the message log file when the operation run involves a password change.
Using SafeLinx Server logs
The SafeLinx Server stores troubleshooting information in message, account, and trace logs.
Troubleshooting tips
The following are common hints that can help you troubleshoot problems with the SafeLinx Server.
Finding broadcast errors when using mobile access services
Broadcast errors are typically missed message transmissions or extra message transmissions.
Sending network management traps
You can configure the SafeLinx Server to send traps to a network management station.