Table of Contents
Linux
Description
This tutorial describes the configuration process of a Linux device, to allow Internet access, using Eduroam's wireless network, provided by Polytechnic Institute of Viana do Castelo.
This is a step by step tutorial providing the necessary stages to configure the client. You must possess your institutional access credentials provided by IPVC.
If you find any anomaly, please contact the Informatic Services.
Versão
This tutorial was based on the following OS requirements and software versions:
Authentication Client Application: Corporate Client for Linux (Cyberoam Technologies Pvt. Ltd.) OS: Linux Versions: Red Hat, CentOs, Ubuntu, Fedora, etc
Step by Step Configuration
Step 1: Download and Installation
Download Corporate Client for Linux OS from: cyberoamlinuxclient.tar.gz
Extract saved file with the following command:
tar xvfz CyberoamLinuxClient.tar.gz
This will create a directory named “crclient” with two files - “crclient” and “README” file in the “crclient” directory.
Step 2: Logon to Cyberoam
Execute the following command:
./crclient -u <username> -i <interface>
Example:
./crclient -u utilizador@ipvc.pt -i eth0
It will prompt for Cyberoam server IP address and password of the username specified as configuration file is not created.
Cyberoam's server IP: 172.16.150.2
Above process will create following files:
- Config File: <user's HomeDirectory>/crclient.conf
- Log File: /var/log/crclient.log
- PID File: /tmp/crclient.pid
Step 3: Logout
Logout using following command:
./crclient -l <username>
Example:
./crclient -l utilizador@ipvc.pt
Step 4: Configuration
Installation automatically creates the config file with the default parameters with the name crclient.config under the user’s home directory. You can edit default configuration file, by opening crclient.config file using any of the Editors. Configuration file includes the below shown parameters.
Example of Configuration File:
| Parameter | Value |
|---|---|
| AskonExit | 0 |
| AutoLogin | 0 |
| FirstTime | 1 |
| Password | |
| Port | 6060 |
| SavePassword | 0 |
| Server | 172.16.150.2 |
| User | utilizador@ipvc.pt |
| ShowNotification | 1 |
| LiveRequestTime | 180 |
| AlreadyLoggedIn | 0 |
| VersionId | 1 |
| Versioncrclient | 1.1 |
When User logs on, Configuration file is first searched in /etc directory, if not found, searches in the user's home directory. If the configuration file is not found at both the places, a file is created in the user's home directory by accepting the essential parameters from the User.
Following options are provided in the Cyberoam client:
| Parameter | Description |
|---|---|
| -u | Responsible for sending a login request to the server and requires username as a parameter |
| -s | Use to set preferences for the client. Preferences such as AskonExit, AutoLogin, ShowNotification and Server Address can be set using this option. |
| -I | Use to send a logout request to the server.Multiple Login mode requires “username” as an argument |
| -h | Provides help for the client |
| -d | Use to specify the location for log file |
| -v | Use to set the verbose mode on. This option is for debugging |
| -V | Provides Current Version information |
| -f | Use to specify the locationfor the configuration file |
| -i | Use to specify interface to which user is to log on |
Note: Check for the file “crclient.pid”, if system crashes or user is not able to login. If this file is present then Cyberoam Client will not come up. Remove the file for successful logon.
After configuration, when user tries to logon to Cyberoam using following command: ./crclient -u <username> -i <interface>, user will not be prompted to enter Cyberoam server IP address as configuration file already exists.
