User Tools

Site Tools


cyberoam_linux_en

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.

cyberoam_linux_en.txt · Last modified: 2014/06/03 13:47 by duarte