Isl Light 3 3 Manual

ISL Light 3.
3 Manual
ISL Light 3.3 Manual Contents 2
Table of Contents
Foreword 0
6
Part I Introduction
...............................................................................................................................................................................
1 Welcome to ISL Light 3.3 6
...............................................................................................................................................................................
2 How it w orks 6
...............................................................................................................................................................................
3 Features 7
...............................................................................................................................................................................
4 Reliability 9
...............................................................................................................................................................................
5 Security 10
...............................................................................................................................................................................
6 System Requirements 11
...............................................................................................................................................................................
7 More on port 7615 13
14
Part II Getting started
...............................................................................................................................................................................
1 How to use ISL Light 14
...............................................................................................................................................................................
2 Register ISL Online account 15
..............................................................................................................................................................................
ISL Online account registration 15
..............................................................................................................................................................................
Open inbox 19
..............................................................................................................................................................................
Finish registration 20
..............................................................................................................................................................................
Login to ISL Online account 22
...............................................................................................................................................................................
3 Create a session 25
..............................................................................................................................................................................
Start ISL Light Desk - Standalone 25
..............................................................................................................................................................................
Start ISL Light Desk - Web 27
...............................................................................................................................................................................
4 Join a session 30
..............................................................................................................................................................................
Join a session - Standalone 31
..............................................................................................................................................................................
Join a session - Web 32
...............................................................................................................................................................................
5 In session features 34
..............................................................................................................................................................................
Online Chat 35
..............................................................................................................................................................................
View Desktop 36
..............................................................................................................................................................................
View Desktop - Whiteboard 37
..............................................................................................................................................................................
View Desktop - Remote Control 38
..............................................................................................................................................................................
Administrative mode 42
..............................................................................................................................................................................
Restart and resume 43
..............................................................................................................................................................................
File Transfer 44
..............................................................................................................................................................................
Audio Communication 46
..............................................................................................................................................................................
Video Communication 48
..............................................................................................................................................................................
Session Recording 50
..............................................................................................................................................................................
Remote Printing 53
...............................................................................................................................................................................
6 Ex it ISL Light 60
62
Part III Manual
...............................................................................................................................................................................
1 How ISL Light w orks 62
...............................................................................................................................................................................
2 ISL Light GUI 65
...............................................................................................................................................................................
3 Create a session 68
..............................................................................................................................................................................
Starting ISL Light Desk 68
2014 Xlab d.o.o., Ljubljana
2
..............................................................................................................................................................................
Getting the session code 69
...............................................................................................................................................................................
4 Join a session 71
..............................................................................................................................................................................
Starting ISL Light Client 71
..............................................................................................................................................................................
Entering the session code 72
...............................................................................................................................................................................
5 Chat 75
...............................................................................................................................................................................
6 Desktop Sharing 77
..............................................................................................................................................................................
How to start View / Show desktop 77
..............................................................................................................................................................................
Region and Application sharing 80
..............................................................................................................................................................................
Viewing the Remote Desktop 83
..............................................................................................................................................................................
Control of the Remote Desktop 84
..............................................................................................................................................................................
Size, refresh and quality 86
..............................................................................................................................................................................
Whiteboard 89
..............................................................................................................................................................................
Tools button 91
..............................................................................................................................................................................
Tools button - Administrative mode 94
........................................................................................................................................................................
Checking system account connection settings 99
..............................................................................................................................................................................
Sending Ctrl-Alt-Del 103
..............................................................................................................................................................................
Selecting remote monitor 106
...............................................................................................................................................................................
7 Audio and Video 107
..............................................................................................................................................................................
Audio Overview 107
..............................................................................................................................................................................
Enable Remote Audio 110
..............................................................................................................................................................................
Video Overview 112
...............................................................................................................................................................................
8 Session recording 114
...............................................................................................................................................................................
9 Remote printing 117
...............................................................................................................................................................................
10 File Transfer 128
..............................................................................................................................................................................
Drag and drop 128
..............................................................................................................................................................................
File transfer folder 130
...............................................................................................................................................................................
11 Restarting into safe mode 133
...............................................................................................................................................................................
12 User Management 134
...............................................................................................................................................................................
13 Reports 135
...............................................................................................................................................................................
14 Ex it ISL Light 135
...............................................................................................................................................................................
15 Settings 136
..............................................................................................................................................................................
Settings locations 137
..............................................................................................................................................................................
General 141
..............................................................................................................................................................................
Desktop Sharing 143
..............................................................................................................................................................................
File transfer 146
..............................................................................................................................................................................
Video 147
..............................................................................................................................................................................
Audio 149
..............................................................................................................................................................................
Recording 150
...............................................................................................................................................................................
16 Customization 151
..............................................................................................................................................................................
Adding a company logo 152
..............................................................................................................................................................................
Using session dialogs 153
..............................................................................................................................................................................
Command line arguments 153
........................................................................................................................................................................
Simple command line arguments 154
........................................................................................................................................................................
Complex command line arguments 156
................................................................................................................................................................
Main module 157
................................................................................................................................................................
Desktop sharing module 158
................................................................................................................................................................
File transfer module 159
................................................................................................................................................................
Audio module 159
................................................................................................................................................................
Video module 159
3
................................................................................................................................................................
Recording module 159
........................................................................................................................................................................
How to use them 160
................................................................................................................................................................
Command Prompt method 160
................................................................................................................................................................
Windows Shortcut method 160
................................................................................................................................................................
URL method 161
........................................................................................................................................................................
Examples 162
..............................................................................................................................................................................
Changing program skin and texts 163
...............................................................................................................................................................................
17 Web page integration 167
..............................................................................................................................................................................
Advanced web page integration 168
170
Part IV Server licence
...............................................................................................................................................................................
1 Quick setup 170
...............................................................................................................................................................................
2 Conference Prox y points of interest 171
...............................................................................................................................................................................
3 Starting ISL Light 174
...............................................................................................................................................................................
4 Customization 175
..............................................................................................................................................................................
Adding a company logo 176
..............................................................................................................................................................................
Using session dialogs 177
..............................................................................................................................................................................
Command line arguments 181
..............................................................................................................................................................................
Changing program skin and texts 181
..............................................................................................................................................................................
Using filters 182
...............................................................................................................................................................................
5 User management 183
...............................................................................................................................................................................
6 Integration 184
..............................................................................................................................................................................
Advanced web page integration 184
..............................................................................................................................................................................
HTTP events 185
........................................................................................................................................................................
PHP script writes to a database 188
................................................................................................................................................................
Installing XAMPP and Smarty 188
................................................................................................................................................................
Adding tables to the database 189
................................................................................................................................................................
Adding scripts 193
...................................................................................................................................................................................
Source code 193
................................................................................................................................................................
Configuring ISL Conference Proxy 200
................................................................................................................................................................
Using the viewer script 200
................................................................................................................................................................
Conclusion 200
........................................................................................................................................................................
IIS Example - ASP.NET script writes to a database 201
................................................................................................................................................................
Installing IIS 201
................................................................................................................................................................
Configuring IIS 203
................................................................................................................................................................
Installing .NET Framework 211
................................................................................................................................................................
Installing MS SQL Server 211
................................................................................................................................................................
Configuring MS SQL Server 213
................................................................................................................................................................
Configuring ISL Conference Proxy 217
................................................................................................................................................................
Using the viewer script 219
..............................................................................................................................................................................
XMLMSG 222
........................................................................................................................................................................
Sending messages to ISL Light 223
........................................................................................................................................................................
Querying session information 224
..............................................................................................................................................................................
Notifications 226
........................................................................................................................................................................
C++ example 226
........................................................................................................................................................................
VB example 228
232
Part V Frequently answered questions
4
Index 0
5
ISL Light 3.3 Manual Introduction 6
1 Introduction
Please continue to Welcome to ISL Light 3.3 chapter.
1.1 Welcome to ISL Light 3.3
ISL Light is the secure and affordable way to remotely deliver technical assistance to your customers or
employees anywhere in the world. Without any installations or configurations ISL Light support sessions are
started in a matter of seconds. View your clients' desktops, control their keyboard and mouse, transfer files and
communicate via the integrated audio and video plug-ins. Register and try it for free.
ISL Light 3.3 now includes improved desktop sharing performance, especially when using CAD or multimedia
software (e.g. streaming video). There are several ISSC (Internet Screen Sharing Codec) quality settings
available, please refer to the following topic for more information: Size, refresh and quality
Connect to any computer without View your clients' desktops and control
installations or configurations. remote computers.
Reduce your support costs and Industry standard SSL using 256-bit
shorten resolution time. end-to-end encryption.
1.2 How it works
Support customers from your office, quickly and professionally.

ISL Light is a simple, secure, and also affordable remote desktop support solution. It enables an operator to be
connected to a remote client's computer anywhere in the world in less than 30 seconds.
See ISL Light in action

Your company can switch to ISL Light's remote desktop services immediately. In a secure remote desktop
session, your operators could view their clients' desktops, gain control of their keyboard and mouse, transfer
files, use the whiteboard, and communicate via the integrated audio and video plug-ins.
ISL Light, as a part of ISL Online network, offers a centralized access to user management and reporting
capabilities through your ISL Online account. Register and try it for free.
Starting a remote desktop support session

Ste p 1 :
A client calls your support center requesting immediate help
with his or her computer. Directed to your or ISL Light's official
website, the client is asked to run a small executable file - ISL
Light Client.
Ste p 2 :
Meanwhile, the operator runs
the ISL Light Desk
application, requests a new
session code and tells it to
the client over the phone. The
client enters the session
code, clicks 'connect' and
their session is started.
Ste p 3 :
Closing a connection will close the ISL Light service
altogether. After a service, both the operator and the client can
be prompted to fill in a customizable questionnaire to collect
feedback on the support session.
1.3 Features
With ISL Light's intuitive graphical user interface you will be assisting your clients within minutes. No
installations or configurations on either side are necessary, making the remote support more user-friendly.
Automatic Setup
ISL Light executable automatically launches, installs, and configures itself. No restart is
required.
Firew all Friendly

Since the ISL Light software initiates the outgoing connection, the technology works with your
existing firewall and does not require special configuration.

Encryption and Maximum Security

Industry-standard (SSL) security technologies are used to protect data transfer. Connections are
secured by symmetrical AES 256 Bit end-to-end encryption. Applications are digitally signed by
Verisign Certificate.
Customizable GUI
Default language is automatically adjusted according to the user's regional settings and can be
switched to multiple languages. Company logo is also customizable.
Optimal Performance
Cloud-based communication technology assures global client support with nearly 100% service
up-time, fault tolerance, and automatic session re-connection.
Chat
Text Chat between an operator and a client is possible before and during an online meeting.
View / Show Desktop

View your client's desktop or invite the client to temporarily view your desktop. Switch within the
same session.
Share Keyboard and Mouse

View your client's desktop securely and gain control of the keyboard and mouse, or give control
to the client.
Application / Region Sharing

Desktop sharing can be limited to a single application or a manually selected region of the
desktop.
File Transfer
Quickly transfer files and folders between the operator and the client in both directions.
Reboot & Reconnect

Regain connection after rebooting the remote computer, switching user, or logging off. Continue
supporting within the same session.

Whiteboard
The operator can use the client's desktop as a whiteboard: draw a pointer, use a red marker to
circle or underline something.
Audio & Video

Secure VoIP and live video communication between the operator and the client are available
during a session.
End-of-Session Survey
Customizable questionnaires after each support session make it easy to gather feedback
information from clients and operators.
User Management
Assign an administrator to manage ISL Light services in your company: add operators to admin
account, give them individual rights, monitor their activities, etc.
Reports
Reports provide your company with in-depth information on ISL Light sessions for the operators
as a team or as individuals: Log session, chat, and end-of session survey.
Remote Printing
Share a printer and print a local document on a remote client's printer or print a remote
document on a local printer. Provide your client with a hard copy of a document even if he
doesn't have the matching application.
Session Recording
Record your session for later use. Play it with ISL Recording Player or export the file into the AVI
format. Use session recording to satisfy high security standards or for training purposes.
1.4 Reliability
ISL Light, as a part of ISL Online network, uses an architecture that is designed for maximum reliability, security
and performance. Needing no prior installations or configurations, ISL Light is an excellent tool for handling on-
demand support requests, while it does not require any special effort or knowledge to start using it in your
company. Register and try it for free
With ISL Light's screen-sharing technology and intuitive interface, supporting your clients could not be easier.
Clients only need to run a small executable, type in a session code and click 'connect'. Anyone can use it, since
ISL Light is compatible with existing firewalls, it works on all Microsoft Windows OS from 95 to Vista, on Linux
and on Mac OS X. ISL Light is also browser-independent. Evaluate ISL Light by yourself.

Support anyone anywhere anytime
ISL Light sessions are established through a global series of servers connected to the rich ISL Grid media
communications network. The latter assures 24/7 availability of the service with a strong and reliable remote
desktop connection between any two points in the world. Its architecture is fault tolerant, includes geographical
load-balancing mechanisms and distributed session roaming. Not only is the connection relayed through the
server with the lowest traffic load, but also the geographically nearest server to both end users.
Scalable to your needs

You can rely on ISL Light to optimize its performance regardless of your Internet connection or the number of
clients being supported remotely. Whether you are supporting 1 or 1,000 clients, our compression
mechanisms and colour depth dynamically adapt to your Internet bandwidth enabling optimized speed and
quality of the remote screen. We are committed to taking your ISL Light sessions to a seamless and effortless
level.
ISL Customer Care
The ISL Online Team is available to assist you with technical issues or other questions over the telephone, via
e-mail and through our live chat (simply go to http://www.islonline.com/ and click the Chat Live button in the top-
right corner of the page). You are welcome to contact us directly or your nearest Authorized Reseller.
1.5 Security
ISL Light is the most secure remote access product available. It uses industry-standard security technologies
to protect data transfer. All data connections are encrypted with SSL of 256-bit end-to-end AES encryption, and
above all, end-user applications are digitally signed by means of a VeriSign Certificate, which verifies the
connection's integrity. In addition to the communication level, the ISL Light's high security is enhanced with
mechanisms at application and user level.
3-level encryption and maximum security

1.) Communication level

Signed executables with a certificate issued by Verisign. End-to-end session encryption using 1024 bit RSA,
256 bit AES and Diffie-Hellman (SSL standard). Session code is invalidated immediately after initial
connection.
2.) Application level
Users can choose to share the whole desktop, its selected region, e.g. the left half of the desktop, or just a
single application. Sharing control over a computer, both the operator and the client can control its keyboard
and mouse. Closing the session at either end will terminate the ISL Light service altogether.
3.) User level
The client must approve each ISL Light session. Each feature is allowed separately and can be disabled
instantly. Each operator in the company can use an individual password for ISL Light.
1.6 System Requirements
ISL Light Desk and ISL Light Client applications:
Operating Systems:
Microsoft Windows 95 [1]
Microsoft Windows 98 [1]
Microsoft Windows Millennium [1]
Microsoft Windows NT 4.0 [1]

Microsoft Windows 2000

Microsoft Windows 2000 Server

Microsoft windows 2003 Server
Microsoft windows 2008 Server
Microsoft Windows XP (32-bit and 64-bit)
Microsoft Windows Vista (32-bit and 64-bit)
Microsoft Windows 7 (32-bit and 64-bit)
Apple Mac OS X 10.4 Tiger or higher[2]
Linux kernel 2.4 or higher, with X Window System (32-bit and 64-bit)
Notes :
1. ISL Light 3.2.6 for Windows was the last supported version on this platform.
2. ISL Light 3.3.1 for Mac was the last version to support Mac OS X 10.4 Tiger and the last version to support
PowerPC Macs. ISL Light 3.3.2 and newer are available for Intel Macs running Mac OS X 10.5 Leopard or
newer.
Internet Connection:
Bandwidth minimum: 56 Kbps
Supported connection methods (ISL Light can work with any of the following):
direct outgoing TCP/IP connection to TCP port 7615 on ISL Conference Proxy server
WININET HTTPS connection to TCP port 443 on ISL Conference Proxy server
WININET HTTP connection to TCP port 80 on ISL Conference Proxy server
direct HTTPS connection to TCP port 443 on ISL Conference Proxy server
direct HTTP connection to TCP port 80 on ISL Conference Proxy server
Timeout for a specific connection method is 7 seconds for connection establishment - so total timeout for
connection is less than 1 minute.
Supported network types are the following:

a computer with a static public IP
a computer with a dynamic public IP
a computer in a private network behind a firewall with a public IP performing NAT
a computer in a private network behind a http proxy offering http and/or https protocols
Web Browser:
Microsoft Internet Explorer 5.0 or higher
Firefox 1.0 or higher
Netscape 7.1 or higher
Opera 7.5 or higher

1.7 More on port 7615
Port 7615 is the preferred choice and you can think of it as the standard ISL Online port, just like 22 is ssh, 23
telnet, 25 smtp, 3389 rdp etc. - you can also find it in the list of ports at wikipedia.
Having a specific port is also very convenient - if you have a certain company policy and use a firewall/proxy, but
would like to adjust it to allow ISL Online traffic, we simply instruct you to open port 7615 and all ISL Online
products will work great. If we only used 80/443, the admin would find it difficult to try and allow ISL Online but
limit other traffic that also goes through port 80/443.
In general, the first thing to consider when dealing with a proxy environment is to check with the system/network
administrator if it is possible to make an exception. This does not mean that you completely disable the proxy,
just let the ISL Online traffic through directly and keep filtering the rest. If the proxy supports DNS name
exceptions, then allow direct outgoing tcp connection for port 7 6 1 5 to * . i s l o n l i n e . n e t . If the proxy
supports only IP number exceptions, check this link for a current list of our server IPs. Direct connection offers
best performance and minimum delays.
In an ideal world of direct connections and flexible security policies, the story would end here, but since there
are many customers behind corporate firewalls/proxies where only http and https traffic is allowed (so, port 80
and/or 443) and system/network administrators do not want or are not allowed to add exceptions, we also
support that and our applications try to find a working transport even in those situations (detect proxy settings,
use wininet, create a tunnel, make use of the wildcard dns - helps with some proxies, etc.).
Situations where such filtering is involved can suffer from additional delays due to transport timeouts in the
connection establishment process. ISL Online products always (well, unless you force a certain transport type
through registry or command line) try direct connection using port 7615 and if that fails, they try ports 80 and
443 with various proxy methods. Each transport type has a timeout of 7 seconds and on windows we try 8
transport types, so if it is the last one that gets through, this means almost 1 minute delay. If a customer
complains about long delays, the best thing to do is connect to the problematic computer and click find best
transport in our utility connection tester. It will show you a list of successful transports along with the average
transfer rate, delays etc. These results will allow you to force the best transport. Both you and your customer will
appreciate the reduced connection delay.
If you need help when dealing with ISL Online products in proxy environments you can contact ISL Online team
over the telephone, via e-mail or through our live chat (simply go to http://www.islonline.com/ and click the Chat
Live button in the top-right corner of the page).

ISL Light 3.3 Manual Getting started 14
2 Getting started
Please continue to How to use ISL Light chapter.
2.1 How to use ISL Light
Use ISL Light to connect with a remote computer anywhere in the world in just 4 quick steps. The connection
between the computers is established via the internet. ISL Light, as a part of ISL Online network, offers two
user models: a hosted service (1-year subscription or PayPerUse Coupon) and a stand-alone server
application (Server License).
Using ISL Light as a hosted service, a secure remote desktop connection is established through the ISL Grid -
the ISL's massive network of servers worldwide. Therefore, you don't need to install or configure anything. Once
registered with us, you are able to connect to a remote computer in less than 30 seconds and put every single
first-class ISL Light feature to profitable use. Support your customers remotely, quickly and professionally, and
enjoy the free time ISL Light gains you.
This chapter describes the basic connection procedure and some features of ISL Light. To connect you need to
do the following
Register an ISL Online account
Supporter starts ISL Light Desk using your username and password and creates a session
Client starts ISL Light Client and joins the session using the provided session code
Once connected you can do the following:

chat
view desktop, use whiteboard, control keyboard and mouse
show desktop
transfer files
use audio communication
use video communication

Please continue to Register ISL Online account chapter.
2.2 Register ISL Online account
This chapter describes the procedure for registering a new ISL Online account. It involves four steps:
1. ISL Online account registration
2. Open inbox
3. Finish registration
4. Login to ISL Online account
Please continue to the first step: ISL Online account registration.
2.2.1 ISL Online account registration
If you already have an ISL Online account, please continue w ith the next step and use your existing ISL
Online username and passw ord.
Before you start using ISL Light Remote Desktop, you will need to create your ISL Online account. You are
welcome to register your ISL Online account now. To create an ISL Online account, you can also navigate to
http://www.islonline.com, then click the Sign Up link.

You need to enter a valid e-mail address which will serve as your future ISL Online Account name. Click Sign
Up to confirm your email address and start the registration process.

Please be sure that the e-mail account is accessible as the ISL Online Customer care system will send
important information to that address, including the confirmation link and account credentials. If needed, the
selected e-mail address could later be changed.
Check "send plain text e-mail" option if your e-mail system has rigorous anti-spam program installed.
An e-mail with a verification link and other useful information is sent to the provided e-mail address
immediately after you have pressed the Sign Up button.

If the selected username already exists, an error message is shown.

Please continue to Open inbox chapter.
2.2.2 Open inbox
You can check your e-mail account's inbox immediately after the verification e-mail has been sent by the
registration procedure. Open the received e-mail and follow the verification link.
If it does not work for some reason, copy the link below that link, paste it into your browser's address line and
press enter.

Sometimes some of the links in the e-mail get broken into multiple lines because of the e-mail system. In
that case please compose the link back into a single line before putting it into your browser's address line.
Please continue to Finish registration chapter.
2.2.3 Finish registration
The last form asks for some basic company information. Press Complete to finish the registration.

All credentials have been sent to your e-mail address. Please open your mailbox and check for another e-mail
from ISL Customer Care system with the subject ISL Online - Login Information. It should look like this:
Later on you can use your username and password to log into your ISL Online Account (My Account at
www.islonline.com). Within your ISL Online Account you can manage your license(s), add and edit users, see
reports, activate a key after a purchase and modify your account information.

When an account is registered for the first time, it is automatically activated with a 15-day fully functional no
obligation trial mode, with two active connections. Please select the Activate key link if you have purchased an
ISL Online service item and you wish to activate the activation key for this account.
Please continue to Login to ISL Online account chapter.
2.2.4 Login to ISL Online account
Having finished the registration procedure, your ISL Online account will be activated with the 15-day fully
functional no obligation trial mode and username and password for accessing this account will be sent to your
e-mail address. Enter your username and password and press the Log In button to enter your ISL Online
Account.

Select Forgot passw ord? option if you do not know your password. It will be sent to your e-mail address.
When logged in, Hosted service Info page appears. It is in the Trial mode since no ISL Online items have been
activated yet:

Using the My Account menu on the top menu bar, you can modify and configure your ISL Online Account:
Products entry gives you access to any of the 4 products. Here you can start Remote Support, Remote Access,
Live Chat, and Web Conference.
Hosted Service entry is used to create additional users and view reports for Hosted Service.
Server License entry is used for setting up your own ISL Conference Proxy for running on your company's
server(s).
Activate Key entry is used for the activation of purchased keys (ISL Online items).
Preferences entry is used to set up general preferences for your ISL Online Account.
Please continue to the next step: Create a session.

2.3 Create a session
There are two main ways of creating a session.

The standalone way starts the latest available version of ISL Light Desk from our webpage. This is a general
version which is in no way customized, since the operator does not identify himself/herself.
The web way first identifies the operator (since the operator logins with his/her ISL Online products username
and password) and allows the use of customizations (e.g. company logo, session dialogs). Customizations
can be set in the ISL Online Account.
Please select a way of creating a session for a detailed description of the procedure:
Start ISL Light Desk - Standalone
Start ISL Light Desk - Web
2.3.1 Start ISL Light Desk - Standalone
To start ISL Light Desk, you need to have an ISL Online products username and passw ord.
There are several options for starting ISL Light Desk:

start it from the ISL Online website
download it from the ISL Online website to a certain location on a computer, then run it from there
download it from the ISL Online website and publish it on your company's website, then instruct your
operators to download it from there
The following procedure illustrates the first option. Please go to the ISL Online website:

OPERATOR
Download and run the Remote support tool
(if you want to use the second or third option,
save it to your computer instead of running it)

Press Get code
Enter username and password.

You will obtain a unique session code.
Tell the unique session code to the client.
Please continue to the next chapter: Join a session.
2.3.2 Start ISL Light Desk - Web
Please go to the ISL Online home page , click the Log In button at the top right corner of the web page. Enter
your ISL Online products username and password in the provided space, then click the Log In button.

If you have created an ISL Online domain in your ISL Online account, the username should be entered in a \
\your-domain\username form (e.g. \\mycompany\john )

Once logged in to my account section you need to click on Products. this will bring up a list of the 4 products in
the ISL Online product suite.

First click on the Remote Support link, then click the Start New Session button.
This will start ISL Light Desk and automatically obtaining a session code using your ISL Online products
username and password.
Please continue to the next chapter: Join a session.
2.4 Join a session
There are two main ways of joining a session.

The standalone way starts the latest available version of ISL Light Client from our webpage. This is a general
version which is in no way customized.
Using the web way, a client enters the provided session code, then is presented with basic session
information (session code, session creator, session status, session creator's email) and with a single click,
ISL Light Client is started and the session is established automatically. This method allows the use of
customizations (e.g. company logo, session dialogs). Customizations can be set in the ISL Online Account.
Please select a way of joining a session for a detailed description of the procedure:
Join a session - Standalone
Join a session - Web

2.4.1 Join a session - Standalone
There are several options for starting ISL Light Desk:

start it from the ISL Online website
download it from the ISL Online website to a certain location on a computer, then run it from there
download it from the ISL Online website and publish it on your company's website, then instruct your
operators to download it from there
The following procedure illustrates the first option. Please go to the ISL Online website:

CLIENT
Download and run the
ISL Light Client
(if you want to use the
second or third option,
save it to your computer
instead of running it)
Enter the unique

session code.
Click Connect.
2.4.2 Join a session - Web
Please go to the ISL Online home page, enter the provided session code into the box and click Connect.

You will be presented with basic session information (session code, session status, user, full name, email) -
simply click Start and ISL Light Client will start. Session will be established automatically, using the provided
session code.

2.5 In session features
This chapter describes features that are available in session:

Online Chat
View Desktop
View Desktop - Whiteboard
View Desktop - Remote Control
Administrative mode
Restart and resume
File Transfer
Audio Communication
Video Communication
Session Recording
Remote Printing

2.5.1 Online Chat
When a session is established between an operator and a client, online chat is started by default, so they can
send messages to each other.

2.5.2 View Desktop
When a session is established between an operator and a client, the operator can view the desktop of the
client or show his or her desktop to the client. Operator and a client may also choose to share only one
application instead of the whole desktop.
Press the left button on the circular toolbar.
Request to View the client's desktop.

Press Show to show your desktop to the client.
Request to Choose an application and select the application that you wish to Show to your client.

2.5.3 View Desktop - Whiteboard
Whiteboard is enabled automatically when desktop streaming is started. Whiteboard settings are placed in the
top toolbar of the desktop streaming window (ISL View).
Drawing possilities: a red line or a pointer.
Erasing possibilites: manually or automatically every 5 or 10 seconds (right-click on the eraser button to set
it).

2.5.4 View Desktop - Remote Control
When the remote desktop sharing is started, you may take control of the remote computer's keyboard and
mouse. Sharing the control: both client and desk can control the keyboard and mouse but not at the same time.
When one is active, the other must not use the shared mouse and keyboard.
Press Request Control button in the top toolbar of the desktop streaming window (ISL View).

The status of who is controling the shared keyboard and mouse is displayed in the top status toolbar.
If the sign "remote user has control" is displayed in green, a remote user (an operator) has control over the
client's computer. If the client moves the mouse or presses a key on the keyboard, the operator loses control
over the shared keyboard and mouse for 5 seconds. This function enables mutual work on one computer.

If the sign "local user has control" is displayed in red, a local user (a client) has control over the client's
computer.
The client can take the control back from the operator anytime by just clicking the revoke control button.

The client can also be the one to initiate the control sharing over his/her keyboard and mouse by pressing
grant control in the top toolbar of the desktop.
The client can stop sharing his/her desktop anytime by clicking the stop sharing button.

2.5.5 Administrative mode
Administrative mode and all its features can currently only be enabled on Windows version of ISL Light.
Linux and Mac versions of ISL Light can enable administrative mode and all its features when the remote side
is using a Windows version of ISL Light.
Administrative mode enables the ISL Light user to see the secure desktop on Windows Vista (UAC), to see the
Windows login screen and to restart the remote computer. It also enables the user to send the Ctrl-Alt-Del key
sequence to the remote side. By default it is disabled and has to be requested by selecting this option from
Tools / Administrative mode menu:

For more info about this feature, please refer to this topic: Tools button - Administrative mode
2.5.6 Restart and resume
In order to switch users, to restart the remote computer and return to the session afterwards (i.e. to continue
working on the remote computer after a reboot), you need to enable the restart and resume option. Before
enabling restart and resume, you need to enable administrative mode first. Ig you have not done so yet, please
refer to this topic: Administrative mode
Important notice for guest accounts: When ISL Light is started from a guest account or from an account
with group policy that deletes all temporary folders after a logout, restart and resume will not work. Restart and
resume will create files that will have to be in specific locations even after a restart or a user logoff. In such
cases, please change the ISL Online starting location (as described in the ISL FAQ, answer GEN-41) to a
folder that is not affected by the computer restart and/or logoff and is writable by all users.
Having enabled the administrative mode, open the Tools menu, go to the Administrative Mode / Enable Restart
and Resume:

For more info about this feature, please refer to this topic: Tools button - Administrative mode
2.5.7 File Transfer
When an ISL Light session is established between an operator and a client, files can be transferred in both
directions: from the operator's computer to the client's computer or the other way around. One or more files or
folders can be transferred between the 2 computers. ISL Light supports two options to transfer files:
Drag the file/folder and drop it on the ISL Light user interface.
Click the right button on the circular toolbar:

Select the file(s) or folder(s) you wish to transfer.

The other side is asked to either Open the transferred files/folders, Save them or Cancel the file transfer
altogether. The transferred files/folders can either be saved to the desktop (by default) or to the chosen
folder.
2.5.8 Audio Communication
Audio communication is currently not available on Linux and Mac versions of ISL Light.
You need to have a headset in order to use the audio plugin.
Click the top button on the circular toolbar to start audio communication.

To stop audio communication, press the top button on the circular toolbar again.

To stop streaming your audio, press the local PAUSE button in the bottom audio toolbar of your user
interface.
To stop receiving the client's audio, press the remote PAUSE button in the bottom audio toolbar of your user
interface.
To start streaming your audio after pausing it, press the local PLAY button in the bottom audio toolbar of your
user interface.
To start receiving the client's audio after pausing it, press the remote PLAY button in the bottom audio toolbar
of your user interface.
2.5.9 Video Communication
Video communication is currently not available on Linux and Mac versions of ISL Light.
You need to have a webcam in order to use the video plugin.
Click the bottom button on the circular toolbar to start video communication.

To stop video communication, click the bottom button on the circular toolbar again.

To stop streaming your video, press the local PAUSE button in the bottom video toolbar of your user
interface.
To stop receiving the client's video, press the remote PAUSE button in the bottom video toolbar of your user
interface.
To start streaming your video after pausing it, press the local PLAY button in the bottom video toolbar of your
user interface.
To start receiving the client's video after pausing it, press the remote PLAY button in the bottom video toolbar
of your user interface.
2.5.10 Session Recording

Session recording is currently not available on Linux and Mac versions of ISL Light.
In order to start recording a session, you need to load the Recording plugin first. Please right-click the settings
icon and select "Recording", then "Load Plugin".

When you wish to start recording the current session, right-click the settings icon again and select "Recording",
then "Start".

Remote user will be asked to confirm this action.
If the remote user agrees to recording the session, local user will be presented with a dialog to specify a
location for the recordings.
Chat window will show a message that the recording has started ("Desk started recording.").
To stop recording the session, right-click the settings icon again and select "Recording", then "Stop". The local
user will be presented with a notification about the file name of the recorded session and given an option to

view it using the ISL Recording Player.
If the user selects View, ISL Recording Player is started from the ISL Online webpage immediately. User can
manually start the ISL Recording Player by right-clicking the settings icon, selecting "Recording", then "Start
Player".
Same session recording menu is also accessible from the ISL View's Tools menu.
2.5.11 Remote Printing

Remote printing is currently not available on Linux and Mac versions of ISL Light.
Remote printing allows you to share printer on either side of the connection (ISL Light Desk or ISL Light Client)
and print on it from the remote machine.
Important: If one or both of the computers are running a 64-bit version of Windows Vista or newer (e.g.
Windows Server 2008), you might receive an error that the remote printer cannot be started due to a problem in
splwow64.exe in 64-bit Windows:
Currently this is the only workaround for this situation:

1. As administrator, close all 32-bit programs that are using the printer.
2. As administrator, open Task Manager and kill the s p l wo w6 4 . e x e process.
Please follow these steps to use the remote printing feature:

1. Click the settings button.

2. Select the Remote Printing, check the option to share printer with the other side, select the desired printer
and click OK.

Important: The other side (in this case, the ISL Light Client) needs to have administrator rights in order to
install the ISL Remote Printer driver. Please note that once ISL Remote Printer driver is installed on a machine,
administrator rights are not required for remote printing.
3. You will see a notification in the chat area about the enabled remote printing on the printer you chose in the
previous step.

4. You can open the list of printers and faxes on the other side and you will see that there is ISL Remote Printer
in the list.

5. As an example, you can open Notepad on the remote side and write a simple text for testing purposes.

6. Select File -> Print, then select ISL Remote Printer from the list and click Print.

7. You will see a notification in the chat area about the print job being sent to the other side. After a few
moments, you will see another notification about the print job being received on the other side.

8. Print job will be processed and printed on the remote printer.
2.6 Exit ISL Light
By exiting an ISL Light session, you will not be able to connect again without a new session code and the
client's approval.
To exit an ISL Light session, click the Disconnect button (left of the circular toolbar) or click the Close button
in the top right corner of the user interface


ISL Light 3.3 Manual Manual 62
3 Manual
This manual describes ISL Light in detail. Everything within this chapter applies to both hosted service users
and server licence users. When there is a difference for server licence users, a special note will be added and
the user will be able to go to the appropriate server licence topic by clicking the link provided.
Example:
Server licence users: The procedure for server licence differs from the procedure for hosted service users
- please go to this topic for more information.
Please click here to go to the topic that describes usage and options of ISL Light that are specific for server
licence users.
This manual is divided into the following sections:

How ISL Light works
ISL Light GUI
Create a session
Join a session
Chat
Desktop Sharing
Audio and Video
Session recording
Remote printing
File Transfer
Restarting into safe mode
User Management
Reports
Exit ISL Light
Settings
Customization
Web page integration
3.1 How ISL Light works
ISL Light (ISL stands for Internet Services Layer) is a secure and affordable way to remotely deliver technical
assistance to your customers or employees anywhere in the world. Without any installations or configurations
of local or remote computer, ISL Light support sessions are started in a matter of seconds. View your client's
desktop, control their keyboard and mouse, transfer files and enhance your communication using the
integrated audio and video plug-in. You can use ISL Light to remotely support your clients, train them, give
online sales presentations, and collaborate with partners, by means of just a few clicks. ISL Light is used for 1-
to-1 type of connection, where one operator connects to one client. In case you need 1-to-many type of
connection, please try another ISL Online product - ISL Groop. It is included in your ISL Online licence (What is
all in one?), so you can use it without any additional expenses. Please go to our ISL Groop website for more
information on ISL Groop.

To establish a remote desktop support connection between an operator and a client, you don't need to install
or configure anything. The operator only needs to run the ISL Light Desk application, and the client runs the ISL
Light Client application. Both can start the applications from the ISL Light website or can download the ISL
Light Desk and/or ISL Light Client application to a computer and run it from there. The ISL Light Desk and ISL
Light Client applications can also be published on your company's website or any other website. In this case
the ISL Light users should be instructed to start or download the application from there.
The connection between the computers is established via the internet in just 4 quick steps:
Operator (local computer):

1. Start ISL Light Desk and click Get code.
2. Obtain a session code by entering the username and password and tell the code to the Client.
Client (remote computer):

3. Start ISL Light Client and enter the code.
4. Click Connect.
ISL Online offers two user models

ISL Light is a part of ISL Online and there are two user models available.
Using ISL Online as a Hosted service (ASP Subscription or PayPerUse Coupon), a secure connection is
established through the ISL Grid - ISL Online's massive network of servers worldwide.
Therefore, you don't need to install or configure anything. Once registered with us, you are able to connect to a
remote computer and immediately put every single first-class ISL Light feature to profitable use.
Server License allows you to set up your own ISL Conference Proxy server (or a grid of servers) and use it as a
connecting point for ISL Online products instead of our ISL Grid. You should be familiar with network and server
administration in order to install and configure it properly. If you wish to use the Server License, please visit our
Knowledge Center to learn how to setup the ISL Online system in your company.

Supporting your clients with exceptional efficiency

Whichever model you choose, you will be able to:
Connect to any computer without installations or configurations
View the client's desktop and control a remote computer.
Reduce your support costs and shorten resolution time.
Use industry standard SSL with 256-bit end-to-end encryption.
Obtain a recorded session data or account history through the reporting system.
ISL Light entries

ISL Light requires no installation, but it uses certain locations to store temporary data and user settings.
Please refer to the appropriate section depending on your operating system for a list of such locations.
Window s
$ HOME\ Ap p l i c a t i o n Da t a \ I SL On l i n e Ca c h e \ I SL L i g h t De s k \ y - used for saving the
extracted ISL Light Desk aplication, $ HOME represents user's home directory, e.g. C: \ Do c u me n t s a n d
Se t t i n g s \ j o h n , y is an integer number that represents the program instance
$ HOME\ Ap p l i c a t i o n Da t a \ I SL On l i n e Ca c h e \ I SL L i g h t Cl i e n t \ y - same as above, but
for ISL Light Client
$ HOME\ Ap p l i c a t i o n Da t a \ I SL On l i n e Ca c h e \ I SL Pl u g i n s - used for storing ISL Light
plugins
$ HOME\ Ap p l i c a t i o n Da t a \ I SL On l i n e Ca c h e \ I SL Ne t wo r k St a r t - used for saving the
extracted ISL Network Start application
HKEY_ CURRENT_ USER\ So f t wa r e \ XL AB\ XL AB I SL L i g h t - registry entries used for storing ISL
Light settings
HKEY_ CURRENT_ USER\ So f t wa r e \ XL AB\ XL AB I SL Pl u g i n s - registry entries used for storing ISL
Light plugin settings
HKEY_ CURRENT_ USER\ So f t wa r e \ I SL On l i n e - registry entries used for storing ISL Network Start
preferences
Linux
$ HOME/ . x l a b - used for saving user preferences and downloaded plugins, $ HOME represents user's
home directory, e.g. / h o me / j o h n
/ t mp / I SL On l i n e Ca c h e _ x _ 0 / I SL L i g h t De s k / y - used for saving the extracted ISL Light Desk
application, x is your user ID (you can see your user ID by typing i d - u in a terminal window), y is an
integer number that represents the program instance

/ t mp / I SL On l i n e Ca c h e _ x _ 0 / I SL L i g h t Cl i e n t / y - same as above, but for ISL Light Client

Note that the / t mp directory gets cleared on most systems at system boot and/or shutdown, so there is
generally no need to do it manually.
Mac OS X
$ HOME/ . x l a b - used for saving user preferences and downloaded plugins, $ HOME represents user's
home directory, e.g. / Us e r s / j o h n
/ t mp / I SL On l i n e Ca c h e _ x _ 0 / I SL L i g h t De s k / y - used for saving the extracted ISL Light Desk
application, x is your user ID (you can see your user ID by typing i d - u in a Terminal - Applications -
Utilities - Terminal), y is an integer number that represents the program instance
/ t mp / I SL On l i n e Ca c h e _ x _ 0 / I SL L i g h t Cl i e n t / y - same as above, but for ISL Light Client
3.2 ISL Light GUI
ISL Light comprises of two parts - ISL Light Desk (intended for the operator) and ISL Light Client (intended for
the customer). Since ISL Light Desk's primary task is to lead the session, its graphical user interface is tailored
for this purpose - it is equipped with a circular toolbar to control desktop sharing, file transfer, audio and video
features.
This is a short description of common ISL Light Desk / Client graphical user interface elements:
ISL Light Desk / Client window menu button: apart from standard menu button functionalities there are
additional options:
o Language
o Settings
Settings button: invokes session options
Settings button (right-click) starts instant settings menu:
o Log
o Language
Translations
o Advanced
Set Normal Priority
Set High Priority
Enable Debug Log
o Settings option
Exit session button to stop the session; ISL Light Desk and ISL Light Client applications remain running
Send text button to send chat text
Send text button (right-click) with short menu options:
o Send text to chat
o Send text to ISL Conference proxy

Apart from these elements, ISL Light Desk has a circular toolbar to control the session. It is divided into four
sections:
o Desktop sharing button
o Audio button
o File transfer button
o Video button
These sections represent the functions that are executed through plugins. If a plugin is not available, the outer
border of the plugin button is colored orange:

Apart from circular toolbar, the basic functionality of ISL Light Client is the same as ISL Light Desk:

3.3 Create a session
The operator (using ISL Light Desk) must obtain a session code. A session code consists of 5 to 8 digits and
is provided through the startup and verification process of ISL Light Desk and then passed to the remote client
to start the ISL Light session.
It involves two steps:

1. Starting ISL Light Desk
2. Getting the session code
Please continue to the first step: Starting ISL Light Desk.
3.3.1 Starting ISL Light Desk
Hosted service users usually start the ISL Light Desk from the official website www.islonline.com by pressing
the ISL Light Desk download button in the middle of the page. When the operator clicks this button, operator's
operating system is automatically detected and an appropriate latest version is offered for download. If the
operating system cannot be automatically determined, the operator is asked to select the appropriate version.
There are also several other possible locations for ISL Light Desk executables:
Somewhere on the hard disk or local network, if previously downloaded.
Archives on the ISL Online webpage (http://www.islonline.com/en/downloads.htm), where the current and
previous versions of executables are saved. Please note that archive links are pointing directly to the
program executables, while "Download" button firstly downloads the special installer program (called "net
start"), which always downloads the latest version of ISL Light.
Custom selected webpages, where the programs are published.
These are the basic instructions for starting ISL Light Desk using Microsoft Windows, Mac OS X and Linux. For
more information on web page integration, please refer to the Web page integration chapter.
Window s (instructions for Internet Ex plorer)

After clicking the download button on the official website www.islonline.com, you are presented with a choice to
Run the file, Save it or Cancel the procedure. Select Run and you will be presented with a security warning
about the software - it will state the name (ISL Light Desk.exe) and publisher of the software (XLAB D.O.O.) and
give you a choice to either Run or Don't Run. Select Run and ISL Light Desk window will appear.
Mac OS X (instructions for Safari)

After clicking the download button on the official website www.islonline.com, Safari's Downloads window is
shown and a file ISL_Light_Desk_x_y_z is downloaded (where x.y.z is the version number). Please follow the
appropriate procedure depending on your OS X version:
Mac OS X 10.4.x (Tiger)
After the download has finished, you will be presented with a dialog informing you that

ISL_Light_Desk_x_y_z.app is an application and asks you if you are sure you want to download it. Select
Dow nload and an icon called ISL_Light_Desk_x_y_z will be placed on your desktop. Double-click that icon
and ISL Light Desk window will appear.
Mac OS X 10.5.x (Leopard), 10.6.x (Snow Leopard)
After the download has finished, open your Downloads folder and double-click the ISL_Light_Desk_x_y_z
file. Another way is to double-click the file in Safari's Downloads window. It will open a notification window
informing you that it is an application that was download from the internet and whether you are sure you
want to open it. Select Open and ISL Light Desk window will appear.
Linux (instructions for Firefox )

After clicking the download button on the official website www.islonline.com, Firefox offers you a Zip archive
ISL_Light_Desk_x_y_z.zip (where x.y.z is the version number) and asks you whether you want to open or save
the file.
If you choose Save File, save it to some convenient location (e.g. Downloads or Desktop), then open it.
If you choose Open w ith then it should open in your default archive manager.
Once the archive is opened, extract the binary file to some convenient location (e.g. Downloads or Desktop),
then run it (single or double-click the ISL Light Desk binary, depending on your window manager settings) and
ISL Light Desk window will appear.
Please continue to the second step: Getting the session code.
3.3.2 Getting the session code
When the ISL Light Desk main window is shown, press the Get code button and enter your username and
password for obtaining a session code. You can also check the "Save password" option. Press the OK button
when finished:

The session code appears:
Tell the session code to your client (via telephone, e-mail, SMS etc.). The client should then enter the session
into ISL Light Client and request connection. Wait until the connection is established.
Hosted service users can change the username for obtaining the session code and add or delete users
through ISL Online Account. Please refer to this chapter for more information: Login to ISL Online account.
Server licence users: For more information on user management, please refer to the User management

topic.
Please continue to the Join a session chapter.
3.4 Join a session
User on the remote side should start the ISL Light Client application and enter the session code provided by
the operator.
It involves two steps:

1. Starting ISL Light Client
2. Entering the session code
Please continue to the first step: Starting ISL Light Client.
3.4.1 Starting ISL Light Client
Hosted service users usually start the ISL Light Client from the official website www.islonline.com by pressing
the ISL Light Client download button in the middle of the page. When the client clicks this button, client's
operating system is automatically detected and an appropriate latest version is offered for download. If the
operating system cannot be automatically determined, the client is asked to select the appropriate version.
There are also several other possible locations for ISL Light Client executables:
Somewhere on the hard disk or local network, if previously downloaded.
Archives on the ISL Online webpage (http://www.islonline.com/en/downloads.htm), where the current and
previous versions of executables are saved. Please note that archive links are pointing directly to the
program executables, while "Download" button firstly downloads the special installer program (called "net
start"), which always downloads the latest version of ISL Light.
Custom selected webpages, where the programs are published.
These are the basic instructions for starting ISL Light Client using Microsoft Windows, Mac OS X and Linux. For
more information on web page integration, please refer to the Web page integration chapter.
Window s (instructions for Internet Ex plorer)

After clicking the download button on the official website www.islonline.com, you are presented with a choice to
Run the file, Save it or Cancel the procedure. Select Run and you will be presented with a security warning
about the software - it will state the name (ISL Light Client.exe) and publisher of the software (XLAB D.O.O.) and
give you a choice to either Run or Don't Run. Select Run and ISL Light Client window will appear.
Mac OS X (instructions for Safari)

After clicking the download button on the official website www.islonline.com, Safari's Downloads window is
shown and a file ISL_Light_Client_x_y_z is downloaded (where x.y.z is the version number). Please follow the
appropriate procedure depending on your OS X version:
Mac OS X 10.4.x (Tiger)
After the download has finished, you will be presented with a dialog informing you that
ISL_Light_Client_x_y_z.app is an application and asks you if you are sure you want to download it. Select
Dow nload and an icon called ISL_Light_Client_x_y_z will be placed on your desktop. Double-click that icon
and ISL Light Client window will appear.
Mac OS X 10.5.x (Leopard), 10.6.x (Snow Leopard)
After the download has finished, open your Downloads folder and double-click the ISL_Light_Client_x_y_z
file. Another way is to double-click the file in Safari's Downloads window. It will open a notification window
informing you that it is an application that was download from the internet and whether you are sure you
want to open it. Select Open and ISL Light Client window will appear.
Linux (instructions for Firefox )

After clicking the download button on the official website www.islonline.com, Firefox offers you a Zip archive
ISL_Light_Client_x_y_z.zip (where x.y.z is the version number) and asks you whether you want to open or save
the file.
If you choose Save File, save it to some convenient location (e.g. Downloads or Desktop), then open it.
If you choose Open w ith then it should open in your default archive manager.
Once the archive is opened, extract the binary file to some convenient location (e.g. Downloads or Desktop),
then run it (single or double-click the ISL Light Client binary, depending on your window manager settings) and
ISL Light Client window will appear.
Please continue to the second step: Entering the session code.
3.4.2 Entering the session code
ISL Light Client starts, requesting the session code. Enter the code provided by the operator (the operator
obtains a code using ISL Light Desk) and press the Connect button:

If the Client computer does not have a keyboard, right-click the settings button and a short settings menu will
appear:
Select the Show Touch Pad option and a clickable numeric keyboard for entering a session code will appears.
You can enter the session code by clicking on the buttons and then pressing the Connect button in the ISL
Light Client GUI:

The connection is established immediately. This is indicated by the change of ISL Light Desk and Client
graphical user interfaces. GUI on both sides is set to "Chat" mode with short description of the session status:
While ISL Light Client GUI shows no other significant info, the ISL Light Desk GUI presents some additional
information about the connection status:

short functionality instructions

server ID through which the session is established and controlled
ASP Subscription Expiration date (only if using hosted service)
amount of available minutes on the PayPerUse Coupon (only if using hosted service and if purchased a
coupon)
3.5 Chat
The chat option is active throughout the ISL Light session, independent from the other options (Desktop
sharing, Audio & Video, File transfer). The text should be typed into the chat window and is sent to the system
when pressing the "Return" key or "Send text" button. It is then displayed on both sides and clearly marked with
a leading text "Desk" or "Client" , depending on the side that has generated it.
In ISL Light chat, the following options are supported:

Single and multiple line text. The words are being wrapped at the end of the line and text is continued in a
new line without being sent to the opposite side until the user presses "Return" key or "Send text" button.
Inserting links. Internet links can be inserted using a simple copy / paste operation. They are pushed to the
opposite side when the text is sent.
Copying and clearing the chat history can be done by right-clicking on the chat history area.
Sending text to ISL Conference proxy can be achieved by right-clicking the "Send text" button.

The chat history is saved and can be viewed in the report option within your ISL Online account.
Server licence users: The chat history procedure for server licence differs from the procedure for hosted
service users - please go to this topic (the "Send chat transcripts" option) for more information.
Some notifications are automatically displayed in the chat history window when a certain event happens or
when a feature is (de)activated, e.g.:
Desktop viewing is requested
Desktop viewing is started or stopped
Desktop control is allowed or disabled
The connection is lost or gained back
Reconnecting
Connection is inactive
Desktop is switched to the administrative mode
...

ISL Light chat closes when the ISL Light session is terminated.
3.6 Desktop Sharing
This chapter describes ISL Light features that are related to desktop sharing. Please select the desired topic:
How to start View / Show desktop
Region and Application sharing
Viewing the Remote Desktop
Control of the Remote Desktop
Size, refresh and colors
Whiteboard
Tools button
Tools button - Administrative mode
Sending Ctrl-Alt-Del
Selecting remote monitor
3.6.1 How to start View / Show desktop
When a session is established between an operator and a client, the operator can view client's desktop or
show his or her own desktop to the other side. The Operator and the client may also choose to share only one
application or a region instead of the whole desktop.
To start the desktop viewing please perform the following:

Press the "Start desktop sharing" (left) button on the circular toolbar

Request to "View" the client's desktop or press "Show" to show your desktop to the client.
On the remote side the desktop view should be confirmed by pressing the "Show" button. Note: at this stage,
the opposite side may allow only region or application sharing by pressing the "Downarrow" button:

The ISL View window appears after the confirmation:
If the "Enable keyboard and mouse control" is checked, then the desktop view (ISL View) starts in the control
mode, otherwise it starts in the view mode and the operator does not have control over the client's desktop.
When in control mode, "Enable remote desktop control" button and "Request Control" button are disabled.
Since ISL Light Client's user interface does not include the circular toolbar, it is not possible to request to
show the local desktop or view the remote desktop. This action can only be initiated by ISL Light Desk.
To close the ISL View, simply press the "Start desktop sharing" (left) button of the Circular toolbar again or the
ISL View "Close" button at the upper right corner of the ISL View window. Client side can also press the
button on desktop view toolbar to stop the desktop View.

3.6.2 Region and Application sharing
Streaming side can choose to limit the view of the screen to a region or to a single application at the beginning
of the viewing procedure. Having pressed the "Left" button of the circular toolbar the user is presented with a
choice to either View or Show . At this point, streaming side should select the "down arrow" option:
Having selected this option, a screen with active applications and additional Region option appears:
Request to Choose an application and then choose the application you wish to Show to the other side.
When an application is selected, it will appear on the remote computer surrounded with a frame. No other
application are visible by using this option:

When the user selects the Region option, a frame with the selected area appears. Remote view is limited by
this frame. Streaming side can change the size and position of the frame during the session by dragging the
frame from the bottom right corner:


3.6.3 Viewing the Remote Desktop
Remote desktop is shown in the "ISL View" window:
Apart from the toolbar, the following options are available:
ISL View w indow menu button:

Connection info provides information about the remote computer name and some other technical details
About VNC provides information about VNC as a part of ISL Light
These two options are only available in the Windows version of ISL Light.
Closing the desktop View

To stop viewing, simply press the Close button at the upper right corner of the ISL View window. You will be
prompted to confirm the action and if you press the OK button, ISL View will be closed:
3.6.4 Control of the Remote Desktop
While pressing the Request Control button starts the short grant control procedure, right-click on the button
invokes a menu with two options:
Request remote control
Request remote control in compatibility mode

Having requested control, the other side is prompted to confirm it. The control is granted when the Ok button is
pressed.
The confirmation changes the red text local user has control on the streaming side toolbar to green remote
user has control and establishes control:
Streaming side has several options to terminate the control:

Mouse movement on the streaming side immediately regains control. If the mouse is not moved anymore,
the control is granted back to the viewer's side after 3-4 seconds.
Revoke control button permanently disables control. If the control is terminated this way, a new request (or
grant by the streaming side) is necessary to acquire it again.
Stop sharing button disables screen sharing and control.
If the control is started in compatibility mode, both sides have control of the remote desktop. Moving the mouse
of the viewed side thus has no effect on control. To stop the compatibility mode control, the streaming side
should either press F12 key, revoke control button or stop sharing button.
By pressing the grant control button on the streaming side toolbar, the streaming side can grant control to the
viewing side without a confirmation procedure. This button changes its functionality to revoke control option
after the control has been allowed.

The only way for the client to disable control is to terminate the desktop streaming.
3.6.5 Size, refresh and quality
Resizing ISL View window using toolbar buttons

Increase the size of the viewing window. The edges and the contents of the window will be increased by
each click on the button
Decrease the size of the viewing window. The edges and the contents of the window will be decreased by
each click on the button.
Set the zoom to automatically fit the w indow . The contents of the window will fit the current window size by
pressing this button once. Window's size remains unchanged.
Set the zoom to one-to-one ratio. The contents of the window will fit to exact size of the remote desktop.
The size of the window can simply be changed by dragging the bottom right corner of the window:

By pressing the Tools button and then Zoom options, a "Full screen" option appears. By selecting it, the
desktop stream is shown across the whole screen, without the frame and toolbars. Press <Ctrl> <Esc> keys
on the keyboard to exit the Full Screen option.
"Full screen" option is currently not available on Linux and Mac versions of ISL Light.

Requesting screen refresh

By pressing this button you request the transfer of the whole screen, not just the changed parts of the screen. It
may help refresh the screen if parts of it become garbled or do not automatically refresh properly for some
reason.
The figure in the right side of the streaming side toolbar shows the percentage of transmitted screen update.
When you press the "Request screen refresh button", it will go to 0% and then back up towards 100% while the
whole screen is being refreshed:
Changing quality
You can adjust the quality by adjusting the codec used, number of colors. ISSC stands for Internet Screen
Sharing Codec and it includes several color depth options, operation modes and quality settings.
There are two main groups here, first group uses ZRLE and the second group uses a combination of ZRLE
(lossless compression) and JPEG (lossy compression).
Apart from color depth, ISSC offers two modes - dual and triple.
Dual mode: If the size of the update using JPEG compression is less than half the size using ZRLE
compression, a JPEG-compressed update is sent, otherwise a ZRLE-compressed update is sent.
Triple mode: Same as dual mode, but after a second, ZRLE-compressed updates of previously sent JPEG-
compressed updates will be sent. This means that JPEG artifacts will clear as the ZRLE updates arrive.
The last parameter is quality setting for JPEG compression, you can choose either 60% or 15%.
There are two preset values, one is called best quality (this means 64k colors, ISSC triple @60%) and the
other is called high speed (this means 256 colors, ZRLE). High speed is the default value, but you can mark

the checkbox when starting desktop sharing and use best quality instead. Naturally you can change quality at
any moment when viewing the remote screen.
New ISSC options are currently not available on Linux and Mac versions of ISL Light.
You can change these settings either by pressing the "Change color depth button" or using the "Tools" menu
and selecting "Color depth".
The higher the color depth, the higher the bandwidth usage. Screen refresh is faster if less colors are
selected.
3.6.6 Whiteboard
The communication is further enhanced by visual pointing. When desktop is shared using ISL Light, the
operator can use the client's desktop as a whiteboard: draw a pointer, use a red marker to circle or underline
something. If the "Enable keyboard and mouse control" check box is not set when starting desktop streaming,
the whiteboard is automatically enabled.

The settings for whiteboard are placed in the top toolbar of the desktop streaming window (ISL View). There are
several options:
Start w hiteboard :
If you are not in a remote desktop control mode, the line mode of the Whiteboard is set by default and the
Enable whiteboard / Freehand draw ing button is pressed. By pressing the Enable whiteboard / Pointer tool
button, the freehand mode is switched to pointer mode. The "Enable remote desktop control" button is
disabled if not in the desktop control mode.
In desktop control mode, the Enable whiteboard / Freehand draw ing or Enable whiteboard / Pointer tool
button should be pressed to switch from Desktop control mode to the Whiteboard. The Enable remote
desktop control button is enabled when having control and should be pressed to switch back from
Whiteboard mode to Remote desktop control mode:

Erasing Whiteboard
Beside automatic erasing of the whiteboard when returning to the remote desktop mode, the whiteboard can
be erased by pressing the Erase Whiteboard button. If this button is right-clicked, a menu for setting the erase
options appears. There are three options available:
5 seconds (the whiteboard will be erased in 5 seconds after it has been drawn)
10 seconds (the whiteboard will be erased in 10 seconds after it has been drawn)
manual (the whiteboard will be erased when the button is pressed)
3.6.7 Tools button
Pressing the tools button on the right side of the ISL View window toolbar invokes a menu with the following
options:

Refresh view window

Screen to clipboard (copies the contents of ISL View to the local clipboard)
Request control
o Request remote control
o Request remote control in compatibility mode
Select remote monitor
o Desktop (shows the whole desktop, i.e. all enabled displays)
o Monitor #n (shows only the desired monitor)
Please note that if the remote computer does not have more than 1 display, this option is not shown in the
tools menu.
Whiteboard tools
o Erase whiteboard
o Freehand
o Pointer
o Switch to control
Zoom
o Decrease View window size
o Increase View window size
o Fit to screen
o One-to-one ratio
o Full screen
Color depth

o Full color
o Auto
o Hi (64k colors)
o Medium (256 colors)
o Low (64 colors)
o Very low (8 colors)
Keyboard
o Send Ctrl-Alt-Del
o Send Lock (WIN-L)
o Keyboard layout
Local (default)
Remote (compatible)
Administrative mode
o Enable
o Enable Restart and Resume
o Send Ctrl-Alt-Del
Recording
o Load plugin
o Start
o Stop
o Start player
Most of the ISL View Tools menu offers the same functionality as the ISL View toolbar buttons, but there are a
few additions that are available only through the Tools menu:
Select remote monitor (please go to the Selecting remote monitor chapter for more information)
tools menu.
Zoom
o Full screen (desktop stream is shown across the whole screen, without the frame and ISL View toolbar.
Press <Ctrl><Esc> keys on the keyboard to exit the Full Screen mode)
Keyboard
o Send Ctrl-Alt-Del (please go to the Sending Ctrl-Alt-Del chapter for more information)
o Send Lock (WIN-L) (sends the WIN-L key combination to the remote side)
o Keyboard layout
Local (default) (keyboard events are sent to the remote side in Unicode mode)
Remote (compatible) (keyboard events are sent to the remote side in non-Unicode mode - if you intend
to send some non-standard keyboard shortcuts in non-Unicode mode, please switch to this option)
Administrative mode (please go to the Tools button - Administrative mode chapter for more information)

3.6.8 Tools button - Administrative mode
Administrative mode is divided into two parts - the first part is to enable the administrative mode, the second
part is to enable the restart and resume functionality. This chapter will describe the procedure for enabling both
parts.
Administrative mode enables the ISL Light user to see the secure desktop on Windows Vista (UAC), to see the
Windows login screen and to restart the remote computer. It also enables the user to send the Ctrl-Alt-Del key
sequence to the remote side. By default it is disabled and has to be requested by selecting this option from
Tools / Administrative mode menu:
If the streaming side has administrative privileges, only a confirmation is required:

If the streaming side does not have administrative privileges (i.e. logged in with a normal user), a different ISL
Light dialog appears, offering the streaming side to enter the username and password of a user with
administrative privileges or to ask the remote user to enter the username and password.
If the streaming side enters the username and password and presses the OK button, administrative mode is
enabled.
If the streaming side selects the option to ask the remote user to enter the username and password and
presses the OK button, the following ISL Light dialog is shown at the viewing side:

The viewing side can now either enter the username and password of a privileged user or choose to enter it in
the UAC dialog (if the streaming side is running Windows Vista).
Usernames with blank passwords are not allowed to be entered in the ISL Light option. Users with such
usernames should use the UAC login form.
If the viewing chooses to use the UAC dialog, a window similar to the following picture appears:
After entering the password, the ISL Light desktop stream is switched to administrative mode and a notification
is added to the chat history window.

The viewing side can now send the Ctrl-Alt-Del sequence key to the remote side using the option in the Tools
menu:
Administrative mode can be enabled even if the viewing side does not have control, but control is required
in order to send the Ctrl-Alt-Del (or any other) key sequence.
In order to switch users, to restart the remote computer and return to the session afterwards (i.e. to continue
working on the remote computer after a reboot), you need to enable the restart and resume option.
Important notice for guest accounts: When ISL Light is started from a guest account or from an account
with group policy that deletes all temporary folders after a logout, restart and resume will not work. Restart and
resume will create files that will have to be in specific locations even after a restart or a user logoff. In such
cases, please change the ISL Online starting location (as described in the ISL FAQ, answer GEN-41) to a
folder that is not affected by the computer restart and/or logoff and is writable by all users.
Open the Tools menu, go to the Administrative Mode / Enable Restart and Resume:

The streaming side will display a dialog that explains the restart and resume functionality and it can either be
approved (by clicking the YES button) or rejected (by clicking the NO button):
If the streaming side confirms the restart and resume functionality activation, a notification is added to the chat
history window.
The viewing side can now switch users (it allows him to see the login screen and select the desired user - see
the picture below) as well as restart the remote computer and return back to the session after a restart.
Important: In an environment where a Web Proxy is used, ISL Light and ISL AlwaysOn use Internet Explorer
connection settings. Since ISL AlwaysOn as well as ISL Light with restart and resume enabled run under
system account, they use Internet Explorer settings for the system account. It might happen that Internet
Explorer settings have not been set for the system account. Please refer to the section Checking system
account connection settings for instructions.

3.6.8.1 Checking system account connection settings
Please follow these steps:

1. Open Connection Tester from this link under user account with administrative privileges:
http://www.islonline.net/download/ConnectionTester?branch=any&stable_since=2009%2d03%2d26
2. Run connection test. In an environment with a Web Proxy the Connection Tester application uses WinInet
library to connect.
3. Open Settings and click on Run and Quit button for running Connection Tester under system account:

4. Run connection test. Connection Tester should show failure when connecting in an environment with a Web
Proxy and without updated Internet Explorer settings.
5. In case of failure, please open settings and click on the Open button for opening Internet Explorer connection
settings.

6. Copy settings in LAN Area Settings dialog from your account to the system account.


3.6.9 Sending Ctrl-Alt-Del
The Ctrl-Alt-Del sequence can be sent to the remote computer if the desktop sharing is running in the
administrative mode. Press the "Tools" button in the ISL View toolbar and then select Administrative mode /
Send CTRL-ALT-DEL option.
Please note that the remote control should be set, otherwise sending the key sequence has no effect.
Important: If you are using Desktop Control plugin version 1.2.3 or newer, no special configuration is
required for sending Ctrl-Alt-Del. If you are using an older version, please follow the instructions for older
versions.
Important for users of older versions of Desktop Control plugin (version low er than 1.2.3): If the remote
computer is running Windows Vista, you need to follow a special procedure in order to enable the sending of
CTRL-ALT-DEL. Please follow the section below: Enable the sending of CTRL-ALT-DEL on Windows Vista
Important for users of older versions of Desktop Control plugin (version low er than 1.2.3): If the remote
computer is running Windows Server 2008, please follow the section Enable the sending of CTRL-ALT-DEL on
Windows Vista below, as well as make sure that you have enabled UAC (User Account Control), otherwise it
will not work.
Enable the sending of CTRL-ALT-DEL on Windows Vista
Important: If you are using Desktop Control plugin version 1.2.3 or newer, sending Ctrl-Alt-Del works
automatically and you do not need to follow the instructions below. Users of older versions, please continue
reading.

Windows Vista introduced a new group policy setting which controls whether or not software can simulate a
Secure Attention Sequence (SAS). An example of such SAS is the CTRL-ALT-DEL combination. This policy
needs to be enabled In order for ISL Light to send CTRL-ALT-DEL to the remote machine running Windows
Vista. You will only need to do this once for a certain remote computer.
Important: Since Window s Vista Home Basic and Window s Vista Home Premium do not have the Group
Policy Object Editor, you will not be able to send CTRL-ALT-DEL to machines running those versions of
Windows Vista.
If the remote computer is running Window s Vista Business, Window s Vista Enterprise or Window s Vista
Ultimate, please continue with the procedure below.
There are two ways of setting the needed group policy setting, depending on whether the remote computer is
connected to a domain or is a member of a workgroup. Please follow the appropriate section depending on
your setup.
Note that you will not need to reboot the remote machine after following the steps below - the changes will
take effect immediately.
Domain procedure (change domain group policy setting)

If the remote computer is connected to a domain, the domain administrator can enable this group policy setting
for subdomains or for the entire domain. Please follow these steps:
Important: Only a domain administrator can modify the domain group policy!
Important: The domain group policy overrides the local group policy! If the domain group policy is not set,
you can use local group policy setting mentioned in the next section.
1. Login to the remote computer as the domain administrator.
2. Click the Start Window s button, select Run, type g p mc . ms c and press enter.
3. In the left section, select the desired domain, then right-click and choose Create a GPO in this domain, and
link it here.
4. RIght-click the new GPO and select Edit.
5. In the left section, please navigate to:
Computer Configuration - Administrative Templates - Window s Components - Window s Logon
Options
6. In the right section, please double-click on the Disable or enable softw are Secure Attention Sequence
policy and click on Enabled.
7. Set the policy option to either Services or Services and Ease of Access applications.

8. Click OK and close the Group Policy Object Editor.

You have now enabled the sending of Ctrl-Alt-Del on all computers that are connected to the domain you
selected in step 3.
Workgroup procedure (change local group policy setting)

If the remote computer is a member of a workgroup or is connected to a domain with no domain group policy
set, you should follow these steps:
1. Login to the remote computer as a local or domain administrator.
2. Click the Start Window s button, select Run, type g p e d i t . ms c and press enter.
3. In the left section, please navigate to:
Computer Configuration - Administrative Templates - Window s Components - Window s Logon
Options
4. In the right section, please double-click on the Disable or enable softw are Secure Attention Sequence
policy and click on Enabled.
5. Set the policy option to either Services or Services and Ease of Access applications.

6. Click OK and close the Group Policy Object Editor.

You have now enabled the sending of Ctrl-Alt-Del on the remote computer.
3.6.10 Selecting remote monitor

If a remote computer has more than one monitor, then the default mode (unless the remote user uses the
"down arrow" option and selects only the desired display/application/region) is to show the whole desktop, i.e.
all enabled displays. In some cases you wish to limit your view to only one display - this can be accomplished
using an option in the tools menu (Tools - Select Remote Monitor).

tools menu.
3.7 Audio and Video
This chapter describes ISL Light features that are related to audio and video communication. Please select the
desired topic:
Audio
Enable Remote Audio
Video
3.7.1 Audio Overview
Audio plugin is currently not available on Linux and Mac versions of ISL Light.

To start an audio session the operator and the client must be connected through the ISL Light. Click the Audio
(top) button of the Circular toolbar to start it:
The ISL Light Desk / ISL Light Client are extended with the audio user interface at the bottom part of GUI. They
are identical for both sides (with the exception of the colour). If set in settings, local audio stream starts
immediately. The Audio button on the Circular toolbar is glowing in light blue color to demonstrate the activity.
The button should be pressed to start the remote Audio stream:

When the remote stream is requested, confirmation on the other side is mandatory:
To stop audio, press the Audio button of the Circular toolbar again.
Some other Audio stream options:
To stop streaming your audio, press the Local Pause button in the audio toolbar of your user interface.
To stop receiving the client's audio, press the Remote Pause button in the audio toolbar of your user
interface.

To start streaming your audio after pausing it, press the Local Play button in the audio toolbar of your
user interface.
To start receiving the client's audio after pausing it, press the Remote Play button in the audio toolbar of
your user interface.
Please note that you will need a headset to use the audio connection. The operating system settings of the
headset should be configured properly.
3.7.2 Enable Remote Audio
To enable the transfer of audio from a remote PC you will need to enable the Stereo Mix setting on the remote
PC's sound settings. To do this follow this short guide below:#
First you need to establish the connection to the remote machine to do this refer to the Create a session guide.
1. Start a remote desktop session.
2. Go to Start>Control Panel>Sound
3. Locate the Recording tab. You should see Stereo Mix on the list of devices, if you do not see it, right click
anywhere on the background to this box to bring up a menu which you need to select Show Disabled
Devices.

4. Apply changes by clicking OK.
5. Enable the audio plugin in ISL Light

6. Start Audio stream for the both Local and Remote User by pressing the Play button on the bottom of the ISL
Light GUI (the Remote user will receive a message asking to confirm the start of audio streaming).
Everything that is played on the remote machine will now be passed through to the supporters machine.
3.7.3 Video Overview
Video plugin is currently not available on Linux and Mac versions of ISL Light.
To start a video session, the operator and the client must be connected through the ISL Light. Click the Video
(bottom) button of the Circular toolbar to start it:

The ISL Light Desk / ISL Light Client are extended with the video user interface at the bottom part of GUI. As for
audio, they are identical for both sides (with the exception of the color). If set in settings, local video stream
starts immediately. If audio communication is already running, the video interface is placed on top of the audio
interface:

When the remote stream is requested, confirmation on the other side is mandatory:
To stop video press the BOTTOM button of the CIRCULAR TOOLBAR again.
Some other video stream options:
To stop streaming your video, press the Local Pause button in the video toolbar of your user interface.
To stop receiving the client's video, press the Remote Pause button in the video toolbar of your user
interface.
To start streaming your video after pausing it, press the Local Play button in the video toolbar of your user
interface.
To start receiving the client's video after pausing it, press the Remote Play button in the video toolbar of
your user interface.
By a double-clicking it, the Video window can be detached to a separate window. At the desk side, the Video
window can also be separated when ISL Light Client is minimized. By right-clicking the Video window, a menu
of Video Stream Quality settings appears.
When setting the quality of the remote side video display, the value cannot be set higher then the quality of
the remote streaming.
3.8 Session recording
Session recording plugin is currently not available on Linux and Mac versions of ISL Light.
Session recording plugin allows you to record a session - it records the contents of chat history window and
ISL View window. A recording is saved in a .isr file that can be opened and viewed using the ISL Recording
Player. There is an option to export a session recording file into the AVI format.
In order to start recording a session, you need to load the Recording plugin first. Please right-click the settings
icon and select "Recording", then "Load Plugin".

When you wish to start recording the current session, right-click the settings icon again and select "Recording",
then "Start".

Remote user will be asked to confirm this action.
If the remote user agrees to recording the session, local user will be presented with a dialog to specify a
location for the recordings.
Chat window will show a message that the recording has started ("Desk started recording.").
To stop recording the session, right-click the settings icon again and select "Recording", then "Stop". The local
user will be presented with a notification about the file name of the recorded session and given an option to

view it using the ISL Recording Player.
If the user selects View, ISL Recording Player is started from the ISL Online webpage immediately. User can
manually start the ISL Recording Player by right-clicking the settings icon, selecting "Recording", then "Start
Player".
Same session recording menu is also accessible from the ISL View's Tools menu.
3.9 Remote printing
Remote printing is currently not available on Linux and Mac versions of ISL Light.
Remote printing allows you to share printer on either side of the connection (ISL Light Desk or ISL Light Client)
and print on it from the remote machine.
Important: If one or both of the computers are running a 64-bit version of Windows Vista or newer (e.g.
Windows Server 2008), you might receive an error that the remote printer cannot be started due to a problem in
splwow64.exe in 64-bit Windows:
Currently this is the only workaround for this situation:

1. As administrator, close all 32-bit programs that are using the printer.
2. As administrator, open Task Manager and kill the s p l wo w6 4 . e x e process.
Please follow these steps to use the remote printing feature:

1. Click the settings button.

2. Select Remote Printing, check the option to share printer with the other side, select the desired printer and
click OK.

Important: The other side (in this case, the ISL Light Client) needs to have administrator rights in order to
install the ISL Remote Printer driver. Please note that once ISL Remote Printer driver is installed on a machine,
administrator rights are not required for remote printing.
3. You will see a notification in the chat area about the enabled remote printing on the printer you chose in the
previous step.

4. You can open the list of printers and faxes on the other side and you will see that there is ISL Remote Printer
in the list.

5. As an example, you can open Notepad on the remote side and write a simple text for testing purposes.

6. Select File -> Print, then select ISL Remote Printer from the list and click Print.

7. You will see a notification in the chat area about the print job being sent to the other side. After a few
moments, you will see another notification about the print job being received on the other side.

8. Print job will be processed and printed on the remote printer.
Disabling the printer sharing

To stop sharing a printer with the other side, open the settings dialog, select the Remote Printing entry,
uncheck the option to share a printer, then click OK.

You will see a notification in the chat area:

If the remote side tries to print using the ISL Remote Printer while the printer is disabled, it will receive the
following error:
Uninstalling/reinstalling the ISL Remote Printer

Important: To install, uninstall or reinstall the ISL Remote Printer driver, a user needs to have
administrator rights. Please note that once ISL Remote Printer driver is installed on a machine, administrator
rights are not required for remote printing.
Open the settings dialog, select the Remote Printing entry, then check the option to show advanced options.

If you select Uninstall Driver, it will remove the ISL Remote Printer driver from the system.
If you select Reinstall Driver, it will install the ISL Remote Printer driver and make sure everything is set up
correctly. Users generally do not need to use the reinstall option, it is included only for cases where the ISL
Remote Printer driver gets corrupted and needs to be installed again.
Manually uninstalling the ISL Remote Printer
To manually delete the ISL Remote Printer, please follow these steps:
1. Open Printers and Faxes (accessible through Start -> Settings -> Printers and Faxes or through Start ->
Settings -> Control Panel -> Printers and Faxes).
2. Select ISL Remote Printer and press the Delete key (or click Delete this printer), then confirm the deletion of
the ISL Remote Printer.
3. Click File -> Server Properties, go to the Ports tab.
4. Scroll down and you will see ISLPrintingPort. Select it, click the Delete Port button and confirm the deletion.
5. Go to the Drivers tab and you will see ISLPrintingDriver. Select it, click the Remove button and confirm the
deletion.
6. Click Close.
You have now deleted everything related to the ISL Remote Printer from the system.

3.10 File Transfer
When an ISL Light session is established between an operator and a client, files can be transferred in both
directions: from the operator's computer to the client's computer and vice versa. One or more files or folders
can be transferred between the computers. ISL Light supports two methods of file transfer:
using Drag and Drop
using the File transfer folder
Windows Vista currently does not support Drag & Drop for transferring files between different levels of
processes. If you are a Windows Vista user, please continue to the File transfer folder chapter.
Otherwise, please continue to Drag and Drop chapter.
3.10.1 Drag and drop

To transfer the file, drag the file with the left mouse button into the ISL Light graphical user interface until the
cursor arrow with a cross sign appears and then drop it:

The other side is asked to either Open the transferred files/folders, Save them or Cancel the file transfer
altogether. The transferred files/folders can be either saved to the desktop (by default) or to the chosen folder.
Check the box to set the currently chosen folder as a default value. You can also pause the transfer (press the
Pause button) and adjust file transfer's bandwidth usage (press the down-arrow next on the Pause button, then
select the desired limit or set it to unlimited).

If the file already exists in the destination folder, it is saved in the same folder with a changed name - a number
in brackets is added to the file name:
3.10.2 File transfer folder

Please use this option if operator's or client's computer is running Windows Vista.
To start file transfer, click the right button on the circular toolbar:

The user can choose to Send or to Receive files:
A file transfer folder is opened. Select the files you wish to transfer and press the Open button.
In case the Receive option has been selected, file transfer folder is opened at the remote computer.

Alternatively if you are sending files/folders to a computer on a regular basis you can select the Try to
synchronize option (highlighted in red in the screen shot above).
Instead of the files/folders being resent to the computer it will skip duplicate files/folders. However if you have
made changes to the particular files then once the transfer takes place, it will notice the changes made in the
files and put a (1) at the end of the file name that is sat on the destination PC.
For example if you send Test.txt to c:\isl\file transfer, then edit and resend, it will rename the original Test.txt
to Test(1).txt and the new version of the file will replace Test.txt
Once you select Try to synchronize and click Open it will give you the option to select the destination of where
you want to save the file/folder.
Click "Save" to start the file synchronization.

Click Open and the folder will open on screen.
The file transfer should be confirmed as described in the Drag and Drop section.
3.11 Restarting into safe mode
No special scripts are needed for restarting into safe mode and you should simply follow these simple steps
on the remote computer:
1. Run ms c o n f i g .
2. Click the BOOT.INI tab.
3. Click the checkbox next to / SAFEBOOT and select NETWORK on the right.
4. After clicking OK you will have the option to restart immediately or exit without restart (in this case, manually
restart later).
5. After restarting, the computer will go into safe mode with networking and the session will resume
automatically.
6. Perform the desired actions in safe mode.
7. When done, run ms c o n f i g .
8. In the General tab, select Normal Startup - load all device drivers and services.
9. After clicking OK you will have the option to restart immediately or exit without restart (in this case, manually
restart later).

10.After restarting, the computer will go into normal mode and the session will resume automatically.
3.12 User Management
User administration for hosted service users is available within your ISL Online account. Please login to your
ISL Online account (refer to this topic for instructions) and go to Hosted service - users.
There are two modes of user administration available - simple administration (default) and advanced mode.
Simple administration is the default mode and it includes only one user - this user's username is the same as
the ISL Online account e-mail address. The following options are available:
Change password (use it to change the user password - note that this password is independent from your
ISL Online account password)
Forgot password (use it to resend the user's password to the user's e-mail address)
Change contact (use it to change user's name and e-mail address)
Advanced mode allows creation and administration of multiple users within your ISL Online Domain (e.g.
mycompany). To register an ISL Online Domain, please follow the link Register Your ISL Online Domain. You
can add a new user or change settings for the existing user(s). The following options are available:
Change password (use it to change the user password - note that this password is independent from your
ISL Online account password)
Forgot password (use it to resend the user's password to the user's e-mail address)
Change contact (use it to change user's name and e-mail address)
Delete user (use it to delete a user)
Limitations (enable or disable a user, limit the number of concurrent sessions, enable or disable certain
plugins)
Customizations (change customization settings for this user - please refer to the Customization chapter for
more information)
If you click on Preferences, you have the following options available:

personal info (view your ISL Online account's contact information)
change info (change your ISL Online account's contact information)
change password (change your ISL Online account's password)
change email (change your ISL Online account's e-mail address)
Please note: if the advanced mode is enabled, users must enter their ISL Online Domain in front of their
username, with two leading backslashes. The separator between the ISL Online Domain and a username is a
single backslash. Example: \ \ I SL On l i n e Do ma i n \ u s e r n a me .
Warning: "Back to simple administration" option deletes your ISL Online Domain and all users within this
domain!

3.13 Reports
Reports for hosted service users are available within your ISL Online account. Please login to your ISL Online
account (refer to this topic for instructions) and go to Hosted service - reports.
The following options are available:

Session lists - ISL Light (takes you to the ISL Light session history with all the information, e.g. date and time
of session start, session code used, session duration, desk and client versions, desk and client IP
addresses, chat transcript etc.)
Usage - Active connections (takes you to the report that displays the connection average and the connection
maximum over a certain period)
Usage - PayPerUse (takes you to the PayPerUse coupon usage history)
Account - History (takes you to the account history, showing all account activities - e.g. account type
changes, activation keys that were activated, e-mail address changes etc.)
All report data can be filtered and exported to a CSV file.
Server licence users: Session history is available within your ISL Conference Proxy administration
(Activity monitor - Sessions - History - ISL Light). You can export session history by following these steps:
1. Go to http://localhost:7615/ and select the Login link in the top right corner.
2. Enter the desired username (username format \\domain\user) and password, then click Login.
3. Click the ISL Light entry on the left.
4. You will see a list of last 10 sessions. Click More and you will be able to specify the desired time range.
5. Click Export table as XML to export search results in XML format.
Server licence users: Server licence account history is available within your ISL Online account under
Server licence - history.
3.14 Exit ISL Light

There are several ways to exit ISL Light. Both sides (ISL Light Desk and Client) can request to stop running the
application (by pressing the "Close window" button) or to just terminate the current session (by pressing the
"Disconnect from the session" button):

When disconnecting from the session (not closing the application!), the ISL Light applications remain active.
Operator (ISL Light Desk) can request the new session code simply by pressing the Get code button - there is
no need to perform a new login procedure.
There is an option to add custom dialogs to ISL Light. Please refer to the Using session dialogs chapter for
more information.
3.15 Settings
The general settings button is located at the top left side of ISL Light Desk and ISL Light Client graphical user
interface. Beside that button there are also some other settings entry points. They lead to the general settings
dialogs or serve to provide additional settings that are not included in the general settings menu.
The purpose of this chapter is mainly to describe the general settings. Additional settings are described only if
they are not presented in the other parts of this manual.
Please select the desired topic:

Settings locations
General

Desktop Sharing
File transfer
Video
Audio
Recording
3.15.1 Settings locations

Different types of settings can be accessed at the following locations:
ISL Light Desk / Client graphical user interface

Window menu button (language, settings)
Settings menu button (general access to ISL Light settings)
Right-click settings menu button (log, open remote log, language, advanced settings)
Right-click video window if video is active (video quality settings)

Right clicking the Window Menu brings up a sub menu as shown below.

You can stop the ISL Light Desk window from always appearing on top of your other programs by unticking the
Set Window Topmost option.
Separate video w indow

Right-click the separate Video window (video quality settings)

ISL View w indow

Right-click reguest control button (type of the remote control)
Right-click erase whiteboard button (whiteboard erasing time settings)
Tools button (ISL View Window settings, keyboard layout, administrative mode, restart & resume, sending
Ctrl-Alt-Del key sequence)

3.15.2 General
When the settings are selected through any of the options (the most common way is to use the "Settings"
button in the upper left corner of the ISL Light Desk / Client GUI) the main settings window appears:

Other settings (Desktop Sharing, File transfer, Video, Audio and Recording) are available after the plugins
have been loaded - with ISL Light Desk, this is after obtaining a session code; with ISL Light Client, this is after
entering a session code and having successfully connected to a session.
In the middle of the screen you can find the program name, version, compilation time and revision number.
There are also two links - the first takes you to the copyright an licence information page while the second link
takes you to the ISL Light manual page (this manual). Below the links there is a list of available server plugins -
loaded plugins have a word (loaded) next to their version number.
Under General settings the following parameters can be set or viewed:
Connect to
Information about the server address that ISL Light Desk or Client uses to connect. Cannot be changed.
Selected Language
The ISL Light Desk / Client GUI language. Language change only affects the local side and is in effect until
program termination. When a new session is started, the language is determined on the basis of regional
settings (e.g. on Windows - Control panel "Regional and Language options" settings).
Enable MTU fix

This setting is intended for solving problems with the unusual size of DSL packets. A higher MTU (Maximum
Transmission Unit) brings higher bandwidth efficiency. Some DSL connections have different MTU packet size
than usual communication protocols. Slowing down the connection is one of the symptoms of such behavior.
Sometimes the problem can be solved by changing the "Enable MTU fix" option to one of the following:
Slow
Slowest
Initially, the value is set to Normal mode. The setting is valid for the current session only.
Log
By pressing the "Log" button an ISL Light Desk / Client Debug log is opened in the appropriate program:
Windows: Notepad
Linux: gedit or kate
Mac OS X: TextEdit
Its information is useful to the ISL Support team to help the product users. By checking the "Enable debug log"
option and then pressing the "Log" button again, Log is expanded with additional information. In front of the
colon sign the origin of the event is inserted for easier debugging. Some examples:
reliable channel
dialog
rptSafeChannel thread...
Once "Enable debug log" is checked, it cannot be switched off until a new session is established.
Please note: Debug log can contain http proxy authentication username and password. Delete them from
the log if you do not want the third parties to see them when you are sending the log somewhere.
Remote information
By pressing Remote information you will initiate the system information gathering action at the remote
computer. This can take a while, so please be patient. After the process completes, msinfo will open and it will
contain remote computer's information.
3.15.3 Desktop Sharing

After the desktop sharing plugin has been loaded, you can access its settings using the Desktop Sharing
option on the left.

Enable Console w indow Updates

If the Enable console w indow updates box is checked, the console window is also presented in a separate
w indow , outside of the ISL View window.

If the settings have been changed during the session, some minor actions should be taken to allow the system
to perceive the change:
If the Enable console w indow updates box was checked when the client desktop was shared, <Enter> key
should be pressed within the console window in order to start showing the ISL Console Window to the
viewing side.
If a console window has been running before starting the desktop sharing session, ISL Console Window
should appear after a the streaming side has given focus to the console window (by clicking the mouse
inside the window).
Otherwise cmd screen appears after the cmd command on the streamed side is executed.

If "Enable console window updates" box is checked during the desktop sharing, an <Enter> keyboard entry on
Viewed side must be done in CMD window to make it disappear from the viewer's screen. <Ctrl><C> button
can also be pressed to close the window.
Please note: By default, this option is set to "No" (not checked). The setting must be set at the side, which is
receiving the desktop stream.
Transfer transparent w indow s (use CAPTUREBLT flag for server updates)
Set this setting at the viewed side. As is it evident from the name of the setting, it is used for enabling /
disabling the transfer of transparent windows. It is also used in situations when the mouse cursor on the
viewed window is not seen (problem has occurred mainly in some Citrix/RDP environments).
Remove desktop background w hen streaming

Use this option to remove desktop background when streaming. This option is checked by default. If you
uncheck this option, it can have a noticeable impact on performance since more data will need to be
transferred when a window is moved.
The system remembers desktop sharing settings.
3.15.4 File transfer

After the file transfer plugin has been loaded, you can access its settings using the File transfer option on the
left.

Put file(s) in folder
The user can set the default destination folder for file transfers. It can also be changed during any file transfer in
the file transfer dialog by choosing an another folder and checking the Save as default checkbox. If the selected
folder is not accessible, the operators are informed during the file transfer. The system remembers the
selected option.
3.15.5 Video
Video plugin is currently not available on Linux and Mac versions of ISL Light.
After the file video plugin has been loaded, you can access its settings using the Video option on the left.

Video Input device

You can select a video input device from the drop-down list.
Recording Quality
Select the desired recording quality from the drop-down list.
Local Video Test

Use it to test local video settings.
The system remembers video settings.

3.15.6 Audio
Audio plugin is currently not available on Linux and Mac versions of ISL Light.
After the audio plugin has been loaded, you can access its settings using the Audio option on the left.
Please note: Audio settings can also be set or audio can be disabled or enabled in the default Windows
settings.
Play test sound button

Use it to test the selected playback device.
Record test sound button

Use it to test the selected recording device.
Device for sound playback

You can select a playback device from the drop-down list. The playback volume can be adjusted using the
Volume slider.
Device for sound recording

You can select a recording device from the drop-down list. The following options are available:
Noise reductions: option for removing noise from the audio signal.
Guess speech: automatically detects the speech - decreases the amount of unnecessary data to be
transferred through the ISL Light connection
Auto adjust microphone volume
Auto adjust software gain
Acoustic echo cancel
Set high process priority w hen connected

Use this option to set a higher process priority for the audio process compared to other running processes in
Windows.
The system remembers audio settings.
3.15.7 Recording
Session recording plugin is currently not available on Linux and Mac versions of ISL Light.
After the session recording plugin has been loaded, you can access its settings using the Record option on
the left.

Recordings directory
The user can set the default destination folder for file transfers. It can also be changed during any file transfer in
the file transfer dialog by choosing an another folder and checking the Save as default checkbox. If the selected
folder is not accessible, the operators are informed during the file transfer. The system remembers the
selected option.
Start view er
Click the Start button in order to download and start ISL Recording Player.
The system remembers session recording settings.
3.16 Customization

You can customize ISL Light to your needs. Customization is divided into basic and expert.
Basic customization includes:
adding your company logo to ISL Light
adding session dialogs (program startup, start of session, end of session)
command line arguments
Expert customization includes:

custom port settings
branch parameters
...
This chapter shall focus on basic customization - for more information about customization settings, please
contact us via e-mail at support@islonline.com or come to our live chat (simply go to http://islonline.com/ and
click the Chat Live button in the top-right corner of the page).
Adding a company logo
Using session dialogs
Command line arguments
Changinng program skin and texts
3.16.1 Adding a company logo

In order to add a company logo, please perform the following procedure:

1. Prepare a file with your company logo - it should be in BMP format, with image width up to 80 and image
height up to 80.
2. Send an e-mail to support@islonline.com with the following format (do not forget to attach the file with the
logo!):
subject: Ho s t e d s e r v i c e - a d d l o g o <y o u r c o mp a n y n a me >
body: Pl e a s e a d d o u r c o mp a n y l ogo ( at t ac hed) t o our ac c ount <y o u r I SL
On l i n e a c c o u n t e - ma i l >.
attachment: <y o u r c o mp a n y l o g o i n t h e a b o v e me n t i o n e d f o r ma t >
We shall create a new customization for you and reply to your e-mail with the instructions on how to use it as
soon as possible.

3.16.2 Using session dialogs

Hosted service users can add a simple end-of-session (EOS) dialog to ISL Light Desk, ISL Light Client or both.
End-of-session-dialog is a simple text input form that is displayed to the user of ISL Light Desk, ISL Light Client
or both (depending on the settings) at the end of each ISL Light session. User can type in comments regarding
the latest session (session purpose, client's problem, if / how it was resolved etc.). The End-Of-Session dialog
is saved for each session and can be viewed in the Session list within your ISL Online account.
Simple end-of-session dialog looks like this:
You can enable or disable simple end-of-session dialogs for a specific user (scroll to the desired user and
click change next to Customizations option) or in general, so that it applis to all users (scroll to the main ISL
Online user user and click change next to Customizations option).
If you have any questions regarding session dialogs or if you would like to customize the end-of-session-
dialog, please contact us via e-mail at support@islonline.com or come to our live chat (simply go to http://
islonline.com/ and click the Chat Live button in the top-right corner of the page).
3.16.3 Command line arguments

Behaviour of ISL Light Desk and ISL Light Client programs can be customized by using command line
arguments when starting the program.
The main purpose of command line arguments is to provide a way to integrate ISL Light Desk and ISL Light
Client into other systems. You could also use command line arguments for some specific tasks, such as:
make Windows shortcut on your desktop or in your quick launch bar to start ISL Light Desk with a specific
username and password - automatic code retrieval
create a web link to automatically start streaming desktop, audio and video when an ISL Light Client

connects
use a custom logo which is already installed on the computer
create a custom integration in other software
ISL Light supports two types of command line arguments:

simple (these were introduced in ISL Light version 2 and offer basic functionality such as specifying a
username and password, getting a session code etc.)
complex (these were introduced in ISL Light version 3.0.3 and offer more advanced functionality - it is
possible to define when, who and what should be executed)
Both types can be used simultaneously.
This topic is divided into four parts:

Simple command line arguments (description of simple command line arguments)
Complex command line arguments (description of complex command line arguments)
How to use them (description of possible ways of specifying command line arguments)
Examples (some examples to get you started)
3.16.3.1 Simple command line arguments
Let us begin with a simple example:

I SL L i g h t De s k . e x e - - g e t - c o d e - - u s e r n a me d e mo - - p a s s wo r d d e mo
Save ISL Light Desk executable to a certain directory on your disk, open the Command Prompt (cmd) and type
in the above line. It will start ISL Light Desk executable in the current directory and automatically obtain a
session code using the username d e mo and password d e mo .
Please refer to the following list for a detailed description of simple command line arguments:
- - aut o- c l os e This option instructs ISL Light Desk or ISL Light Client
to close the program after the ISL Light session has
ended.
- - c onnec t <c o d e > This option specifies a session code for ISL Light
Client. When ISL LIght Client starts, it automatically
tries to connect with the provided session code.
- - get - c ode This option instructs ISL Light Desk to automatically
request a session code upon program startup.
Obtained session code is then stored in the file
c o d e _ f i l e . i s l . You can specify this file's location
with the option - - o u t p u t - f i l e .
- - out put - f i l e This option specifies the location of the
c ode_f i l e. i s l .
- - u s e r n a me This option is used to specify the username that

should be used for obtaining a session code.

- - p a s s wo r d This option is used to specify the password that should
be used for obtaining a session code.
- - not i f i c at i on- t hr ead <t h r d _ I D> [ - - Users that embed ISL Light Desk and ISL Light Client
n o t i f i c a t i o n - me s s a g e <ms g >] in their application (product) should use this option. To
specify windows message loop thread that will handle
ISL Light notifications and the message send to that
thread use option.
In case when no notification message is specified,
WM_USER is used. Notification messages are sent
from ISL Light with PostThreadMessage Window API
call. Parameter wParam is a bit-field that defines the
following ISL states:
0x00 - unconnected
0x01 - connecting with session code used in LPARAM
0x02 - connected
0x04 - streaming
0x40 - streaming with remote side having control
0x08 - receiving stream
0x10 - value of server ID in LPARAM
0x20 - value of session ID in LPARAM
0x8000 - error bit (lower portion of the code defines
error code)
- - s e s s i o n - me s s a g e Custom message can be stored in ISL Conference
 Proxy logs by using this option. This message can be
used for matching an ISL Light session ID with an
external user-defined session ID.
- - s i l ent When you specify this option, ISL Light will not ask for
confirmation when terminating a connection.
- - t ouc h- pad Use this option to open a touch pad on startup - useful
for cases when a keyboard is not available and a
touch-screen is used for input.
- - o p e n - a t - e n d <URL > This option instructs ISL Light to open the specified
URL at the end of a session.
- - l og- on- des k t op Saves log file to desktop instead of application folder.
- - mt u [ 0 , 1 , 2 ] Set communication MTU (maximum transmission unit)
in ISL Light Desk that will fix problems in some
environments that don't have correct value of MTU in
their network configuration. Value 0 means normal
MTU while value 2 will set smallest value - 100 bytes in
one IP packet.
- - a d d - t i t l e <t i t l e > Using this option you can add a string to ISL Light's title
bar - it will be "ISL Light Desk <title>" (in case of ISL
Light Desk) or "ISL Light Client <title>" (in case of ISL
Light Client).
- - f or c e- t r ans por t <t r a n s p o r t t y pe> Use this option to force a desired type of transport. The
following values are available for <t r a n s p o r t
t y p e >:
di r ec t

wi n i n e t - h t t p
wi n i n e t - h t t p s
wi n i n e t - h t ml
ht t pt - di r ec t
ht t ps - di r ec t
ht t pt - pr ox y
ht t ps - pr ox y
Important: Please note that this is an advanced
option and should only be used in specific situations. If
you experience any problems with your connection,
please come to our live chat or write an e-mail to
support@islonline.com - we will check the situation
and provide further instructions.
- - p r o x y - a d d r e s s <s e r v e r addr es s > Use this option to specify the desired server address
that should be used for connecting, e.g.
s e r v e r 1 3 . i s l o n l i n e . n e t for our Japanese
server.
option and should be used for troubleshooting
purposes only. Default connection address takes
advantage of our load balancing with many parameters
and automatically redirects you to the optimal server
(based on your location, our server load, our
optimizations etc.). If you experience any problems with
your connection, please come to our live chat or write
an e-mail to support@islonline.com - we will check the
situation and provide further instructions.
- - ht t pt - por t Use this option to specify the port that should be used
for connection (default is 7615 and should not be
changed unless instructed to do so by our technical
support team).
- - c o n n - o p t i o n s " <o p t i o n s >" Use this to pass special connect options such as http
proxy address, username, password. Example:
- - c onn- opt i ons
" h t t p _ p r o x y =1 . 2 . 3 . 4 &h t t p _ p r o x y _ u s e r =m
y u s e r &h t t p _ p r o x y _ p a s s wo r d =my p a s s "
option and should only be used in specific situations. If
you experience any problems with your connection,
please come to our live chat or write an e-mail to
support@islonline.com - we will check the situation
and provide further instructions.
3.16.3.2 Complex command line arguments
Each command line option is related to a specific event in ISL Light Client or ISL Light Desk program. ISL Light
support the following events:
load (triggered when ISL Light is loaded into memory and started)
join (triggered when ISL Light Desk requests and obtains a session code, i.e. joined a session)

connect (triggered when a connection is established between ISL Light Desk and ISL Light Client)
disconnect (triggered when a session is finished)
Join event is only available for ISL Light Desk.
You can connect certain actions with certain events - the syntax of complex command line arguments is:
- - o n - <e v e n t > <a c t i o n >
Action part must be in URL query format and is defined like this:
[ d e s t i n a t i o n _ mo d u l e ] <n a me 1 >=<v a l u e 1 >[ &<n a me 2 >=<v a l u e 2 . . . ]
d e s t i n a t i o n _ mo d u l e can be one of the following (please click on the module name for more information):
main (options for main ISL Light Client or ISL Light Desk window and general ISL Light program settings)
desktop (commands for the desktop sharing plugin)
file_transfer (commands for the file transfer plugin)
audio (commands for the audio plugin)
video (commands for the video plugin)
recording (commands for the recording plugin)
If you omit the destination module, a default value main is used.
3.16.3.2.1 Main module
Please refer to the following list for a description of available commands for this module:
e x p a n d =( a l wa y s | ma n u a l ) When you use e x p a n d =a l wa y s on connect event, it

will instruct ISL Light to always restore its window from
minimized/iconized state when a new event occurs, e.g.
chat is received.
When you use e x p a n d =ma n u a l on disconnect event,
it will instruct ISL Light not to restore its window from
minimized/iconized state when a session is
terminated.
s ma l l f o o t p r i n t Use this option to force a small footprint GUI instead of
the standard ISL Light dialog.
i c oni z e This command instructs ISL Light to switch into the
iconized state.
mi n i mi z e This command instructs ISL Light to switch into the
minimized state.
l o g o = This command instructs ISL Light to load a logo image
from an existing file on the computer or from an URL
address.
p o s =( [ c e n t e r | l e f t t o p | r i g h t b o t t o m| This command instructs ISL Light to place the main
r i g h t t o p | l e f t b o t t o m] [ ( <x >, <y >) ] ) window to a specific position. Parameters x and y
represent the offset towards the center of the desktop.
st i cky This command instructs ISL Light to restore the
specified position each time the window state changes
from minimized or iconized to restored.

o p e n _ u r l = This command instructs ISL Light to open the specified
URL in the default web browser.
p r i o r i t y =( n o r ma l | h i g h ) This command sets the ISL Light process priority to
normal or high.
t o p mo s t =f a l s e This command works for all events (usually it is used
on load event so that it is effective immediately when
ISL Light starts) and disables the window on top flag for
ISL Light.
3.16.3.2.2 Desktop sharing module
a d mi n [ =r e s t a r t ] When you use this command on connect event

combined with show desktop sharing, it will
automatically try to switch desktop streaming to
administrative mode.
If you specify a d mi n =r e s t a r t instead of just a d mi n ,
it will automatically try to switch desktop streaming to
administrative mode and enable the restart and
resume functionality.
s how When you use this command on connect event, it will
start desktop streaming.
v i ew This command instructs the ISL Light not to ask the
user if he wants to view the remote desktop.
c o n t r o l [ =( g r a n t | g r a n t F1 2 | d i s a b l e ) ] When you use this command on connect event, it
grants desktop control. The g r a n t F1 2 parameter is
used for granting control in the compatibility (F12)
mode. If you omit g r a n t or g r a n t F1 2 parameter, the
default value (g r a n t ) is used.
If you specify c o n t r o l =d i s a b l e , it is not possible to
control the remote computer, only view.
t o p b a r p o s =( l e f t | t o p | r i g h t | b o t t o m) This command is used to specify the location of the
desktop streaming bar - it can be on the left, top, right or
bottom side of the desktop.
Note: Desktop streaming bar can not be at the same
location as the Windows task bar (usually it is at the
bottom) - if you specify the same location, ISL Light will
choose an alternative location. On Windows 95,
Windows 98 and Windows Me you cannot set the
position of the desktop streaming bar to left or right.
h i d e t o p b a r =( t r u e | f a l s e ) If set to t r u e , the desktop streaming bar is not shown.
b l a c k =( t r u e | f a l s e ) This command (when set to t r u e ) instructs the ISL
Light to enable black screen when desktop is being
shared.
d i s a b l e l o c a l =( t r u e | f a l s e ) If set to t r u e , the local user cannot take control.
l e a v e b a c k g r o u n d =( t r u e | f a l s e ) If set to t r u e , desktop background is not removed
when streaming desktop.

c o l o r =6 4 k Use this option to switch to high quality mode (this

means 64k colors, ISSC triple @60%).
e v e n t s =s t r e a m_ s t o p _ c l o s e Stops the ISL Light session automatically when
desktop sharing is closed.
3.16.3.2.3 File transfer module
l o c a t i o n = Use this command to change the location where the
transferred files should be saved.
t r a n s f e r =[ <f i l e _ n a me 1 >[ ; <f i l e _ n a me 2 >. When you use this command on connect event, the file
..]] transfer plugin will start transferring the specified file(s)
- separate multiple filenames with semicolons.
3.16.3.2.4 Audio module
s t r eam When you use this command on connect event, it will

start streaming the local audio recording.
3.16.3.2.5 Video module
s t r eam When you use this command on connect event, it will

start streaming the local video recording.
3.16.3.2.6 Recording module
r e c o r d [ =s i l e n t , f o r c e ] When you use this command on connect event, it will

load the recording plugin, start it and ask the remote
user if he or she allows recording.
If s i l e n t or f o r c e is specified, the session will be
recorded without user consent.
If s i l e n t is specified, the user will not be offered to
view the recorded session after the session has
finished.
l o c a t i o n = Specify the default location where the recording files
will be saved. Environment variables can also be used.
Please use the following syntax for environment

variables - for variable name v a r i a b l e _ n a me use

$ [ v a r i a b l e _ n a me ]
Example for default path with computer name used in
the path:
l o c a t i o n =x : \ r e c o r d i n g s
\ $ [ COMPUTERNAME]
a l l o w_ s t o p =f a l s e This option will disable the user's ability to stop
session recording.
n a me <f i l e n a me >=$ [ HOST] - $ [ TI ME] You can define the file name for the recording. The
default is set to Host and Time. This can be changed
around depending on what criteria you wish to include
in the file name.
3.16.3.3 How to use them
Command line arguments can be entered in three different ways:

Command Prompt method
Windows shortcut method
URL method
Server licence users: There is another way of using command line arguments - as a part of a
customization. Please refer to this topic for more intormation.
3.16.3.3.1 Command Prompt method
This topic describes how to use MS Windows Command Prompt to start ISL Light with the desired command
line arguments. Please follow the procedure below:
1. Download ISL Light Desk and/or ISL Light Client to a directory on your hard drive (we will use c : \ i s l t mp
for this example).
2. Click Start - Run.
3. Enter either c md (Windows 2000 or newer) or c o mma n d (Windows Me or older) and press enter.
4. Go to the directory where you saved ISL Light Desk or ISL Light Client executable:
c d c : \ i s l t mp
5. Start ISL Light with the desired command line arguments, e.g.:
I SL L i g h t De s k . e x e - - o n - l o a d " ma i n ? p o s =r i g h t b o t t o m&s t i c k y "
3.16.3.3.2 Windows Shortcut method
This topic describes how to use a shortcut to start ISL Light with the desired command line arguments. Please
follow the procedure below:
1. Download ISL Light Desk and/or ISL Light Client to a directory on your hard drive (we will use c : \ i s l t mp
for this example).
2. Right-click on your desktop, select New and then Shortcut.

3. Select the location of the ISL Light Desk or Client executable - for this example, it is c : \ i s l t mp
\ I SL L i g h t De s k . e x e
4. Click Next.
5. You can change the name of the shortcut if you wish and then press Finish.
6. Now you need to edit shortcut properties - right-click on the shortcut you created and select Properties.
7. Append the desired command line arguments in the Target field and click OK.
8. You can run the program by double-clicking the shortcut.
3.16.3.3.3 URL method
This topic describes how to use a specially formatted URL to start ISL Light with the desired command line
arguments. The usual way to start ISL Light Desk is to use the following link:
http://www.islonline.net/start/ISLLightDesk
Server licence users: You should use the following link: http://localhost:7615/start/ISLLightDesk
To add command line arguments, append ? c md l i n e = to the link and then specify the desired arguments.
These arguments need to be URL encoded - you can use our URL encoding page: click here.
Step-by-step example:
1. Let us say we want to use the following command line arguments for ISL Light Desk:
- - get - c ode - - u s e r n a me d e mo - - p a s s wo r d d e mo - - on- l oad " ma i n ?
p o s =r i g h t b o t t o m&s t i c k y "
2. Copy and paste the command line arguments into our URL encoding page and click URL Encode. Copy and
paste the result (URL encoded text):
- - g e t - c o d e +- - u s e r n a me +d e mo +- - p a s s wo r d +d e mo +- - o n - l o a d +%2 2 ma i n %3 Fp o s %
3 Dr i g h t b o t t o m%2 6 s t i c k y %2 2
3. Append the URL encoded text to the original link, together with the ? c md l i n e = parameter, and you will have
created a working link:
h t t p : / / www. i s l o n l i n e . n e t / s t a r t / I SL L i g h t De s k ? c md l i n e =- - g e t - c o d e +- - u s e r n a me
+d e mo +- - p a s s wo r d +d e mo +- - o n - l o a d +%2 2 ma i n %3 Fp o s %3 Dr i g h t b o t t o m%2 6 s t i c k y %2 2
Server licence users: Your link will look like this: h t t p : / / l o c a l h o s t : 7 6 1 5 / s t a r t /
I SL L i g h t De s k ? c md l i n e =- - g e t - c o d e +- - u s e r n a me +d e mo +- - p a s s wo r d +d e mo +- - o n - l o a d +%
2 2 ma i n %3 Fp o s %3 Dr i g h t b o t t o m%2 6 s t i c k y %2 2
If you use a more advanced link to start ISL Light, e.g. http://www.islonline.net/start/ISLLightDesk?
platform=win32, the procedure is a bit different, since this link already includes parameters (parameters start
after the ? sign). You need to use &c md l i n e = instead of ? c md l i n e = and then follow it with the URL
encoded command line arguments, like in this example:
h t t p : / / www. i s l o n l i n e . n e t / s t a r t / I SL L i g h t De s k ? p l a t f o r m=wi n 3 2 &c md l i n e =- - g e t -
c o d e +- - u s e r n a me +d e mo +- - p a s s wo r d +d e mo +- - o n - l o a d +%2 2 ma i n %3 Fp o s %3 Dr i g h t b o t t o m%
2 6 s t i c k y %2 2
Server licence users: Your link will look like this: h t t p : / / l o c a l h o s t : 7 6 1 5 / s t a r t /
I SL L i g h t De s k ? p l a t f o r m=wi n 3 2 &c md l i n e =- - g e t - c o d e +- - u s e r n a me +d e mo +- - p a s s wo r d
+d e mo +- - o n - l o a d +%2 2 ma i n %3 Fp o s %3 Dr i g h t b o t t o m%2 6 s t i c k y %2 2

3.16.3.4 Examples
This section will provide a few examples to give you some usage ideas and get you started. It assumes that
you use the Command Prompt method - for other methods, please modify accordingly.
Start ISL Light Desk, automatically obtain a session code using username d e mo and password d e mo , as
well as store the obtained session code to a file c : \ c o d e . t x t (it will contain a session code and a
session id):
I SL _ L i g h t _ De s k . e x e - - g e t - c o d e - - u s e r n a me d e mo - - p a s s wo r d d e mo - - o u t p u t - f i l e
" c : \ c ode. t x t "
Start ISL Light Desk and set the company logo that is stored in h t t p : / / my - c o mp a n y - n a me . c o m/
f i l e s / c o mp a n y - l o g o . b mp :
I SL _ L i g h t _ De s k . e x e - - on- l oad " ma i n ? l o g o =h t t p : / / my - c o mp a n y - n a me . c o m/ f i l e s /
c o mp a n y - l o g o . b mp "
Start ISL Light Desk and position the main window in the top right corner, 150 pixels away from the right
border and 50 pixels away from the top border:
I SL _ L i g h t _ De s k . e x e - - o n - l o a d p o s =r i g h t t o p ( 1 5 0 , 5 0 )
Start ISL Light Desk and change the main window position on certain events - on load it is in the top left
corner with (150, 50) offset, having obtained a session code it moves to the top right corner with (150, 50)
offset, after establishing a connection with the client it moves to the bottom right corner with (150, 50) offset,
after terminating a session it moves to the bottom left corner with (150, 50) offset:
I SL _ L i g h t _ De s k . e x e - - on- l oad p o s =l e f t t o p ( 1 5 0 , 5 0 ) - - on- j oi n
p o s =r i g h t t o p ( 1 5 0 , 5 0 ) - - on- c onnec t p o s =r i g h t b o t t o m( 1 5 0 , 5 0 ) - - ondi s c onnec t
p o s =l e f t b o t t o m( 1 5 0 , 5 0 )
Start ISL Light Desk and open URL http://www.isllight.com on load. After establishing a connection, open
URL http://www.islonline.com:
I SL _ L i g h t _ De s k . e x e - - on- l oad " o p e n _ u r l =h t t p : / / www. i s l l i g h t . c o m" - - on-
c o n n e c t " o p e n _ u r l =h t t p : / / www. i s l o n l i n e . c o m"
Start ISL Light Desk and do not ask the user if he wants to view the remote desktop. Start ISL Light Client,
start desktop sharing on connect, try to enable the administrative mode and restart and resume functionality:
I SL _ L i g h t _ De s k . e x e - - o n - c o n n e c t " d e s k t o p ? v i e w"
I SL _ L i g h t _ Cl i e n t . e x e - - o n - c o n n e c t " d e s k t o p ? s h o w&c o n t r o l &a d mi n =r e s t a r t "
Start ISL Light Client and start transferring the file c : \ t r a n s f e r _ me . t x t on connect:
I SL _ L i g h t _ Cl i e n t . e x e - - on- c onnec t " f i l e _ t r a n s f e r ? t r a n s f e r =c :
\ t r a n s f e r _ me . t x t "
Start ISL Light Desk, open the dialog for obtaining a session code and automatically start recording to c :
\ r e c o r d i n g s on connect - the user is unable to stop session recording once it is started:
I SL _ L i g h t _ De s k . e x e - - get - c ode - - on- c onnec t " r ec or di ng?
r e c o r d =s i l e n t &l o c a t i o n =c : \ r e c o r d i n g s &a l l o w_ s t o p =f a l s e "
Stop and close the ISL LIght Client when client stops sharing desktop:

I SL _ L i g h t _ Cl i e n t . e x e - - o n - c o n n e c t " d e s k t o p ? e v e n t s =s t r e a m_ s t o p _ c l o s e "
Position ISL Light Desk.exe in the bottom right automatically after connection to client:
I SL _ L i g h t _ De s k . e x e - - o n - l o a d p o s =r i g h t b o t t o m( 1 5 0 , 5 0 )
Automatically create a recording to "C:/ISL/REC" once a connection has been established:

I SL _ L i g h t _ De s k . e x e - - on- c onnec t " r ec or di ng?
r e c o r d =s i l e n t @n a me =$ [ USERNAME] - $ [ L OCATI ON=C: / I SL / REC
3.16.4 Changing program skin and texts
Changing program skin and texts is currently not available on Linux and Mac versions of ISL Light.
There is a possibility to customize program skin and texts, with certain limitations. ISL Light GUI supports
customization of all bitmaps and all texts that are translatable (in ISL Light 3.2.0a all but text in settings). Please
note that the skin engine does not support positioning of controls. Keep in mind that this is the first version
that supports GUI customization and the procedure is not user-friendly, but it shall be improved in the future.
Important: Please note that in its current form, this customization procedure is not intended for the novice
users.
You can refer to these two customization samples, just to see what is possible:
Please download the following ZIP file: original_skin.zip

Extract the ZIP file to a certain location, e.g. c : \ my s k i n .
This file contains a few files, but they can be divided into three main sections:
1. s k i n _ d a t a . t x t - (this file contains instructions on how to draw bitmaps to a GUI)

2. c u s t o m_ t e x t s . i n i - (this file contains custom texts that will be used in a customized GUI - when a text is
defined within this file, the original translation is ignored)
3. <v a r i o u s b i t ma p f i l e s > - (images that are used by skin_data.txt)
Editing skin_data.txt
Skinning a particular dialog in ISL Light involves these two steps:
1. define (load) textire files
2. list BitBlt commands that will make the final dialog surface
Tex tures
A texture is loaded using the command t e x t u r e .
t ex t ur e [ i d_of _t ex t ur e] [ f i l e _ n a me . b mp ] [ wi d t h _ i ] , [ h e i g h t _ i ] [ wi d t h _ s ] ,
[ hei ght _s ]
String i d _ o f _ t e x t u r e will define this texture in all BitBlt commands and f i l e _ n a me . b mp must exist in
the skin zip package. Parameters wi d t h _ i and h e i g h t _ i define width and height of smallest image/sprite
in bitmap file in case the bitmap defines image list. Parameters wi d t h _ s and h e i g h t _ s define offset that is
used depending on drawn item state - e.g. buttons can be normal, focused, selected, pressed or disabled and
those states are drawn with the help of parameters wi d t h _ s and h e i g h t _ s . Special keywords Wi d t h and
He i g h t can be used - they define full width and height of a bitmap.
Examples:
# n o r ma l but t ons t hat a r e d r a wn d e p e n d i n g o n s t a t e c a n
#us e t he def i ni t i on bel ow
t e x t u r e 2 0 0 b t n - c t r l - d s k - s ma l l . b mp Wi d t h / 5 , He i g h t Wi d t h / 5 , 0
# Te x t u r e f o r t i t l ebar wi l l u s e t h e s y n t a x b e l o w.
# Th r e e s t a t e s d e f i n e Cl i e n t , De s k a n d g e n e r i c d i a l o g t i t l e b a r .
t e x t u r e 1 t i t l e b a r . b mp Wi d t h / 3 , He i g h t Wi d t h / 3 , 0
#I c ons i n t i t l ebar do not def i ne s pec i al s t at es , but t he i c ons

# a r e s t o r e d i n i ma g e l i s t
t e x t u r e 1 0 1 i k - e x i t . b mp Wi d t h / 4 , He i g h t 0, 0
BitBlt commands
Final look of a dialog is defined through a series (a batch) of Blt commands. Later commands can over-paint
previous commands.
Bl t [ d e s t i n a t i o n _ d i a l o g _ c o n t r o l _ b a t c h ] [ i d _ o f _ t e x t u r e ] [ Bi t | St r e t c h | Ce n t e r |
Al p h a ] [ d e s t i n a t i o n _ c o o r d i n a t e s ] [ s o u r c e _ c o o r d i n a t e s ]
Some additional keywords can be used with BitBlt commands - b mWi d t h and b mHe i g h t define texture's
width and height, Wi d t h and He i g h t define dialog/control's width and height.
Command Al i a s can be used to copy current batch of BitBlt commands of a particular dialog/control to a new

batch.
You can use the d e f i n e command to make the modification of the skin easier - you only modify a value in one
place and it reflects where ever it is used later on, e.g.:
d e f i n e BOFF 9
d e f i n e TOP_ OFF 2 8
Bl t nc a- dl g- nor m 2 St r e t c h Wi d t h - BOFF, TOP_ OFF, BOFF, He i g h t - BOFF- TOP_ OFF
b mWi d t h - BOFF, 0 , BOFF, b mHe i g h t - BOFF
Parameter d e s t i n a t i o n _ c o o r d i n a t e s contains x, y and width and height of the destination rectangle.

Parameter s o u r c e _ c o o r d i n a t e s contains x, y of the source rectangle. With Stretch block transfer wi d t h
and h e i g h t are also mandatory.
A batch definition for a dialog must be separated into two parts - a part that will draw the non-client area (the
batch name must start with n c a - ) and a batch that will draw the client area (name must start with c a - ).
The best way to start is to extract the contents of the default s k i n . z i p and make simple changes to certain
bitmaps, just to see how it all works. Then you can change certain entries in the s k i n _ d a t a . t x t file and
see the effects of those changes.
Please note: You need to keep the original image format of the bitmap files, e.g. 32-bit color depth - be
careful when making and saving your changes!
When you wish to see the effects of your changes, please continue to Testing and using skin customization
below.
Editing custom_texts.ini
First you should obtain the language files for the ISL Light and for all the plugins. You should start ISL Light
Desk and obtain a session code. Then look into the following files:
$ HOME\ Ap p l i c a t i o n Da t a \ I SL On l i n e Ca c h e \ I SL L i g h t De s k \ y \ t r a n s l a t i o n s
\ L a n g Al l . i n i - language file for the ISL Light main program, $ HOME represents user's home directory,
e.g. C: \ Do c u me n t s a n d Se t t i n g s \ j o h n , y is an integer number that represents the program
instance - if you only have one ISL Light Desk running at the moment, it should be 1)
$ HOME\ Ap p l i c a t i o n Da t a \ I SL On l i n e Ca c h e \ I SL Pl u g i n s
\ d e s k t o p _ x _ y _ z _ wi n 3 2 . t r a n s - language file for the desktop sharing plugin, x , y and z represent
the plugin version number, e.g. d e s k t o p _ 1 _ 2 _ 0 b _ wi n 3 2 . t r a n s )
\ f i l e _ t r a n s f e r _ x _ y _ z _ wi n 3 2 . t r a n s - language file for the file transfer plugin
\ a u d i o _ x _ y _ z _ wi n 3 2 . t r a n s - language file for the audio plugin
\ v i d e o _ x _ y _ z _ wi n 3 2 . t r a n s - language file for the video plugin
\ r e c o r d i n g _ x _ y _ z _ wi n 3 2 . t r a n s - language file for the recording plugin
Now you can add certain entries into the c u s t o m_ t e x t s . i n i using the same format as the files above.
Important: You must specify the desired alias for English language and for any additional language that
you need to. If the alias is not specified for English language, it will be ignored!
For example, let us say you want to change the following text

d s k _ d i s _ I DC_ DESCRI PTI ON_ TEXT=Ge t t h e s e s s i o n c o d e a n d t e l l i t

t o t he c l i ent .
in ISL Light Desk to
d s k _ d i s _ I DC_ DESCRI PTI ON_ TEXT=Ge t my c o mp a n y s uppor t c o d e and
t el l i t t o t he c l i ent .
Your c u s t o m_ t e x t s . i n i file would look like this:
[ en]
d s k _ d i s _ I DC_ DESCRI PTI ON_ TEXT=Ge t my c o mp a n y s uppor t c o d e a n d t e l l i t
t o t he c l i ent .
If you wish to change ISL Light Desk and ISL Light Client window title, you would use:
[ en]
g e n e r i c _ TI TL E_ DESK=My Co mp a n y De s k
g e n e r i c _ TI TL E_ CL I ENT=My Co mp a n y Cl i e n t
If you wish to change all I SL L i g h t texts to My Co mp a n y quickly (without having to browse through all
language files and check which aliases need to be changed), you can use this trick:
[ l i ght ]
c h a n g e =My Co mp a n y
Testing and using skin customization

You can test your skin customization through a special command line argument that is used to specify the
custom skin location:
- - s k i n- di r 
Please refer to the Command line arguments chapter for more information on how to use them.
E.g. if you have extracted the default skin.zip file to c : \ my s k i n :
I SL L i g h t De s k . e x e - - s k i n - d i r c : \ my s k i n
When you are happy with your customization, you need to create a ZIP file that contains all the needed files in
c : \ my s k i n directory (flat structure, no folders - i.e. s k i n _ d a t a . t x t , c u s t o m_ t e x t s . i n i and all
needed bitmap files) - let us say you name that ZIP file c u s t o m_ s k i n . z i p .
- please continue to this topic.
Hosted service users need to send an e-mail to support@islonline.com with the following format (do not forget
to attach the c u s t o m_ s k i n . z i p file!):
subject: Ho s t e d s e r v i c e - c u s t o mi z e s k i n a n d t e x t s <y o u r c o mp a n y n a me >
body: Pl e a s e c u s t o mi z e I SL L i g h t GUI s k i n a n d t ex t s f or our c o mp a n y .
Ou r a c c o u n t i s <y o u r I SL On l i n e a c c o u n t e - ma i l >.
attachment: <c u s t o m_ s k i n . z i p >
We shall create a new customization for you and reply to your e-mail with the instructions on how to use it as
soon as possible.

3.17 Web page integration
This chapter contains some basic information about integrating ISL Light into your webpage.
The recommended way of linking ISL Light Desk and ISL Light Client is the following:
http://www.islonline.net/start/ISLLightDesk
http://www.islonline.net/start/ISLLightClient
When a user clicks on the above links, it automatically detects his/her operating system (Windows, Linux, Mac
OS X) and offers the latest appropriate version of ISL Light Desk/Client for download.
You can use sample images below for linking to ISL Light from your website:
ISL Light Client - normal icon and a mouse-over icon:
ISL Light Desk - normal icon and a mouse-over icon:
You can add a simple form for entering a session code (like it is on http://www.islonline.com/ - "Were you
invited to a session?"), so that the client simply enters the session code and clicks Connect. Then it
automatically offers the latest appropriate version of ISL Light Client for download and automatically
establishes the connection when the client runs it - no need to enter the session code again. Please refer to
the Join a session - Web chapter for more information on the procedure.
Use the following HTML code as an example:

<f o r m me t h o d =" p o s t " a c t i o n =" h t t p s : / / www. i s l o n l i n e . n e t / u s e r s / ma i n / j o i n " >




En t e r y our s e s s i o n c o d e a n d c l i c k Co n n e c t .
</ f o r m>


For instructions on how to seamlessly integrate ISL Light into your web page, please go to the following topic:
Advanced web page integration
Advanced way of starting ISL Light

1. Go to http://www.islonline.net/users/programs.
2. Select ISL Light Desk or ISL Light Client next to the Program name.
3. Set the desired options (e.g. branch, platform, customization name etc.)
4. Click on the Dow nload link to download the desired version.
There are two different approaches when you want to publish ISL Light Desk and ISL Light Client on your
web page:
1. Provide a link to our web page (e.g. http://www.islonline.net/start/ISLLightDesk) that constructs ISL Light
Desk or ISL Light Client each time a user clicks that link (this way, if a new version is released, users
automatically get the latest version).
2. Construct the desired executable manually and then instead of running it, save it. You can then publish it on
your web page for download (this way, users get the version that you constructed - if a new version is
released in the meantime, you will need to construct and publish the new version manually).
3.17.1 Advanced web page integration

Here is an example for both login and join:

webapi_example_hosted.html
You can enter your ISL Online products username and password in the top section and click Login. If the
username/password combination is valid, you will be logged in and taken to the islonline.net product page. In
case the username/password combination is not valid, you will see an error in red.
Your customer can enter the session code in the bottom section and click Join. If the provided session code is
not valid, you will see an error in red. If the session code is valid, you will see the name of the supporter next to
the session code and a Start button. If you click the Start button, it will start ISL Light Client and connect to the
session with the provided session code.
Please note that this is just a basic example to demonstrate main principles of using webapi, you can modify it
to suit your needs.
For most use cases you do not need to put the login part on your webpage (at least not next to the join part), so
we prepared a separate example with just the join form. If a customer enters an invalid session code, an error
is shown in red frame. If the customer enters a valid session code, a notification is shown in green frame and
the download of ISL Light Client with that session code is started automatically (if a customer uses Internet

Explorer, another button is shown and needs to be clicked in order to start the download).
webapi_example_join_hosted.html
You can check the webapi source for detailed information:

http://www.islonline.net/webapi/api.js?libs=join,login&readable=1

ISL Light 3.3 Manual Server licence 170
4 Server licence
This chapter describes usage and options of ISL Light that are specific for server licence users. The first topic
(Quick setup) includes some basic instructions to get your own ISL Conference Proxy server up and running.
Please refer to the ISL Conference Proxy Manual for further instructions and advanced features.
Whenever you see a reference to l o c a l h o s t in this manual, it refers to the server that runs ISL
Conference Proxy. Please replace it with the appropriate address for your situation.
This chapter includes the following sections:

Quick setup
Conference Proxy points of interest
Starting ISL Light
Customization
User management
Integration
Please continue to the Quick setup chapter.
4.1 Quick setup
In order to install ISL Conference Proxy, you first need to create a new packet. Please follow these steps:
1. Please login to your ISL Online account (refer to this topic for instructions).
2. Go to Server license - info and read the three steps on the right - this is what you need to do now.
3. Click define a new server and enter your server's inner and outer IP address, then click Define server.
4. Having defined a new server, click assign licenses, select your server IP from the list and click Change.
5. Having assigned a licence, go to Server license - packets and click create new packet.
6. Select your server IP from the list next to Server and select ISL Conference Proxy 3.3 next to Release, then
click Next.
7. You can enter a comment if you wish and then press Create packet.
You have now created a new ISL Conference Proxy 3.3 packet - it contains two files: Readme.html and
confproxy-3-1.license. Please download those two files to your computer and open the Readme.html file - it
contains installation instructions. Please follow the appropriate section (depending on your server OS -
Windows or Linux).
Instructions for first installation are included below for convenience:
Window s
1. Run the latest ISL Conference Proxy installation file and follow the installation wizard.
2. Web administration will appear (also available from Start menu or address http://localhost:7615/conf).
3. Login as user a d mi n , password a s d .

4. Select Basic configuration and enter all necessary fields.

5. Select Licenses and upload license file.
6. Select Online update and download all necessary software components (ISL Light, ...).
Linux
1. Download the latest ISL Conference Proxy installation file.
2. Login as root and install ISL Conference Proxy: s h I SL _ Co n f e r e n c e _ Pr o x y _ 3 _ 3 _ x _ l i n u x . b i n
(where 3.3.x is the version of the downloaded installation file)
3. Open web administration, which is available at address http://localhost:7615/conf.
4. Login as user a d mi n , password a s d .
5. Select Basic configuration and enter all necessary fields.
6. Select Licenses and upload license file.
7. Select Online update and download all necessary software components (ISL Light, ...).
Having followed the appropriate section above, you should now have a running ISL Conference Proxy on your
server. In order to use ISL Online products with your ISL Conference Proxy, you need to create at least one user,
since the a d mi n user is only used for administration purposes. Please follow these steps to add a user:
1. Login to your ISL Conference Proxy administration (http://localhost:7615/conf).
2. Go to User management and click Create user....
3. Enter the details (User name, password, password again, full name, e-mail, nickname) and click Create.
You have now successfully created a new user and you can use that username and password for obtaining an
ISL Light session code. For more information on user management, refer to the User management chapter.
This concludes the Quick setup chapter.

Please continue to the Starting ISL Light chapter to learn how to use ISL Light with your new ISL Conference
Proxy server.
You may also be interested in some of the main ISL Light-related settings in the Conference Proxy
administration - please check the Conference Proxy points of interest chapter for more information.
4.2 Conference Proxy points of interest
For reference purposes, this topic includes some ISL Light points of interest in the ISL Conference Proxy
administration. Please refer to ISL Conference Proxy Manual for more information about ISL Conference Proxy
administration.
Activity monitor - Servers

Information about your servers - you can restart, connect a server to grid, disconnect a server from grid.
Activity monitor - Clients

Shows connections to servers and concurrent usage statistics.

Activity monitor - System statistics

Shows system information and current usage statistics - e.g. cpu load, memory usage.
Activity monitor - Sessions - Active - ISL Light

Shows a list of active ISL Light sessions.
Activity monitor - Sessions - History - ISL Light

Browse and search ISL Light session history.
Configuration - General - HTTPT ports

Default values (80, 443, 7615) can be changed - e.g. if port 80 is already taken by the web server,
remove it from the list and ISL Conference Proxy will not try to bind that port. If possible, please have a separate
IP address for ISL Conference Proxy and all three ports available in order to allow most users to connect.
Configuration - General - Default domain for user authentication

Change the default domain from "default" to some other domain, e.g. "mycompany".
Configuration - General - Default program customization

Assign a certain customization as the default value - default is none.
Configuration - ISL Light

Used for managing ISL Light server-side settings, e.g. set "Send chat transcripts" to "Yes" if you want
chat contents to be saved in the session history.
Messages
Messages enable you to send specific messages to ISL Light Desk at certain events - they can be
defined in a file or inline within ISL Conference Proxy administration.
Message file definitions are read line-by-line (empty lines are ignored) by ISL Conference Proxy and
they must use the following format:
t i me _ i n _ s e c o n d s # a c t i o n _ c o d e s # p r o g r a m_ v e r s i o n # me s s a g e _ t e x t
t i me _ i n _ s e c o n d s - used for defining the delay for the message, depending on the specified
action_codes
a c t i o n _ c o d e s - used for defining the event that triggers the action as well as defining the action
itself - first choose one of the three events:
s - after ISL Light Desk obtains a session code
o - after ISL Light Desk and ISL Light Client connect
t - before session disconnects (it only works for sessions that have a limited session
duration)
then choose one of the following actions:
c - show the message in ISL Light Desk's chat area
m - show the message in a message box (a window containing me s s a g e _ t e x t and an OK

button)
d - show the message on user's desktop
p r o g r a m_ v e r s i o n - specify the desired ISL Light Desk version, e.g. d k - 3 . 0 (this matches to
3.0.0, 3.0.1 etc.) - if this field is left empty, it applies to all versions
me s s a g e _ t e x t - specify the text that will be shown to ISL Light Desk - it must be URL encoded
This example will show the message We l c o me t o my _ c o mp a n y s u p p o r t . in ISL Light Desk's

chat area five seconds after the connection between ISL Light Desk and ISL Light Client has been established:
5 # o c # # We l c o me t o my _ c o mp a n y s u p p o r t .
Configuration - Advanced - Customize

Used for managing customizations. Please refer to the Customization chapter for more information on
customization.
Configuration - Advanced - Integration

Used for setting up integration options - please refer to "Integration Instructions" chapter in the ISL
Conference Proxy Manual for more details and an integration example.
Configuration - Advanced - Programs

Used for setting program parameters - e.g. allowing programs, which branches to use.
Configuration - Advanced - Plugins

Used for setting plugin parameters - e.g. enable/disable certain plugins, which branches to use, set
on-demand download of certain plugins.
User management
Used for managing domains and users. Please refer to the User management chapter for more
information on user management.
Manage softw are - Licenses

Displays information about the currently installed license - most important entries are "Concurrent
limit" and "Max release date".
Manage softw are - Online update

Offers an easy way to update your ISL Conference Proxy server and its components.
Manage softw are - Install ZIP

Used for manually updating ISL Conference Proxy in case it is not connected to the internet.

4.3 Starting ISL Light
There are a few ways to start ISL Light - each way has its own benefits and usage cases. This topic will list the
main ways to start ISL Light.
Default way to start ISL Light

http://localhost:7615/start/ISLLightDesk
http://localhost:7615/start/ISLLightClient
When a user clicks on the above links, it automatically detects his/her operating system (Windows, Linux, Mac
OS X) and offers the latest appropriate version of ISL Light Desk/Client for download.
You can use sample images below for linking to ISL Light from your website:
ISL Light Client - normal icon and a mouse-over icon:
ISL Light Desk - normal icon and a mouse-over icon:
Start ISL Light as a specific user
1. Go to http://localhost:7615/ and select the Login link in the top right corner.
2. Enter the desired username (username format \\domain\user) and password, then click Login.
3. Click the ISL Light entry on the left.
4. You will see a list of last 10 sessions.
To search through session history, click More and you will be able to specify the desired time range. You
can export search results in XML format - click Export table as XML.
5. Click Start New Session to start ISL Light Desk or use the links below to download ISL Light Desk and
Client.
6. The client can be instructed to use the ISL Light Client link mentioned in step 5 or go to http://localhost:7615/
and enter the provided session code.
Advanced start mode

1. Go to http://localhost:7615/users/programs.

2. Select ISL Light Desk or ISL Light Client next to the Program name.
3. Set the desired options (e.g. branch, platform, customization name etc.)
4. Click on the Dow nload link to download the desired version.
There are two different approaches when you want to publish ISL Light Desk and ISL Light Client on your
web page:
1. Provide a link to ISL Conference Proxy that constructs ISL Light Desk or ISL Light Client each time a user
clicks that link (this way, if you change a setting in your customization, users always get the latest version).
2. Construct the desired executable manually and then instead of running it, save it. You can then publish it on
your web page for download (this way, users get the version that you constructed - if you change a setting in
your customization, you need to construct and publish the new version manually).
Ex amples:
1. You have prepared a customization with your company logo and an end-of-session dialog (we assume that
this customization is called "mycustom") and would like to provide a general link that works on all supported
platforms (Windows, Linux, Mac OS X) and always provides the latest available version on your ISL Conference
Proxy.
ISL Light Desk: http://localhost:7615/start/ISLLightDesk?custom=mycustom
ISL Light Client: http://localhost:7615/start/ISLLightClient?custom=mycustom
2. Same as the first example, but you would like to put separate links for Windows, Linux and Mac OS X
versions of ISL Light on your web page.
ISL Light Desk for Windows: http://localhost:7615/start/ISLLightDesk?custom=mycustom&platform=win32
ISL Light Desk for Linux: http://localhost:7615/start/ISLLightDesk?custom=mycustom&platform=linux
ISL Light Desk for Mac (Intel): http://localhost:7615/start/ISLLightDesk?custom=mycustom&platform=mac
ISL Light Desk for Mac (PowerPC): http://localhost:7615/start/ISLLightDesk?
custom=mycustom&platform=macppc
ISL Light Client for Windows: http://localhost:7615/start/ISLLightClient?custom=mycustom&platform=win32
ISL Light Client for Linux: http://localhost:7615/start/ISLLightClient?custom=mycustom&platform=linux
ISL Light Client for Mac (Intel): http://localhost:7615/start/ISLLightClient?custom=mycustom&platform=mac
ISL Light Client for Mac (PowerPC): http://localhost:7615/start/ISLLightClient?
custom=mycustom&platform=macppc
4.4 Customization
Note to users of ISL Conference Proxy versions prior to 3.1.0: Customization for ISL Conference Proxy
3.1.0+ differs from previous versions. Previously it was done during the packet creation procedure in the ISL
Light web console, but now it is entirely done in the local ISL Conference Proxy administration. Customization
is added to the main program on the fly, when you start it through http://localhost:7615/users/programs/ - you
can then save the resulting executable for repeated usage or generate it using a link each time.
You can customize ISL Light to your needs. Customization is divided into basic and expert.
Basic customization includes:

adding your company logo to ISL Light

adding session dialogs (program startup, start of session, end of session)
command line arguments
Expert customization includes:

custom port settings
branch parameters
...
This chapter mostly focuses on basic customization - for more information about customization settings,
please refer to the ISL Conference Proxy manual.
Adding a company logo
Using session dialogs
Command line arguments
Changing program skin and texts
Using filters
Note: Before you change a certain customization setting, please check the right-most column that lists all
the products (and product versions) that the current setting applies to.
4.4.1 Adding a company logo
This chapter will show you how to create a new customization with your company logo.
Please follow these steps:

2. Go to Configuration - Advanced - Customize.
3. Click Create new customization.
4. Change the customization name from the randomly generated string to something simpler - for this
example, we shall use "mycustom".
5. Click upload... next to Logo image (BMP 80x80), then Choose, then select a valid logo (BMP format, image
width up to 80, image height up to 80).
6. Click Save at the bottom.
You have now created a customization with your company logo and there are a few ways to use it - each way
has its own benefits and usage cases.
Set it as the default customization so that it gets used automatically w ith every start of ISL Light Desk/
Client
1. Go to Configuration - General.

2. Click the checkbox next to Default program customization and enter the customization name that you
assigned ("mycustom").
For more information on starting ISL Light, please refer to the Starting ISL Light topic.
Set it as the default customization for a certain domain (or more than one domain - repeat the steps 1.-3.
for each domain)
1. Go to User management - Domains and click the desired domain.
4. Start ISL Light Desk/Client as a specific user.
For more information on starting ISL Light as a specific user, please refer to the Starting ISL Light topic.
Set it as the default customization for a certain user (or more than one user - repeat the steps 1.-3. for
each user)
1. Go to User management - Users and click the desired user.
4. Start ISL Light Desk/Client as a specific user.
For more information on starting ISL Light as a specific user, please refer to the Starting ISL Light topic.
Specify the customization name manually w hen starting ISL Light

1. Go to http://localhost:7615/users/programs/.
2. Enter the customization name ("mycustom") in the space provided next to the Customization: and press
Update.
3. Start ISL Light Desk/Client.
For more information on starting ISL Light, please refer to the Starting ISL Light topic.
Specify the customization name via URL w hen starting ISL Online products
This is the most often used way to link to ISL Light Desk on your homepage: http://localhost:7615/start/
ISLLightDesk
You can specify the customization name via URL using the "custom" parameter "?
custom=<customization_name>". For the above example, you would use:
http://localhost:7615/start/ISLLightDesk?custom=mycustom
4.4.2 Using session dialogs
This chapter will show you some basics on how to use session dialogs with your ISL Conference Proxy.
Please refer to ISL Conference Proxy manual for more information about session dialogs.

There are three types of session dialogs available:

shown at program startup (called start-of-dialog - SOD)
shown at session start (called start-of-session - SOS)
shown at the end of the session (called end-of-session - EOS)
SOD and SOS dialogs are usually disclaimers and include no user input apart from confirmation (user can
also decline the SOS or SOD dialog by pressing ESC or clicking the close window button - this will terminate
the program or session), while EOS dialog reports results to the ISL Conference Proxy and those results are
saved to ISL Light session history.
All three dialogs are defined in a single file. You can specify one, two or three dialogs, depending on your
needs.
Basic dialog definition syntax

Session dialogs are defined using a simple XML-like language with a root "dialog". All names are equal to
names found in C API of MS Windows GUI. Child object names are window class names. One can use
s t a t i c , e d i t , b u t t o n , c o mb o b o x etc.
Each object can have a title, dimensions, style, exstyle and return value specified through the use of attributes.
Names of window classes, styles, exstyles can be found in MSDN. Objects of type c o mb o b o x have an
additional attribute named "delimiters". This attribute is used for parsing values that are inserted into the
combobox.
Only those objects that have the result attribute specified will report the result to the ISL Conference Proxy. Each
such object generates a key-value pair where the result attribute is used as a key.
Important: Each entry (in the examples below, the entries are s o d _ d i a l o g , s o s _ d i a l o g and
e o s _ d i a l o g ) has to be a single line in order to be interpreted correctly. Examples below are shown with line
breaks to improve readability and to give the general idea of certain elements to the reader. Prior to using the
examples, please remove all line breaks in those entries.
First line contains the language identifier - it is a 2-letter ISO 639 code, e.g. e n for English, s l for
Slovenian, d e for German etc.
SOD ex ample
[ en]
s od_di al og=
<d i a l o g t i t l e =" We l c o me ! " wi d t h =1 1 0 h e i g h t =4 0 s t y l e =" WS_ CAPTI ON| WS_ POPUP|
WS_ SYSMENU" >
<s t a t i c t o p =5 l e f t =5 wi d t h =1 0 0 h e i g h t =2 0 t i t l e =" We l c o me to t he I SL Li ght
s y s t e m! " / >

</ d i a l o g >
This SOD dialog looks like this:

SOS ex ample
[ en]
s os _di al og=
<d i a l o g t i t l e =" We l c o me t o I SL L i g h t " wi d t h =1 1 0 h e i g h t =4 0 s t y l e =" WS_ CAPTI ON|
WS_ POPUP| WS_ SYSMENU" >
<s t a t i c t o p =5 l e f t =5 wi d t h =1 0 0 h e i g h t =2 0 t i t l e =" We l c o me to t he I SL Li ght
s es s i on. " / >

</ d i a l o g >
This SOS dialog looks like this:
EOS ex ample
[ en]
eos _di al og=
<d i a l o g t i t l e =" Qu e s t i o n n a i r e " wi d t h =1 6 0 h e i g h t =1 1 0 s t y l e =" WS_ CAPTI ON|
WS_ POPUP| WS_ SYSMENU" e x s t y l e =WS_ EX_ APPWI NDOW r e s u l t =" d e s k _ i s s u e _ s t a t u s " >
<s t a t i c t o p =5 l e f t =5 wi d t h =5 0 h e i g h t =8 t i t l e =Su p p o r t e r / >
<e d i t t o p =5 l e f t =5 5 wi d t h =1 0 0 h e i g h t =8 t i t l e =" Su p p o r t e r 1"
e x s t y l e =WS_ EX_ CL I ENTEDGE r e s u l t =" Su p p o r t e r " / >
<s t a t i c t o p =1 5 l e f t =5 wi d t h =5 0 h e i g h t =8 t i t l e =Cu s t o me r / >
<e d i t t o p =1 5 l e f t =5 5 wi d t h =1 0 0 h e i g h t =8 t i t l e =" " e x s t y l e =WS_ EX_ CL I ENTEDGE
r e s u l t =" Cu s t o me r " / >
<s t a t i c t o p =2 5 l e f t =5 wi d t h =5 0 h e i g h t =8 t i t l e =" Co mp a n y " / >
<c o mb o b o x t o p =2 5 l e f t =5 5 wi d t h =1 0 0 h e i g h t =5 0 d e l i mi t e r s =" ; "
s t y l e =CBS_ DROPDOWNL I ST r e s u l t =" Co mp a n y " >Mo n i t o r ; Sl o v e n s k e
No v i c e ; Xl a b ; Sl o n e p </ c o mb o b o x >
<s t a t i c t o p =3 5 l e f t =5 wi d t h =5 0 h e i g h t =8 t i t l e =" Ty p e o f s e r v i c e " / >
<c o mb o b o x t o p =3 5 l e f t =5 5 wi d t h =1 0 0 h e i g h t =5 0 d e l i mi t e r s =" ; "
s t y l e =CBS_ DROPDOWNL I ST r e s u l t =" Ty p e " >Te c h n i c a l Er r o r ; Co n f i g u r a t i o n
Er r o r ; Us e r Er r o r </ c o mb o b o x >
t r u e 
t r u e 
<s t a t i c t o p =5 5 l e f t =5 wi d t h =5 0 h e i g h t =8 t i t l e =" Co n t e n t : " / >
<e d i t t o p =6 5 wi d t h =1 5 0 h e i g h t =3 0 l e f t =5 t i t l e =" " e x s t y l e =WS_ EX_ CL I ENTEDGE
r e s u l t =" Co n t e n t " / >



</ d i a l o g >
This EOS dialog looks like this:
As an example, we will use only the EOS dialog. Please save the above EOS dialog definition to a file called
d i a l o g s . i n i . Please make sure the e o s _ d i a l o g entry is a single line (without line breaks), otherwise it
will not work - it should look similar to this:
[ en]
e o s _ d i a l o g =<d i a l o g t i t l e =" Qu e s t i o n n a i r e " wi d t h =1 6 0 h e i g h t =1 1 0
s t y l e =" WS_ CAPTI ON| WS_ POPUP| WS_ SYSMENU" e x s t y l e =WS_ EX_ APPWI NDOW
r e s u l t =" d e s k _ i s s u e _ s t a t u s " ><s t a t i c t o p =5 l e f t =5 wi d t h =5 0 h e i g h t =8
t i t l e =Su p p o r t e r / ><e d i t t o p =5 l e f t =5 5 wi d t h =1 0 0 h e i g h t =8 t i t l e =" Su p p o r t e r
1" e x s t y l e =WS_ EX_ CL I ENTEDGE r e s u l t =" Su p p o r t e r " / ><s t a t i c t o p =1 5 l e f t =5
wi d t h =5 0 h e i g h t =8 t i t l e =Cu s t o me r / ><e d i t t o p =1 5 l e f t =5 5 wi d t h =1 0 0 h e i g h t =8
t i t l e =" " e x s t y l e =WS_ EX_ CL I ENTEDGE r e s u l t =" Cu s t o me r " / ><s t a t i c t o p =2 5 l e f t =5
wi d t h =5 0 h e i g h t =8 t i t l e =" Co mp a n y " / ><c o mb o b o x t o p =2 5 l e f t =5 5 wi d t h =1 0 0
h e i g h t =5 0 d e l i mi t e r s =" ; " s t y l e =CBS_ DROPDOWNL I ST r e s u l t =" Co mp a n y "
>Mo n i t o r ; Sl o v e n s k e No v i c e ; Xl a b ; Sl o n e p </ c o mb o b o x ><s t a t i c t o p =3 5 l e f t =5
wi d t h =5 0 h e i g h t =8 t i t l e =" Ty p e of s er v i c e" / ><c o mb o b o x t o p =3 5 l e f t =5 5
wi d t h =1 0 0 h e i g h t =5 0 d e l i mi t e r s =" ; " s t y l e =CBS_ DROPDOWNL I ST r e s u l t =" Ty p e "
>Te c h n i c a l Er r o r ; Co n f i g u r a t i o n Er r o r ; Us e r Er r o r </ c o mb o b o x >t r u e t r u e <s t a t i c t o p =5 5 l e f t =5
wi d t h =5 0 h e i g h t =8 t i t l e =" Co n t e n t : " / ><e d i t t o p =6 5 wi d t h =1 5 0 h e i g h t =3 0
l e f t =5 t i t l e =" " e x s t y l e =WS_ EX_ CL I ENTEDGE r e s u l t =" Co n t e n t " / ></ d i a l o g >
Please follow these steps to add session dialogs:

You can combine session dialogs customization with the company logo customization. If you have already
created a customization with your company logo (by following the previous chapter - Adding a company logo),
simply click on the customization name ("mycustom" for this example) and proceed to step 5.


5. Click upload... next to the desired entry (e.g. Dialog INI file), then Choose, then select a valid dialog file (it is in
XML format, please see above for an example - d i a l o g s . i n i ).
You have now created a customization with an EOS dialog and there are a few ways to use it - each way has its
own benefits and usage cases. Please refer to the previous chapter (Adding a company logo) for instructions
on how to use the created customization.
4.4.3 Command line arguments
Apart from procedures described in the Command line arguments chapter above, you can also specify
command line arguments as a part of a customization.
Please follow these steps to add command line arguments to a customization:

You can combine command line arguments customization with the company logo customization. If you
have already created a customization with your company logo (by following the previous chapter - Adding a
company logo), simply click on the customization name ("mycustom" for this example) and proceed to step 5.
5. Check the Show expert settings checkbox.
6. Scroll down to the appropriate Command line entry (please refer to the right column (Applies to) to see which
versions of programs are affected by which setting).
7. Uncheck the use system setting checkbox and enter the desired command line arguments.
You have now created a customization with command line arguments and there are a few ways to use it - each
way has its own benefits and usage cases. Please refer to the previous chapter (Adding a company logo) for
instructions on how to use the created customization.
4.4.4 Changing program skin and texts
Please make sure you have the latest ISL Conference Proxy, modules and programs installed. ISL Light
3.2.0a or newer is required.
First please go to this topic for information on skin and text customization that applies to hosted service and
server licence users: Changing program skin and texts
For using skin customization with your server licence, refer to the steps below.

Using skin customization
Please follow these steps to add customized skin and texts to a customization:
You can combine skin and text customization with the company logo customization etc. If you have already
created a customization with your company logo (by following the previous chapter - Adding a company logo),
simply click on the customization name ("mycustom" for this example) and proceed to step 5.
5. Check the Show expert settings checkbox.
6. Scroll down to the Custom skin package (ZIP) entry, click upload..., click Choose and select the prepared
c u s t o m_ s k i n . z i p file.
7. Scroll down to the Window title entry and enter the desired window title (e.g. MyCompany Support) - this
changes the ISL Network Start window title.
8. You can use Icon for executable (PNG) entry to set a custom icon if you wish.
You have now created a customization with a custom skin and texts and there are a few ways to use it - each
way has its own benefits and usage cases. Please refer to the previous chapter (Adding a company logo) for
instructions on how to use the created customization.
4.4.5 Using filters
You can enable get code filters that limit access based on the IP and/or MAC address - you can set it for a
domain or for a specific user on the ISL Conference Proxy.
Each filter definition consists of pairs of filter name and filter descriptions. Pairs are delimited with a new line or
using the ; character.
Filter syntax:
( a l l o w_ | d e n y _ ) ( a l l | i p | ma c ) <f i l t e r des c r i pt i on> [ ; ( a l l o w_ | d e n y _ ) ( i p | ma c )
<f i l t e r d e s c r i p t i o n 1 > . . . ]
First part of the pair begins with a l l o w_ or d e n y _ and is followed by i p or ma c (applying IP or MAC filtering).
The second part (f i l t e r _ d e s c r i p t i o n ) depends on the filtering type - either an IP address/subnet/... or a
MAC address using the a a - b b - c c - d d - e e format.
When accessing a computer, its access rules are read from the top down and stop immediately when a rule is
matched, whether it is allow or deny. If it gets to the bottom of the list, d e n y _ a l l is implicitly used - i.e. if all the
rules fail to match and it gets to the bottom of the list, access is denied. This means that you do not need to
append d e n y _ a l l to your list.
An example:
deny _i p 192. 168. 0. 113
a l l o w_ i p 1 9 2 . 1 6 8 . 0 . 1 1 2 / 2 5 5 . 2 5 5 . 2 5 5 . 0
a l l o w_ ma c 0 0 - 1 9 - d 1 - 0 6 - c 9

This will allow connections from any IP in the 192.168.0.* subnet except 192.168.0.113 and allow connections
coming from the 00-19-d1-06-c9 MAC address with any IP.
Please note: IP and MAC addresses can be spoofed, so never base your security solutions only on that.
To enable filters, please follow these steps:

2. Go to User management, then select the desired domain or user (whether you want to set filters for a
domain or for a specific user).
3. Click the ISL Light tab.
4. Uncheck the Desk code request filter and enter the desired filter definitions in the provided space.
4.5 User management
This topic will shows you the basics of user management.

To access a list of users or domains on your ISL Conference Proxy, please do the following:
2. Go to User management.
3. To manage domains, click the Domains tab. To manage users, click the Users tab.
4. You will be presented with a list of domains or users, depending on your choice. Filtering of the results is
available, including standard wildcards like * and ?.
If you wish to allow users to view sessions in user's domain or all sessions, go to the Security tab and
change User can view sessions in domain or User can view all sessions.
Creating a domain
1. Click the Domains tab and then click Create domain....
2. Enter the desired domain name and click Create.
3. You will be presented with the General tab for the newly created domain. After making the desired changes,
please click Save. For a detailed description of settings in each tab please refer to the ISL Conference Proxy
manual.
Creating a user
1. Click the Users tab and then click Create user....
2. Enter user information (User name, password, password again, full name, e-mail, nickname) and click
Create. You can change the domain from the default value to some other domain - click (change...) and
select the desired domain.
3. You will be presented with the General tab for the newly created user. After making the desired changes,
please click Save. For a description of settings in each tab please refer to the ISL Conference Proxy manual.
Important: If you assign a blank password to a user, that user will not be able to obtain a session code.

Important: Users from a non-default domain have to enter their usernames in the following format: \
\ d o ma i n \ u s e r n a me
Deleting a domain
1. Click the Domains tab and select the desired domain.
2. Click the checkbox next to the Delete domain button.
3. Click the Delete domain button to delete the domain.
Important: Deleting a domain automatically deletes all users within that domain.
Deleting a user
1. Click the Users tab and select the desired user.
2. Click the checkbox next to the Delete user button.
3. Click the Delete user button to delete the user.
4.6 Integration
This chapter contains some integration examples for ISL Light using ISL Conference Proxy's means of
integration.
For a general description of ISL Conference Proxy's integration capabilities and a description of ISL Conference
Proxy administration settings please refer to the ISL Conference Proxy manual.
Please click the desired topic:

Advanced web page integration (includes an example of seamless login and code entry integration to a web
page)
HTTP events (includes a description of ISL Light-related HTTP events and an example)
XMLMSG (includes a few ISL Light-related XMLMSG examples)
Notifications (includes a code example for notification messages)
4.6.1 Advanced web page integration
Here is an example for both login and join:

webapi_example_server.html
(please replace all occurences of l o c a l h o s t with your server address)
You can enter your ISL Online products username and password in the top section and click Login. If the
username/password combination is valid, you will be logged in and taken to the islonline.net product page. In
case the username/password combination is not valid, you will see an error in red.
Your customer can enter the session code in the bottom section and click Join. If the provided session code is

not valid, you will see an error in red. If the session code is valid, you will see the name of the supporter next to
the session code and a Start button. If you click the Start button, it will start ISL Light Client and connect to the
session with the provided session code.
Please note that this is just a basic example to demonstrate main principles of using webapi, you can modify it
to suit your needs.
For most use cases you do not need to put the login part on your webpage (at least not next to the join part), so
we prepared a separate example with just the join form. If a customer enters an invalid session code, an error
is shown in red frame. If the customer enters a valid session code, a notification is shown in green frame and
the download of ISL Light Client with that session code is started automatically (if a customer uses Internet
Explorer, another button is shown and needs to be clicked in order to start the download).
webapi_example_join_server.html
You can check the webapi source for detailed information:

http://localhost/webapi/api.js?libs=join,login&readable=1
4.6.2 HTTP events
ISL Online products send notifications when certain events occur. You can use these events for various
purposes, e.g. save certain data to your database, respond to certain events through the XMLMSG interface etc.
ISL Light module on ISL Conference Proxy reports the following events through HTTP notifications:
NEWSESSI ON (triggered when ISL Light Desk creates a new session - requests a session code)
CODE (triggered when ISL Light Desk reports the session code back to ISL Conference Proxy)
GETCODE (same as CODE)
START (triggered when ISL Light Client connects to ISL Conference Proxy and joins the session)
STOP (triggered when ISL Light session is finished - both ISL Light Client and ISL Light Desk disconnect
from the session)
I NVAL I D (triggered when ISL Light Desk destroys the session using the get code button again before ISL
Light Client connects)
RECONNECT (triggered when ISL Light Client or ISL Light Desk lost connection to ISL Conference Proxy and
when ISL Light Client and ISL Light Desk reconnected back to the same session)
TERMI NATED (triggered when ISL Light session was terminated due to server restart)
MESSAGE (triggered when ISL Light Client or ISL Light Desk close the end of session dialog and send the
result to ISL Conference Proxy)
Each HTTP event notification consists of the following parameters:

TI MESTAMP (event creation timestamp in unix timestamp format)
MODUL E (module name which created event - for ISL Light events it will be I SL _ L I GHT)
EVENT (event name)
SERVERI D (GRID ID number of server who created and sent event)
DOMAI N_ I D (id of ISL domain where event originated)

ISL Light module provides the following fields:

r e a s o n (description of the reason for this event, usually provided with STOP event)
r e a s o n So f t wa r e Ty p e (what type of application caused it - desk/client)
r e a s o n Ad d r e s s (IP address of desk/client)
SESSI ONI D (ISL Conference Proxy database id of ISL Light session)
CPUSER_ I D (ISL Conference Proxy database id of user that was used by ISL Light Desk to create a
session)
CPUSER_ EI D (external id set for the user from ISL Conference Proxy administration or through XMLMSG
calls)
CPUSER (the whole authentication name domain name and user name of user used to authenticate through
ISL Light Desk)
CPUSER_ NAME (user name that was used for authentication)
CPUSER_ DOMAI N (domain name that was used for authentication)
CPUSER_ DOMAI N_ I D (ISL Confernce Proxy database id of the domain that was used for authentication)
c r e a t e d Ti me (timestamp when ISL Light session was created - ISL Light Desk acquired the code)
s t a r t Ti me (timestamp when ISL Light session was started - ISL Light Client successfully connected)
t o t a l Tr a n s f e r r e d By t e s (number of bytes transferred through ISL Conference Proxy in an ISL Light
session)
t o t a l Co n n e c t i o n Ti me (total connection time in seconds of ISL Light session)
l a s t Tr a n s f e r r e d Pa c k e t Ti me (timestamp of the last transfer from ISL Light Client to ISL Light Desk or
vice versa)
t r a n s p o r t Re c o n n e c t s (represents the number of ISL Light Desk and ISL Light Client reconnects)
g r a c e f u l Ex i t (session end status - did it normally exit, i.e. both sides agreed, or was the session
disconnected)
d e s k Ve r s i o n (version of the ISL Light Desk program)
d e s k Ad d r e s s (IP address of the ISL Light Desk program)
d e s k Tr a n s p o r t (ISL Light Desk type of transport used to connect to ISL Conference Proxy - direct, HTTP,
HTTPS)
d e s k L a n g u a g e (ISL Light Desk language at connect)
d e s k Ne t wo r k I n t e r f a c e s (ISL Light Desk network interfaces - 192.168.0.1;192.168.0.2;...;)
d e s k Pl a t f o r m (ISL Light Desk platform - win32, ...)
d e s k Co d e / t e x t Co d e (ISL Light session code shown in the ISL Light Desk program)
c l i e n t Ve r s i o n (version of the ISL Light Client program)
c l i e n t Ad d r e s s (IP address of the ISL Light Client program)
c l i e n t Tr a n s p o r t (ISL Light Client type of transport used to connect to ISL Conference Proxy - direct,
HTTP, HTTPS)
c l i e n t L a n g u a g e (ISL Light Client language at connect)
c l i e n t Ne t wo r k I n t e r f a c e s (ISL Light Client network interfaces - 192.168.0.1;192.168.0.2;...;)
c l i e n t Pl a t f o r m (ISL Light Client platform - win32, ...)
MSG ()
You will probably write a PHP / ASP / ASP.NET script that will parse the POST values of HTTP notifications and

act accordingly.
To access a filed in the POST part of the HTTP request, you would use something like this:
in PHP:
$ i s l _ mo d u l e = $ _ POST[ " MODUL E" ] ;
in ASP / ASP.NET:
i s l _ mo d u l e = Re q u e s t . Fo r m( " MODUL E" )
Your script should respond appropriately. If you set Global HTTP events strict error checking to Yes, it is
mandatory to respond with valid XML content.
If you do not wish to send a message to the XMLMSG interface after a certain event, respond like this:
in PHP:
e c h o " <n o me s s a g e / >" ;
in ASP / ASP.NET:
Re s p o n s e . Wr i t e ( " <n o me s s a g e / >" )
If you put these two parts together, a simple example script is ready for use:
in PHP:
<? p h p
i f ( " I SL _ L I GHT" == $ _ POST[ " MODUL E" ] ) {
/ / d o s o me t h i n g . . . wr i t e t o y o u r dat abas e, t o a c er t ai n f i l e, s end
a n e - ma i l , . . . .
}
e c h o " <n o me s s a g e / >" ;
?>
in ASP / ASP.NET:
<%
i f Re q u e s t . Fo r m( " MODUL E" ) = " I SL _ L I GHT" t h e n
' d o s o me t h i n g . . . wr i t e t o y o u r dat abas e, t o a c er t ai n f i l e, s end an
e - ma i l , ....
end i f
%>
The following simple ASP script example accepts ISL Conference Proxy HTTP requests and writes to a file
called i s l - c p - e x a mp l e - e v e n t s - t o - t x t . a s p . t x t .
The output file contains date and time of each event, event type and the whole request in one line. One line in
the file represents one event from ISL Conference Proxy.
<%
i f Re q u e s t . Fo r m( " MODUL E" ) = " I SL _ L I GHT" t h e n
s et o f i l e = Se r v e r . Cr e a t e Ob j e c t ( " Sc r i p t i n g . Fi l e Sy s t e mOb j e c t " )
s e t f i l e = o f i l e . Op e n Te x t Fi l e ( Se r v e r . Ma p Pa t h ( " i s l - c p - e x a mp l e - e v e n t s -
t o- t x t . as p. t x t " ) , 8, t r ue)

f i l e . Wr i t e ( Da t e ( ) & " " & Ti me ( ) & " [" & Re q u e s t ( " EVENT" ) & "]: " &
Re q u e s t . Fo r m & Ch r ( 1 3 ) & Ch r ( 1 0 ) )
f i l e . Cl o s e
end i f

%>
For a more advanced example with step-by-step instructions, please refer to the following topics:
PHP script writes to a database
IIS Example - ASP.NET script writes to a database
4.6.2.1 PHP script writes to a database
This PHP script accepts ISL Conference Proxy HTTP requests and writes to a database running on MySQL.
There is also a script for viewing database data from your web browser. The whole example uses XAMPP in
order to provide as easy setup procedure as possible. Viewer script uses Smarty template engine. The
procedure is described for Windows, but all components used are cross-platform, so with appropriate
modifications (e.g. installation paths, etc.) it should work on other platforms as well.
In this example, we have ISL Conference Proxy running on one server and the web server and the database on
another server. If you decide to put it all on one server, you will need to configure the web server listening port to
something other than 80 in order not to interfere with ISL Conference Proxy and adjust the described procedure
accordingly.
Please continue to the first step: Installing XAMPP and Smarty.
4.6.2.1.1 Installing XAMPP and Smarty
Important: If prompted by a firewall, allow connections for the web server and the database.
1. Download XAMPP self-extracting package from here:

http://www.apachefriends.org/download.php?xampp-win32-1.7.1.exe
2. Double-click it and extract to C: \ - this will create C: \ x a mp p folder.
3. Download Smarty zip package from here:
http://www.smarty.net/files/Smarty-2.6.25.zip
4. Create a new folder called s ma r t y in the xampp folder (i.e. C: \ x a mp p \ s ma r t y ).
5. Unzip the Smarty zip package to a temporary directory, e.g. C: \ t mp \ s ma r t y
6. Go to that temporary directory, go to the Smarty-2.6.25 subfolder and then copy everything there (demo,
libs, ...) to C: \ x a mp p \ s ma r t y
7. Open C: \ x a mp p \ p h p \ p h p . i n i with notepad, search for Pa t h s a n d Di r e c t o r i e s , scroll down to
Wi n d o ws and then replace the line
i n c l u d e _ p a t h = " . ; C: \ x a mp p \ p h p \ p e a r \ "

with the line

i n c l u d e _ p a t h = " . ; C: \ x a mp p \ p h p \ p e a r \ ; C: \ x a mp p \ s ma r t y \ l i b s \ "
8. Create a new folder called e x a mp l e in the C: \ x a mp p \ h t d o c s folder (i.e. C: \ x a mp p \ h t d o c s
\ e x a mp l e ).
9. Create a new folder called s ma r t y in the C: \ x a mp p \ h t d o c s f o l d e r (i.e. C: \ x a mp p \ h t d o c s
\ s ma r t y ).
10.Create a new folder called t e mp l a t e s in the C: \ x a mp p \ h t d o c s \ s ma r t y folder (i.e. C: \ x a mp p
\ h t d o c s \ s ma r t y \ t e mp l a t e s ).
11.Create a new folder called c o n f i g s in the C: \ x a mp p \ h t d o c s \ s ma r t y folder (i.e. C: \ x a mp p
\ h t d o c s \ s ma r t y \ c o n f i g s ).
12.Create a new folder called t e mp l a t e s _ c in the C: \ x a mp p \ s ma r t y folder (i.e. C: \ x a mp p \ s ma r t y
\ t e mp l a t e s _ c ).
13.Create a new folder called c a c h e in the C: \ x a mp p \ s ma r t y folder (i.e. C: \ x a mp p \ s ma r t y \ c a c h e ).
14.Start the XAMPP Control Panel Application by double-clicking x a mp p - c o n t r o l . e x e in C: \ x a mp p (i.e.
C: \ x a mp p \ x a mp p - c o n t r o l . e x e ).
15.Click Start next to Apache and wait until the green Running label appears.
16.Click Start next to MySql and wait until the green Running label appears.
17.Click Admin... next to Apache - it will open a page in your web browser.
18.Select the language (these instructions use English).
19.Click Security, it will open a page XAMPP SECURITY.
20.Click the link http://localhost/security/xamppsecurity.php in the middle of the page.
21.Enter the desired password for MySQL SuperUser in the provided space next to New passw ord. Enter it
again in the provided space next to Repeat the new passw ord.
22.Click the Passw ord changing button.
23.You need to restart MySql - switch to the XAMPP Control Panel Application, click Stop next to MySql, wait for
the green Running label to disappear, then click Start to start it again - wait for the green label Running to
appear.
24.Click Admin... next to MySql - it will open a page in your web browser.
25.Login using r o o t as username and entering the password that you set in the step 21.
26.Click the Privileges tab at the top, then select Add a new User in the middle of the page.
27.In the Login Information section, enter i s l t e s t next to User name:, i s l t e s t next to Passw ord:,
i s l t e s t next to Re-type:.
28.In the Database for user section, select Create database w ith the same name and grant all privileges.
29.Click Go at the bottom.
Please proceed to the next section: Adding tables to the database.
4.6.2.1.2 Adding tables to the database
Having created a user and the user's database, we will now add all the needed tables.
1. Select i s l t e s t database in the left side of the page, then click the SQL tab.
2. Paste the text below into the provided space and then click Go.
CREATE TABL E s e s s i o n _ e v e n t _ t o _ s t a t u s (

s t at us _c ode v ar c har ( 50) COL L ATE u t f 8 _ u n i c o d e _ c i NOT NUL L ,

ev ent _t y pe_c ode v ar c har ( 50) COL L ATE u t f 8 _ u n i c o d e _ c i NOT NUL L ,
n e w_ s t a t u s _ c o d e v a r c h a r ( 5 0 ) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L ,
wa r n i n g b i t NOT NUL L
)
3. Clear the text in the query space, paste all these lines and then click Go.
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' CANCEL ED' , ' CODE' , ' CANCEL ED' ,
0) ;
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' CANCEL ED' , ' GETCODE' ,
' CANCEL ED' , 0 ) ;
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' CANCEL ED' , ' I NVAL I D' ,
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' CANCEL ED' , ' MESSAGE' ,
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' CANCEL ED' , ' NEWSESSI ON' ,
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' CANCEL ED' , ' RECONNECT' ,
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' CANCEL ED' , ' START' ,
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' CANCEL ED' , ' STOP' , ' CANCEL ED' ,
0) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' CANCEL ED' , ' TERMI NATED' ,
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' EMPTY' , ' CODE' , ' NEW' , 0) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' EMPTY' , ' GETCODE' , ' NEW' , 0) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' EMPTY' , ' I NVAL I D' , ' CANCEL ED' ,
0) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' EMPTY' , ' MESSAGE' , ' EMPTY' ,
0) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' EMPTY' , ' NEWSESSI ON' , ' NEW' ,
0) ;
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' EMPTY' , ' RECONNECT' ,
' RECONNECTED' , 0) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' EMPTY' , ' START' , ' RUNNI NG' ,
0) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' EMPTY' , ' STOP' , ' FI NI SHED' ,
0) ;
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' EMPTY' , ' TERMI NATED' ,
' FI NI SHED' , 1 ) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' FI NI SHED' , ' CODE' , ' FI NI SHED' ,
0) ;
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' FI NI SHED' , ' GETCODE' ,
' FI NI SHED' , 0 ) ;
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' FI NI SHED' , ' I NVAL I D' ,
' FI NI SHED' , 0 ) ;
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' FI NI SHED' , ' MESSAGE' ,
' FI NI SHED' , 0 ) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' FI NI SHED' , ' NEWSESSI ON' ,
' FI NI SHED' , 0 ) ;
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' FI NI SHED' , ' RECONNECT' ,

I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' FI NI SHED' , ' START' ,
' FI NI SHED' , 0 ) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' FI NI SHED' , ' STOP' , ' FI NI SHED' ,
0) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' FI NI SHED' , ' TERMI NATED' ,
' FI NI SHED' , 1 ) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' NEW' , ' CODE' , ' NEW' , 0) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' NEW' , ' GETCODE' , ' NEW' , 0) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' NEW' , ' I NVAL I D' , ' CANCEL ED' ,
0) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' NEW' , ' MESSAGE' , ' NEW' , 0) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' NEW' , ' NEWSESSI ON' , ' NEW' , 1) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' NEW' , ' RECONNECT' , ' RUNNI NG' ,
1) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' NEW' , ' START' , ' RUNNI NG' , 0) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' NEW' , ' STOP' , ' FI NI SHED' , 0) ;
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' NEW' , ' TERMI NATED' ,
' FI NI SHED' , 1 ) ;
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' RECONNECTED' , ' CODE' ,
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' RECONNECTED' , ' GETCODE' ,
' RECONNECTED' , 0 ) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' RECONNECTED' , ' I NVAL I D' ,
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' RECONNECTED' , ' MESSAGE' ,
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' RECONNECTED' , ' NEWSESSI ON' ,
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' RECONNECTED' , ' RECONNECT' ,
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' RECONNECTED' , ' START' ,
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' RECONNECTED' , ' STOP' ,
' FI NI SHED' , 0 ) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' RECONNECTED' , ' TERMI NATED' ,
' FI NI SHED' , 0 ) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' RUNNI NG' , ' CODE' , ' RUNNI NG' ,
0) ;
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' RUNNI NG' , ' GETCODE' ,
' RUNNI NG' , 0 ) ;
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' RUNNI NG' , ' I NVAL I D' ,
' RUNNI NG' , 0 ) ;
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' RUNNI NG' , ' MESSAGE' ,
' RUNNI NG' , 0 ) ;
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' RUNNI NG' , ' NEWSESSI ON' ,
' RUNNI NG' , 0 ) ;
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' RUNNI NG' , ' RECONNECT' ,
' RUNNI NG' , 0 ) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' RUNNI NG' , ' START' , ' RUNNI NG' ,
1) ;
I NSERT I NTO s e s s i o n _ e v e n t _ t o _ s t a t u s VAL UES ( ' RUNNI NG' , ' STOP' , ' FI NI SHED' ,

0) ;
I NSERT I NTO s es s i on_ev ent _t o_s t at us VAL UES ( ' RUNNI NG' , ' TERMI NATED' ,
' FI NI SHED' , 1 ) ;
4. Paste the text below into the provided space and click Go.
CREATE TABL E l i g h t _ s e s s i o n s (
i d bi gi nt NOT NUL L AUTO_ I NCREMENT PRI MARY KEY,
t o t a l _ c o n n e c t i o n _ t i me i n t NUL L ,
t ot al _t r ans f er r ed_by t es bi gi nt NUL L ,
l a s t _ t r a n s f e r r e d _ p a c k e t _ t i me i n t NUL L ,
des k _i p v ar c har ( 50) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L ,
c l i ent _i p v ar c har ( 50) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L ,
des k _v er s i on v ar c har ( 50) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L ,
c l i ent _v er s i on v ar c har ( 50) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L ,
c pg_s er v er _i d i nt NOT NUL L ,
c pg_s es s i on_db_i d v ar c har ( 50) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L ,
c p g _ u s e r _ d o ma i n _ n a me n v a r c h a r ( 1 0 0 ) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L ,
c p g _ u s e r _ n a me n v a r c h a r ( 5 0 ) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L ,
s t a r t _ t i me v a r c h a r ( 5 0 ) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L ,
s t o p _ t i me v a r c h a r ( 5 0 ) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L ,
c pg_s es s i on_i dent v ar c har ( 50) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L ,
c u s t o m_ 0 1 v a r c h a r ( 5 0 ) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L ,
s t at us _c ode v ar c har ( 50) COL L ATE u t f 8 _ u n i c o d e _ c i NOT NUL L ,
s es s i on_c ode v ar c har ( 50) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L ,
c r eat ed_dat e v ar c har ( 50) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L ,
ma x _ l a s t _ t r a n s f e r r e d _ p a c k e t _ t i me i n t NUL L ,
ma x _ t o t a l _ t r a n s f e r r e d _ b y t e s b i g i n t NUL L
)
5. Clear the text in the query space, paste the text below into the provided space and click Go.
CREATE TABL E s e s s i o n s _ e v e n t s (
c pg_s es s i on_i dent v ar c har ( 50) COL L ATE u t f 8 _ u n i c o d e _ c i NOT NUL L ,
ev ent _t y pe_c ode v ar c har ( 50) COL L ATE u t f 8 _ u n i c o d e _ c i NOT NUL L ,
f i el ds nv ar c har ( 4000) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L ,
i ns er t ed_dat e v ar c har ( 50) COL L ATE u t f 8 _ u n i c o d e _ c i NOT NUL L ,
ev ent _dat e v ar c har ( 50) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L
)
6. Clear the text in the query space, paste the text below into the provided space and click Go.
CREATE TABL E s e s s i o n s _ r a wd a t a (
c pg_s es s i on_i dent v ar c har ( 50) COL L ATE u t f 8 _ u n i c o d e _ c i NOT NUL L ,
e v e n t _ n a me v a r c h a r ( 5 0 ) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L ,
k e y _ n a me v a r c h a r ( 5 0 0 0 ) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L ,
k ey _v al ue nv ar c har ( 4000) COL L ATE u t f 8 _ u n i c o d e _ c i NUL L

You have now prepared the tables. Please proceed to the next section: Adding scripts.
4.6.2.1.3 Adding scripts
Having created all the required tables, we will now add the scripts.
1. Download example_php_files.zip, open it and then extract e v e n t s . p h p and l i g h t _ v i e we r . p h p into
the C: \ x a mp p \ h t d o c s \ e x a mp l e folder.
To view the source of e v e n t s . p h p , click here.
To view the source of l i g h t _ v i e we r . p h p , click here.
2. Copy the following file into the C: \ x a mp p \ h t d o c s \ s ma r t y \ t e mp l a t e s folder:
light_show.tpl
3. Open e v e n t s . p h p file in the C: \ x a mp p \ h t d o c s \ e x a mp l e folder and set $ h o s t to the approriate
address for your case.
4. Open l i g h t _ v i e we r . p h p file in the C: \ x a mp p \ h t d o c s \ e x a mp l e folder and set $ h o s t to the
approriate address for your case.
You have now prepared everything on the web server. Write down the IP address of this web server, you will
need it later.
Please move to the next section: Configuring ISL Conference Proxy.
4.6.2.1.3.1 Source code
This section includes source code for the following scripts (click the desired script to go to its source):
events.php
light_viewer.php
events.php
<? p h p
// p r e p a r e p a r a me t e r s t o ma k e a c o n n e c t i o n t o o u r dat abas e. . .
// r e p l a c e wi t h t h e a p p r o p r i a t e h o s t addr es s
$hos t = " 172. 16. 118. 56" ;
// r e p l a c e my s q l wi t h t h e a p p r o p r i a t e d a t a b a s e t y p e :
// my s q l , pos t gr es 7, i bas e, ms s q l , bor l and_i bas e, f i r ebi r d, ms s q l p o ,
ma x s q l ,
// oc i 8, oc i 805, oc i 8po, pos t gr es , or ac l e, pos t gr es 64, s y bas e
$dbs er v er = ' my s q l ' ;
// r e p l a c e wi t h t h e a p p r o p r i a t e u s e r n a me
$us er = " i s l t es t " ;
// r e p l a c e wi t h t h e a p p r o p r i a t e p a s s wo r d

$ p a s s wo r d = " i s l t e s t " ;
// r e p l a c e wi t h t h e a p p r o p r i a t e d a t a b a s e
$dat abas e = " i s l t es t " ;
i nc l ude_onc e ' adodb/ adodb- er r or pear . i nc . php' ;

i nc l ude_onc e ' adodb/ adodb. i nc . php' ;
i n c l u d e _ o n c e ' a d o d b / t o h t ml . i n c . p h p ' ;
$ d b = ADONe wCo n n e c t i o n ( $ d b s e r v e r ) ;
@$ d b - >Co n n e c t ( $ h o s t , $us er , $ p a s s wo r d , $dat abas e) ;
// * * * I SL L i g h t ev ent handl er ***

i f ( " I SL _ L I GHT" == $ _ POST[ " MODUL E" ] ) {
// d e f i n e s o me t e mp v a r i a b l e s t h a t a r e o b t a i n e d f r o m POST
$l i ght _ev ent = $ _ POST[ ' EVENT' ] ;
$ l i g h t _ s e s s i o n i d = $ _ POST[ ' SESSI ONI D' ] ;
$ l i g h t _ t i me s t a mp = $ _ POST[ ' TI MESTAMP' ] ;
$ l i g h t _ s e r v e r i d = $ _ POST[ ' SERVERI D' ] ;
$ l i g h t _ d e s k v e r s i o n = $ _ POST[ ' d e s k Ve r s i o n ' ] ;
$ l i g h t _ c l i e n t v e r s i o n = $ _ POST[ ' c l i e n t Ve r s i o n ' ] ;
$ l i g h t _ c p u s e r d o ma i n = $ _ POST[ ' CPUSER_ DOMAI N' ] ;
$ l i g h t _ c p u s e r n a me = $ _ POST[ ' CPUSER_ NAME' ] ;
$ l i g h t _ c r e a t e d t i me = $ _ POST[ ' c r e a t e d Ti me ' ] ;
$ l i g h t _ d e s k c o d e = $ _ POST[ ' d e s k Co d e ' ] ;
$ l i g h t _ d e s k a d d r e s s = $ _ POST[ ' d e s k Ad d r e s s ' ] ;
$ l i g h t _ c l i e n t a d d r e s s = $ _ POST[ ' c l i e n t Ad d r e s s ' ] ;
$ l i g h t _ s t a r t t i me = $ _ POST[ ' s t a r t Ti me ' ] ;
$ l i g h t _ t o t a l c o n n e c t i o n t i me = $ _ POST[ ' t o t a l Co n n e c t i o n Ti me ' ] ;
$ l i g h t _ t o t a l t r a n s f e r r e d b y t e s = $ _ POST[ ' t o t a l Tr a n s f e r r e d By t e s ' ] ;
$ l i g h t _ l a s t t r a n s f e r r e d p a c k e t t i me =
$ _ POST[ ' l a s t Tr a n s f e r r e d Pa c k e t Ti me ' ] ;
$ l i g h t _ ma x l a s t t r a n s f e r r e d p a c k e t t i me =
$ _ POST[ ' l a s t Tr a n s f e r r e d Pa c k e t Ti me ' ] ;
$ l i g h t _ ma x t o t a l t r a n s f e r r e d b y t e s =
$ _ POST[ ' t o t a l Tr a n s f e r r e d By t e s ' ] ;
// put al l k ey - v al ue pai r s i nt o a s t r i ng { { k ey 1, v al ue1} , . . . ,

{ k ey n, v al uen} }
$ a r r a y = $ _ POST;
$f i el ds = " { " ;
f o r e a c h ( $ a r r a y a s $ k e y => $ v a l u e ) {
$f i el ds . = " { " . $k ey . " , " . $v al ue. " } " ;
}
$ f i e l d s . =" } " ;
$ i n s e r t e d _ d a t e = d a t e ( " Y- m- d " ) ;
$r es ul t = $ d b - >Ex e c u t e ( " I NSERT I NTO s es s i ons _ev ent s
( c pg_s es s i on_i dent , ev ent _t y pe_c ode, f i el ds , i ns er t ed_dat e, ev ent _dat e)

VAL UES ( ' $ l i g h t _ s e s s i o n i d ' , ' $l i ght _ev ent ' , ' $f i el ds ' , ' $i ns er t ed_dat e' ,
' $ l i g h t _ t i me s t a mp ' ) " ) ;
i f ( ! i s _obj ec t ( $r es ul t ) ) {
$ e = ADODB_ Pe a r _ Er r o r ( ) ;
}
$ a r r a y = $ _ POST;
f o r e a c h ( $ a r r a y a s $ k e y => $ v a l u e ) {
$r es ul t = $ d b - >Ex e c u t e ( " I NSERT I NTO s e s s i o n s _ r a wd a t a
( c pg_s es s i on_i dent , e v e n t _ n a me , k e y _ n a me , k ey _v al ue) VAL UES
( ' $l i ght _s es s i oni d' , ' $l i ght _ev ent ' , ' $k ey ' , ' $v al ue' ) " ) ;
}
}
/ / I n t he nex t s e c t i o n we c h e c k i f t her e ex i s t s an ent r y wi t h

t he c ur r ent SESSI ONI D.
// If y es , we g e t i t s c ur r ent s t at us c ode; o t h e r wi s e , we c r e a t e
a new ent r y .
$ r e s u l t = $ d b - >Ex e c u t e ( " SEL ECT s t a t u s _ c o d e FROM l i g h t _ s e s s i o n s
WHERE c p g _ s e s s i o n _ i d e n t =' $ l i g h t _ s e s s i o n i d ' " ) ;
}
$ s t a t u s = $ r e s u l t - >f i e l d s [ 0 ] ;
i f ( ! $s t at us ) {
// * * * SQL c o mma n d t o e x e c u t e * * *
$ r e s u l t = $ d b - >Ex e c u t e ( " I NSERT I NTO l i g h t _ s e s s i o n s
( c p g _ s e r v e r _ i d , c p g _ s e s s i o n _ i d e n t , s t a t u s _ c o d e ) VAL UES ( ' $ l i g h t _ s e r v e r i d ' ,
' $ l i g h t _ s e s s i o n i d ' , ' EMPTY' ) " ) ;
}
$ s t a t u s = " EMPTY" ;
}
/ / We n o w h a v e t h e c u r r e n t s t at us f or t h i s s e s s i o n a n d we k n o w
wh i c h e v e n t c onf pr ox y r epor t ed.
// It i s al l we need to get t he new s t at us c ode f r om our
t r ans i t i on t abl e:
$r es ul t = $ d b - >Ex e c u t e ( " SEL ECT n e w_ s t a t u s _ c o d e FROM
s es s i on_ev ent _t o_s t at us WHERE s t a t u s _ c o d e =' $ s t a t u s ' AND
e v e n t _ t y p e _ c o d e =' $ l i g h t _ e v e n t ' " ) ;
}
$ n e w_ s t a t u s = $ r e s u l t - >f i e l d s [ 0 ] ;

i f ( ! $ n e w_ s t a t u s ) {
/ / Er r o r t h a t s h o u l d n e v e r o c c u r , bec aus e we hav e ev er y
pos s i bl e s t at us t r ans i t i on c ov er ed i n t he t abl e!
} el s e {
s wi t c h ( $ l i g h t _ e v e n t ) {
c a s e " NEWSESSI ON" :
$ r e s u l t = $ d b - >Ex e c u t e ( " UPDATE l i g h t _ s e s s i o n s
SET d e s k _ v e r s i o n =' $ l i g h t _ d e s k v e r s i o n ' , c p g _ s e r v e r _ i d =' $ l i g h t _ s e r v e r i d ' ,
c p g _ u s e r _ d o ma i n _ n a me =' $ l i g h t _ c p u s e r d o ma i n ' ,
c p g _ u s e r _ n a me =' $ l i g h t _ c p u s e r n a me ' , c r e a t e d _ d a t e =' $ l i g h t _ c r e a t e d t i me ' ,
s e s s i o n _ c o d e =' $ l i g h t _ d e s k c o d e ' , s t a t u s _ c o d e =' $ n e w_ s t a t u s ' WHERE
c p g _ s e s s i o n _ i d e n t =' $ l i g h t _ s e s s i o n i d ' " ) ;
br eak ;
c a s e " START" :
SET d e s k _ i p =' $ l i g h t _ d e s k a d d r e s s ' , c l i e n t _ i p =' $ l i g h t _ c l i e n t a d d r e s s ' ,
s t a r t _ t i me =' $ l i g h t _ s t a r t t i me ' , s t a t u s _ c o d e =' $ n e w_ s t a t u s ' WHERE
br eak ;
c a s e " STOP" :
SET t o t a l _ c o n n e c t i o n _ t i me =' $ l i g h t _ t o t a l c o n n e c t i o n t i me ' ,
t o t a l _ t r a n s f e r r e d _ b y t e s =' $ l i g h t _ t o t a l t r a n s f e r r e d b y t e s ' ,
l a s t _ t r a n s f e r r e d _ p a c k e t _ t i me =' $ l i g h t _ l a s t t r a n s f e r r e d p a c k e t t i me ' ,
c l i e n t _ v e r s i o n =' $ l i g h t _ c l i e n t v e r s i o n ' , s t o p _ t i me =' $ l i g h t _ t i me s t a mp ' ,
s t a t u s _ c o d e =' $ n e w_ s t a t u s ' ,
ma x _ l a s t _ t r a n s f e r r e d _ p a c k e t _ t i me =' $ l i g h t _ ma x l a s t t r a n s f e r r e d p a c k e t t i me ' ,
ma x _ t o t a l _ t r a n s f e r r e d _ b y t e s =' $ l i g h t _ ma x t o t a l t r a n s f e r r e d b y t e s ' WHERE
br eak ;
def aul t :
SET s t a t u s _ c o d e =' $ n e w_ s t a t u s ' WHERE c p g _ s e s s i o n _ i d e n t =' $ l i g h t _ s e s s i o n i d ' " ) ;
br eak ;
}
}
}
}
// c l os e t he dat abas e c onnec t i on

@$ d b - >Cl o s e ( ) ;
// Re p l y n e e d e d f o r I SL Co n f e r e n c e Pr o x y
e c h o " <n o me s s a g e / >" ;
?>

light_viewer.php
<? p h p
// l o a d Sma r t y l i b r a r y
r e q u i r e ( ' Sma r t y . c l a s s . p h p ' ) ;
// s et Sma r t y p a r a me t e r s
$ s ma r t y = n e w Sma r t y ;
$ s ma r t y - >t e mp l a t e _ d i r = ' C: / x a mp p / h t d o c s / s ma r t y / t e mp l a t e s ' ;
$ s ma r t y - >c o n f i g _ d i r = ' C: / x a mp p / h t d o c s / s ma r t y / c o n f i g ' ;
$ s ma r t y - >c a c h e _ d i r = ' C: / x a mp p / s ma r t y / c a c h e ' ;
$ s ma r t y - >c o mp i l e _ d i r = ' C: / x a mp p / s ma r t y / t e mp l a t e s _ c ' ;
// I MPORTANT: s et f o r c e _ c o mp i l e t o f a l s e f o r n o n - d e v e l o p me n t us e!
$ s ma r t y - >f o r c e _ c o mp i l e = t r u e ;
$ s ma r t y - >a s s i g n ( ' p r o c e s s _ t a b l e s ' , 0 ) ;
i f ( i s s e t ( $ _ GET[ ' s u b mi t ' ] ) ) {

/ / v a r _ d u mp ( $ _ GET) ;
/ / e c h o ' ' ;
// p r e p a r e p a r a me t e r s t o ma k e a c o n n e c t i o n t o o u r dat abas e. . .
// r e p l a c e wi t h t h e a p p r o p r i a t e h o s t addr es s
$hos t = " 172. 16. 118. 56" ;
// r e p l a c e my s q l wi t h t h e a p p r o p r i a t e d a t a b a s e t y p e :
// my s q l , pos t gr es 7, i bas e, ms s q l , bor l and_i bas e, f i r ebi r d,
ms s q l p o , ma x s q l ,
// oc i 8, oc i 805, oc i 8po, pos t gr es , or ac l e, pos t gr es 64, s y bas e
$dbs er v er = ' my s q l ' ;
// r e p l a c e wi t h t h e a p p r o p r i a t e u s e r n a me
$us er = " i s l t es t " ;
// r e p l a c e wi t h t h e a p p r o p r i a t e p a s s wo r d
$ p a s s wo r d = " i s l t e s t " ;
// r e p l a c e wi t h t h e a p p r o p r i a t e d a t a b a s e
$dat abas e = " i s l t es t " ;
i nc l ude_onc e ' adodb/ adodb- er r or pear . i nc . php' ;

i nc l ude_onc e ' adodb/ adodb. i nc . php' ;
i n c l u d e _ o n c e ' a d o d b / t o h t ml . i n c . p h p ' ;
$ d b = ADONe wCo n n e c t i o n ( $ d b s e r v e r ) ;
$ d b - >Se t Fe t c h Mo d e ( ADODB_ FETCH_ ASSOC) ;
@$ d b - >Co n n e c t ( $ h o s t , $us er , $ p a s s wo r d , $dat abas e) ;
// pr epar e c ondi t i ons t hat a r e g o i n g t o b e u s e d i n t h e SEL ECT

quer y
$quer y _c ondi t i ons = ar r ay ( ) ;

i f ( ! e mp t y ( $ _ GET[ ' f r o m_ y e a r ' ] ) && ! e mp t y ( $ _ GET[ ' f r o m_ mo n t h ' ] )

&& ! e mp t y ( $ _ GET[ ' f r o m_ d a y ' ] ) ) {
$ f r o m_ t i me s t a mp =
mk t i me ( $ _ GET[ ' f r o m_ h o u r ' ] , $ _ GET[ ' f r o m_ mi n u t e ' ] , 0 0 , $ _ GET[ ' f r o m_ mo n t h ' ] , $ _ GET
[ ' f r o m_ d a y ' ] , $ _ GET[ ' f r o m_ y e a r ' ] ) ;
$quer y _c ondi t i ons [ ] = " c r e a t e d _ d a t e >=" . $ f r o m_ t i me s t a mp ;
}
i f ( ! e mp t y ( $ _ GET[ ' t o _ y e a r ' ] ) && ! e mp t y ( $ _ GET[ ' t o _ mo n t h ' ] ) &&
! e mp t y ( $ _ GET[ ' t o _ d a y ' ] ) ) {
$ t o _ t i me s t a mp =
mk t i me ( $ _ GET[ ' t o _ h o u r ' ] , $ _ GET[ ' t o _ mi n u t e ' ] , 0 0 , $ _ GET[ ' t o _ mo n t h ' ] , $ _ GET[ ' t o _ d
a y ' ] , $ _ GET[ ' t o _ y e a r ' ] ) ;
$quer y _c ondi t i ons [ ] = " c r e a t e d _ d a t e <=" . $ t o _ t i me s t a mp ;
}
i f ( ! e mp t y ( $ _ GET[ ' d o ma i n ' ] ) ) {
$quer y _c ondi t i ons [ ] =
" c p g _ u s e r _ d o ma i n _ n a me =' " . $ _ GET[ ' d o ma i n ' ] . " ' " ;
}
i f ( ! e mp t y ( $ _ GET[ ' u s e r ' ] ) ) {
$quer y _c ondi t i ons [ ] =
" c p g _ u s e r _ n a me =' " . $ _ GET[ ' u s e r ' ] . " ' " ;
}
$quer y _c ondi t i ons _s t r i ng = " " ;

$quer y _c ondi t i ons _s t r i ng_ol d = " " ;
f o r e a c h ( $ q u e r y _ c o n d i t i o n s a s $ k e y => $ v a l u e ) {
$quer y _c ondi t i ons _s t r i ng_ol d = $quer y _c ondi t i ons _s t r i ng;
$ q u e r y _ c o n d i t i o n s _ s t r i n g . = $ v a l u e . " AND " ;
$quer y _c ondi t i ons _s t r i ng_ol d . = $v al ue;
}
$quer y _c ondi t i ons _s t r i ng = $quer y _c ondi t i ons _s t r i ng_ol d;

e c h o ' q u e r y _ c o n d i t i o n s _ s t r i n g : ' ;
ec ho $quer y _c ondi t i ons _s t r i ng;
e c h o ' ' ;
i f ( e mp t y ( $ q u e r y _ c o n d i t i o n s _ s t r i n g ) ) {
$ r e s u l t = $ d b - >Ex e c u t e ( " SEL ECT c p g _ s e s s i o n _ i d e n t AS ' i d ' ,
c r e a t e d _ d a t e AS ' c r e a t e d ' , s e s s i o n _ c o d e AS ' c o d e ' , c p g _ u s e r _ d o ma i n _ n a me AS
' d o ma i n ' , c p g _ u s e r _ n a me AS ' u s e r ' , s t a t u s _ c o d e AS ' s t a t u s ' , s t a r t _ t i me AS
' s t a r t t i me ' , t o t a l _ c o n n e c t i o n _ t i me AS ' l e n g t h ' , t o t a l _ t r a n s f e r r e d _ b y t e s AS
' b y t e s ' , c p g _ s e r v e r _ i d AS ' s e r v e r ' , d e s k _ v e r s i o n AS ' d e s k v e r ' , d e s k _ i p AS
' d e s k i p ' , c l i e n t _ v e r s i o n AS ' c l i e n t v e r ' , c l i e n t _ i p AS ' c l i e n t i p ' FROM
l i ght _s es s i ons " ) ;
} el s e {
$ r e s u l t = $ d b - >Ex e c u t e ( " SEL ECT c p g _ s e s s i o n _ i d e n t AS ' i d ' ,
c r e a t e d _ d a t e AS ' c r e a t e d ' , s e s s i o n _ c o d e AS ' c o d e ' , c p g _ u s e r _ d o ma i n _ n a me AS
' d o ma i n ' , c p g _ u s e r _ n a me AS ' u s e r ' , s t a t u s _ c o d e AS ' s t a t u s ' , s t a r t _ t i me AS
' s t a r t t i me ' , t o t a l _ c o n n e c t i o n _ t i me AS ' l e n g t h ' , t o t a l _ t r a n s f e r r e d _ b y t e s AS
' b y t e s ' , c p g _ s e r v e r _ i d AS ' s e r v e r ' , d e s k _ v e r s i o n AS ' d e s k v e r ' , d e s k _ i p AS
' d e s k i p ' , c l i e n t _ v e r s i o n AS ' c l i e n t v e r ' , c l i e n t _ i p AS ' c l i e n t i p ' FROM

l i g h t _ s e s s i o n s WHERE $ q u e r y _ c o n d i t i o n s _ s t r i n g " ) ;
}
}
$ r e s u l t _ a r r a y = $ r e s u l t - >Ge t Ar r a y ( ) ;
// h a n d l i n g t h e c a s e wh e n t h e r e a r e n o r e s u l t s
i f ( $r es ul t _ar r ay ) {
$ s ma r t y - >a s s i g n ( ' s h o w_ r e s u l t s ' , 1 ) ;
} el s e {
$ s ma r t y - >a s s i g n ( ' s h o w_ r e s u l t s ' , 0 ) ;
}
// s t or e al l c o l u mn n a me s i n a n a r r a y
$ f i e l d _ n a me s = a r r a y ( ) ;
f or ( $i = 0, $ ma x = $ r e s u l t - >Fi e l d Co u n t ( ) ; $i < $ ma x ; $ i ++) {
$ c u r _ f i e l d = $ r e s u l t - >Fe t c h Fi e l d ( $ i ) ;
$ f i e l d _ n a me s [ $ i ] = $ c u r _ f i e l d - >n a me ;
}
// s t or e al l c o l u mn t y p e s i n a n a r r a y
$f i el d_t y pes = ar r ay ( ) ;
f or ( $i = 0, $ ma x = $ r e s u l t - >Fi e l d Co u n t ( ) ; $i < $ ma x ; $ i ++) {
$ c u r _ f i e l d = $ r e s u l t - >Fe t c h Fi e l d ( $ i ) ;
$f i el d_t y pes [ $i ] = $ r e s u l t - >Me t a Ty p e ( $ c u r _ f i e l d - >t y p e ) ;
}
$ s ma r t y - >a s s i g n ( ' f i e l d _ n a me s ' , $ f i e l d _ n a me s ) ;

$ s ma r t y - >a s s i g n ( ' f i e l d _ t y p e s ' , $ f i e l d _ t y p e s ) ;
$ s ma r t y - >a s s i g n ( ' s e a r c h _ r e s u l t ' , $ r e s u l t _ a r r a y ) ;
$ s ma r t y - >a s s i g n ( ' p r o c e s s _ t a b l e s ' , 1 ) ;
}
$ s ma r t y - >a s s i g n ( ' y e a r ' , Da t e ( " Y" ) ) ;
$ s ma r t y - >a s s i g n ( ' mo n t h ' , Da t e ( " m" ) ) ;
$ s ma r t y - >a s s i g n ( ' d a y ' , Da t e ( " d " ) ) ;
$ s ma r t y - >a s s i g n ( ' h o u r ' , d a t e ( " G" ) ) ;
$ s ma r t y - >a s s i g n ( ' mi n u t e ' , d a t e ( " i " ) ) ;
$ s ma r t y - >d i s p l a y ( ' l i g h t _ s h o w. t p l ' ) ;
?>

4.6.2.1.4 Configuring ISL Conference Proxy
1. Login to your ISL Conference Proxy administration (e.g. http://localhost:7615/conf).

2. Go to Configuration -> Advanced -> Integration.
3. Uncheck the Global HTTP Events option and change its value to Yes.
4. Uncheck the Global HTTP Events server option and write the web server IP address in the provided space.
5. Uncheck the Global HTTP Events path option and write / e x a mp l e / e v e n t s . p h p in the provided space.
6. Uncheck the Global HTTP Events strict error checking option and change its value to Yes.
7. Click Save.
You have now enabled global HTTP events on the ISL Conference Proxy and set the proper destination. Please
continue to the next section: Using the viewer script.
4.6.2.1.5 Using the viewer script
Important: Prior to continuing, you should create at least a few ISL Light sessions, otherwise your
database will remain empty!
To browse ISL Light sessions, go to:

http://<web-server-ip>/example/light_viewer.php
You will be able to search the ISL Light session history by specifying various parameters:
time range
domain
user
To view a list of sessions that meet the specified parameters, click the Get button.
Please continue to the next section: Conclusion.
4.6.2.1.6 Conclusion
Please keep in mind that this is a test example and is not suitable for production use without modifications -
here are some pointers to get you started:
XAMPP was used because it is an all-in-one package, you can use other combinations of web server and
database.
Database access is done through the ADOdb library so it is easy to change the database (in this example it
is MySql).
Please check all security-related settings and permissions before putting the server in production!
You will want to implement input checking for production use.
It would be a good idea to set two different users, one with write access (you use that user in the script

e v e n t s . p h p that writes data into the database), the other with read-only access (you use that user in the
l i g h t _ v i e we r . p h p script to get data).
In l i g h t _ v i e we r . p h p there is a setting that should only be used for development purposes - remove it
for production use:
$ s ma r t y - >f o r c e _ c o mp i l e = t r u e ;
The s e s s i o n s _ r a wd a t a table is there for debugging purposes, so that you can see everything that is
sent by the ISL Conference Proxy - if you do not need it, you can modify the e v e n t s . p h p file not to write into
it.
Viewer scripts print various debug info for easier understanding - remove them for production use.
4.6.2.2 IIS Example - ASP.NET script writes to a database
This ASP.NET script (written in VB.NET) accepts ISL Conference Proxy HTTP requests and writes to a database
running on Microsoft SQL Server 2005 Express Edition SP2. There are two additional scripts for viewing
database data from your web browser. One shows the list of all the sessions in the database, conveniently
formatted for easier browsing, while the other one gives you a complete list of parameters for a detailed
inspection of a specific session.
We shall describe the procedure of installing and configuring everything that is needed for using our ASP.NET
example.
We assume that ISL Conference Proxy is successfully installed and running. For instructions refer to the Quick
setup chapter.
We first need to install and configure everything, so please continue to the first step, Installing IIS.
4.6.2.2.1 Installing IIS
The following screenshots were taken on a clean installation of Windows XP Professional and show the
procedure for installing IIS.
Open Control Panel and then follow these steps:


Now that we have IIS installed, we continue to Configuring IIS.
4.6.2.2.2 Configuring IIS
We need to move IIS http port to 8080 and disable https port 443, because ISL Conference Proxy needs these
ports for optimal connectivity.
During this procedure, we shall also set up anonymous access to IIS.
Open Control Panel and follow these steps:







We have moved IIS http port from 80 to 8080, set the anonymous access and started the IIS service, now we
need to disable IIS https port 443.

Open Command Prompt (click on St a r t , click on Ru n . . . , type c md and click on OK), then type (press enter
after each line):
net s t o p w3 s v c
c s c r i pt c : \ I n e t p u b \ Ad mi n Sc r i p t s \ a d s u t i l . v b s s e t w3 s v c / 1 / Se c u r e Bi n d i n g s " "
net s t ar t w3 s v c
Type e x i t to close the Command Prompt window.
IIS configuration is now finished - please continue to Installing .NET Framework.
4.6.2.2.3 Installing .NET Framework
Since our example uses ASP.NET, we need to install .NET Framework.

It is a very simple procedure - just download and run Microsoft .NET Framework 2.0.
After the installation has completed successfully, please continue to Installing MS SQL Server.
4.6.2.2.4 Installing MS SQL Server
We shall use Microsoft SQL Server 2005 Express Edition SP2 as our database server. Since we are doing this
on an almost clean (as mentioned before, we assume that ISL Conference Proxy is already installed and
running) installation of Windows XP Professional, we need to install a new version of Windows Installer first.
This is the procedure:
1. Download and install Windows Installer 3.1, then restart the system when prompted.
2. Download and install Microsoft SQL Server 2005 Express Edition SP2. When prompted to select the
Authentication Mode, select Mixed Mode and set your SQL system administrator password in the field below.

If you are using Windows Vista, check "Add user to the SQL Server Administrator role" on the next screen.
3. Download and install Microsoft SQL Server 2005 Management Studio Express.

Please continue to Configuring MS SQL Server.
4.6.2.2.5 Configuring MS SQL Server
There are two steps in configuring MS SQL Server for our purposes:
1. Adding a new user
2. Creating a new database with all the needed tables
1. Adding a new user

For this example, we shall create a new user called t e s t and set the password to t e s t .
Launch Microsoft SQL Server Management Studio Express and follow these instructions:

2. Creating a new database with all the needed tables
First, we shall create a new database called i s l s u p p o r t :


Now we can create all the needed tables inside our i s l s u p p o r t database.
Download the following files
create-session-event-to-status.sql
create-sessions.sql
create-sessions-events.sql
create-sessions-rawdata.sql
and then run them by double-clicking on them. Microsoft SQL Server Management Studio Express should open
and present you with the contents of the file you just opened. Since the file contains an SQL command that
automatically creates and sets all the table parameters, all you need to do is click on Execute, as shown in the
screenshot below. Each of the above files creates and sets up one table - there are a total of three tables.
Repeat this procedure for each file from the above list.
All the needed tables are now created - we can continue to Configuring ISL Conference Proxy.

4.6.2.2.6 Configuring ISL Conference Proxy
There are two steps in configuring ISL Conference Proxy for our purposes:
1. Adding our scripts to IIS
2. Configuring ISL Conference Proxy to use our script
1. Adding our scripts to IIS

We need to download isl-cp-example-events-to-sql.aspx and put it into the IIS wwwr o o t folder.
Repeat the above download and copy procedure for the following two viewer scripts:
isl-cp-example-events-to-sql-viewer.aspx
isl-cp-example-events-to-sql-viewer-details.aspx
Do not worry about these two for now, we shall use them later, after everything has been configured properly.
2. Configuring ISL Conference Proxy to use our script

We need to configure ISL Conference Proxy in order for it to send http events to our script.
Do the following in order to login into ISL Conference Proxy web administration:
1. Login to your ISL Conference Proxy server.

2. Open a web browser.

3. Enter the following URL h t t p : / / l o c a l h o s t : 7 6 1 5 / c o n f in the address bar.
4. Enter username a d mi n and password a s d (if you changed the default password, then replace a s d with
your current password)
5. Click the Login button.
Now we need to activate http notifications and set all the needed parameters.
Please go to Configuration - Advanced - Integration and set these parameters:
Global HTTP events - set to y e s
Global HTTP events server - set to l o c a l h o s t : 8 0 8 0
Global HTTP events path - set to / i s l - c p - e x a mp l e - e v e n t s - t o - s q l . a s p x
Global HTTP events strict error checking - set to y e s
For the locations of these fields and their values please refer to the screenshot below and follow the numbered
steps.

ISL Conference Proxy integration configuration - the final step of setting it all up - is now complete.
You can view saved session data with your web browser - please continue to Using the viewer script to learn
how to use it.
4.6.2.2.7 Using the viewer script
If you follow the procedure below right away, you shall be presented with empty tables, since this is a fresh
installation of everything and you do not have any session data stored in your database. All the previous
sessions (if any) on your ISL Conference Proxy installation have obviously not been written to our database,
since it was not set up yet. That is why we now ask you to make a few test ISL Light sessions, so that your
database will contain at least a few entries.
From this point on we assume that you have made at least one ISL Light session after completing the previous
sections (installation and configuration steps) and thus having at least one entry in the session database.
Point your web browser to the following URL:
http://localhost:8080/isl-cp-example-events-to-sql-viewer.aspx
You will be presented with a list of sessions, ordered by the date of creation in descending order. The output is
formatted as shown in the screenshot below, containing the most important fields for quick reviewing and

browsing through sessions. There are 20 database entries per page - you can go to previous or next page by
clicking on the pager control below the last entry of the current page. Current position (i.e. page number) is
displayed at the top of the page. In case there are no more entries to be shown when you click the link for the
next page, an error message is shown asking you to return to the previous page.
If you want to see all the parameters sent by the ISL Conference Proxy for all the events that occured, just click
on the Details link next to the session that you are interested in. This will take you to a new page showing every
single parameter, allowing you a detailed inspection of the session, as seen in the screenshots below. Since
there are a lot of parameters, you will need to use the horizontal scroll bar. To return to the session list, simply
press your web browser's back button.


Thank you for reading through this example. We hope that it was helpful and that it showed you how to take
advantage of ISL Conference Proxy's integration abilities. This was just a simple example to get you started, but
it can also be used as a reference or a template for developing your own scripts to suit your specific needs.
4.6.3 XMLMSG
XMLMSG is a way to control ISL Conference Proxy database remotely by using XML messages. XMLMSG is
available as a simple web page entry form or direct HTTP POST access for developers. Most XMLMSG
messages will need the database secret. Please set the database secret in ISL Conference Proxy
administration (available at Configuration - General - Database secret).
Web entry form is particularly suitable for testing or quick database updates. It is available at http://

localhost:7615/xmlmsg_form.html (open the link in the web browser on the server). The message will be sent
by pressing the Send button. Server will respond with a message which describes the actions taken.
HTTP POST can be used to send XMLMSG messages automatically from a program. "Content-Type" of the
HTTP POST request must be set to t e x t / x ml .
Whole protocol specification is available at http://localhost:7615/xmlmsg/relaxng.xml.
This chapter includes the following sections:

Sending messages to ISL Light
Querying session information
4.6.3.1 Sending messages to ISL Light
Messages explained in this section are usually sent as a response to HTTP events instead of a message
<n o me s s a g e / >. For example, you may want to display a message when a certain user logs in using ISL
Light Desk. You will need to handle the NEWSESSION event. You can obtain the session ID from the
SESSIONID field.
Replace d b s e c r e t in the examples below with the appropriate database secret.
Show message box on client

<mo d u l e s e c r e t =" d b s e c r e t " >

<s e s s i o n i d =" s 1 9 _ 3 _ 3 9 0 " >
<s e n d t o =" c l i e n t " >
<ms g b o x >1 </ ms g b o x >
<me s s a g e >Te x t </ me s s a g e >
</ s e n d >
</ s e s s i o n >

</ mo d u l e >
Add tex t to chat on desk


<s e s s i o n i d =" s 1 9 _ 3 _ 3 9 0 " >
<s e n d t o =" d e s k " >
<c h a t >1 </ c h a t >
</ s e n d >
</ s e s s i o n >

</ mo d u l e >
Add tex t to chat on desk (use custom label)


<s e s s i o n i d =" s 1 9 _ 3 _ 3 9 0 " >
<s e n d t o =" d e s k " >
<c p _ l a b e l >s e r v e r : </ c p _ l a b e l >
<c h a t >1 </ c h a t >
</ s e n d >
</ s e s s i o n >
</ mo d u l e >
Terminate session

<s e s s i o n i d =" s 1 9 _ 3 _ 3 9 0 " >
<d r o p / >
</ s e s s i o n >
</ mo d u l e >
4.6.3.2 Querying session information
Querying session information is supported on ISL Conference Proxy 3.1.1 and ISL Light 3.1.1 and later.
Replace d b s e c r e t in the examples below with the appropriate database secret.
Retrieve all sessions

<q u e r y Da t a b a s e s e c r e t =" d b s e c r e t " >

</ q u e r y Da t a b a s e >
Retrieve all sessions for a user



Retrieve all sessions for a domain


Retrieve sessions in a time interval (using XML Schema dateTime)


Retrieve sessions in a time interval (using UNIX epoch time)


Retrieve a session using a database id


Session information
 <! - - t op l ev el e l e me n t , dat abas e i d - - >
<c l i e n t Ad d r e s s >, <d e s k Ad d r e s s > <! - - c l i e n t / d e s k n e t wo r k a d d r e s s - - >
<c l i e n t L a n g u a g e >, <d e s k L a n g u a g e > <! - - c l i ent / des k us er i nt er f ac e l anguage
-->
<c l i e n t Tr a n s p o r t >, <d e s k Tr a n s p o r t > <! - - c l i ent / des k n e t wo r k t r ans por t t y pe
-->
<c l i e n t Ve r s i o n >, <d e s k Ve r s i o n > <! - - c l i e n t / d e s k s o f t wa r e v e r s i o n - - >
<c r e a t e d Ti me >, <c r e a t e d Ti me Da t e Ti me > <! - - c r eat i on t i me ( get c ode) , uni x
e p o c h a n d x ml s c h e ma f o r ma t - - >
<c l i e n t Co u n t r y Co d e >, <c l i e n t Co u n t r y >, <c l i e n t Ci t y >, <d e s k Co u n t r y Co d e >,
<d e s k Co u n t r y >, <d e s k Ci t y > <! - - g e o l o c a t i o n f o r c l i e n t / d e s k - - >
<d e s k Co d e > <! - - s es s i on c ode - - >
<d o ma i n >, <d o ma i n I d > <! - - d o ma i n of t he us er , wh o c r eat ed t he s es s i on
( des k ) - - >
<g r a c e f u l Ex i t >1 </ g r a c e f u l Ex i t > <! - - p r e s e n t , i f t h e s e s s i o n wa s gr ac ef ul l y
t e r mi n a t e d ( n o t c l o s e d b y p i n g t i me o u t ) - - >
<h t t p No t i f i c a t i o n > <! - - c us t om ht t p not i f i c at i on dat a - - >
<l a s t Tr a n s f e r r e d Pa c k e t Ti me > <! - - n u mb e r o f s e c o n d s a f t e r s t a r t Ti me , wh e n
l a s t p a c k e t wa s s u c c e s s f u l l y t r a n s f e r r e d b e t we e n c l i e n t a n d d e s k - - >
<s o f t Us a g e Ti me Su m> <! - - s of t c onc ur r ent u s a g e t i me s u m - - >

<s t a r t Ti me >, <s t a r t Ti me Da t e Ti me > <! - - s e s s i o n s t ar t ( c l i ent c onnec t ed to

d e s k ) , u n i x e p o c h a n d x ml s c h e ma f o r ma t - - >
<t i me L i mi t > <! - - t i me l i mi t of s es s i on i n s ec onds - - >
<t o t a l Co n n e c t i o n Ti me > <! - - t i me i n s e c o n d s f r o m c r e a t e d Ti me - - >
<t o t a l Tr a n s f e r r e d By t e s > <! - - s um of al l t r ans f er r ed upl oad and d o wn l o a d
by t es - - >
<t r a n s p o r t Re c o n n e c t s > <! - - n u mb e r o f a l l s e s s i o n r ec onnec t s , wh e n c l i ent
a n d d e s k we r e d i s c o n n e c t e d t e mp o r a r i l y - - >
, <! - - us er , wh o c r e a t e d t h e s e s s i o n ( d e s k ) -->
<me s s a g e s > <! - - s es s i on me s s a g e s , di al ogs , et c . , z er o or mo r e <me s s a g e >
e l e me n t s : - - >
<me s s a g e i d =" . . . " > <! - - t op l ev el e l e me n t , dat abas e i d - - >
<MSGTYPE> <! - - t y pe of me s s a g e ( r e s u l t s f o r di al ogs , ...) -->
<TI MESTAMP>, <t i me s t a mp Da t e Ti me > <! - - me s s a g e c r eat i on t i me , uni x
e p o c h a n d x ml s c h e ma f o r ma t - - >
<a c t i o n Ty p e > <! - - ev ent t i me , wh e n me s s a g e oc c ur r ed ( eos - end of
s es s i on, . . . ) - - >
<s o f t wa r e Ty p e > <! - - c l i ent or des k - - >
<d a t a n a me =" . . . " >. . . </ d a t a > <! - - c us t om di al og dat a r es ul t -->
4.6.4 Notifications
Using command line parameters - - n o t i f i c a t i o n - t h r e a d and - - n o t i f i c a t i o n - me s s a g e you can

communicate with ISL Light from your own program. Please refer to this topic for a description of these
command line parameters.
Integration example in this topic shows you how to setup a single click remote desktop sharing. The idea is
that you start ISL Light Desk from your program with http-notification-thread command line argument. When a
message is received that ISL Light Desk obtained a session code, ISL Light Client is started and set to
connect with this session code.
This example is available in the following programming languages - please select from the list:
C++ example
VB example
4.6.4.1 C++ example
Download
Download binaries here.

Download sources here.

Source Code
#include <windows.h>
#include <stdio.h>
#define ISL_LIGHT_DESK_EXE "ISLLightDesk.exe"

#define ISL_LIGHT_DESK_COMMAND_LINE "--get-code --username demo --password
demo --notification-message %d --notification-thread %d --auto-close"
#define ISL_LIGHT_CLIENT_EXE "ISLLightClient.exe"
#define ISL_LIGHT_CLIENT_COMMAND_LINE "--connect %d --notification-message
%d --notification-thread %d --auto-close"
void dump_notification_message(bool client, WPARAM wParam, LPARAM lParam) {

printf("%s message (wparam 0x%x lparam 0x%x)\n", client?"Client":"Desk",
wParam, lParam);
if (wParam == 0)
printf("\tunconnected\n");
if (wParam & 1)
printf("\tconnecting with session code %d\n", lParam);
if (wParam & 2)
printf("\tconnected\n");
if (wParam & 4)
printf("\tstreaming\n");
if (wParam & 8)
printf("\treceiving strem\n");
if (wParam & 0x10)
printf("\tserver ID 0x%x\n", lParam);
if (wParam & 0x20)
printf("\tsession ID 0x%x\n", lParam);
if (wParam & 0x8000)
printf("\terror getting the code\n");
}
int main(int argc, char **argv)

{
MSG msg;
// example doesnt have any windows
// create message queue
PeekMessage(&msg, 0, 0, 0, PM_NOREMOVE);
int count = 0;
// start desk
char arg_buff[2048];
char desk_exe[256];
char client_exe[256];
sprintf(arg_buff, ISL_LIGHT_DESK_COMMAND_LINE, WM_USER+2,

GetCurrentThreadId());
if (argc >= 3) {
strcpy(desk_exe, argv[1]);

strcpy(client_exe, argv[2]);
}
else {
strcpy(desk_exe, ISL_LIGHT_DESK_EXE);
strcpy(client_exe, ISL_LIGHT_CLIENT_EXE);
}
printf("starting desk command line: %s\n",arg_buff);
ShellExecute(NULL, NULL, desk_exe, arg_buff, NULL, SW_SHOW);
// Main message loop:

while (GetMessage(&msg, NULL, 0, 0))
{
if (msg.message == (WM_USER+2) || msg.message == (WM_USER+1))
{ //notification message
bool client = msg.message == (WM_USER+1);
dump_notification_message(client, msg.wParam,
msg.lParam);
if (!client && msg.wParam == 1) {
sprintf(arg_buff, ISL_LIGHT_CLIENT_COMMAND_LINE,
msg.lParam, WM_USER+1, GetCurrentThreadId());
printf("starting client command line: %s
\n",arg_buff);
ShellExecute(NULL, NULL, client_exe, arg_buff,
NULL, SW_SHOW);
}
if (msg.wParam == 0) {
count --;
if (count <= 0)
break;
}
if (msg.wParam == 1) { // assume connecting will succeed
count ++;
}
} else {
TranslateMessage(&msg);
DispatchMessage(&msg);
}
}
4.6.4.2 VB example
Download
Download binaries here.

Download sources here.
Source Code
Module1.bas
Attribute VB_Name = "Module1"
Public Type POINTAPI
x As Long
y As Long
End Type
Public Type MSG

hwnd As Long
message As Long
wParam As Long
lParam As Long
time As Long
pt As POINTAPI
End Type
Public Const WM_USER = &H400
Public Declare Function GetLastError Lib "kernel32" () As Long

Public Declare Function ShellExecute Lib "shell32.dll" Alias
"ShellExecuteA" (ByVal hwnd As Long, ByVal lpOperation As String, ByVal
lpFile As String, ByVal lpParameters As String, ByVal lpDirectory As
String, ByVal nShowCmd As Long) As Long
Public Declare Function GetMessage Lib "user32" Alias "GetMessageA" (lpMsg
As MSG, ByVal hwnd As Long, ByVal wMsgFilterMin As Long, ByVal
wMsgFilterMax As Long) As Long
Public Declare Function TranslateMessage Lib "user32" (lpMsg As MSG) As
Long
Public Declare Function DispatchMessage Lib "user32" Alias
"DispatchMessageA" (lpMsg As MSG) As Long
Form1.frm
VERSION 5.00
Begin VB.Form Form1
Caption = "Form1"
ClientHeight = 6735
ClientLeft = 60
ClientTop = 360
ClientWidth = 7245
LinkTopic = "Form1"
ScaleHeight = 6735
ScaleWidth = 7245
StartUpPosition = 3 'Windows Default
Begin VB.TextBox txtOut

Height = 5655
Left = 120
MultiLine = -1 'True
ScrollBars = 3 'Both
TabIndex = 1
Top = 840
Width = 6975
End
Begin VB.CommandButton Command1
Caption = "Start"
Height = 375
Left = 120
TabIndex = 0
Top = 120
Width = 6975
End
End
Attribute VB_Name = "Form1"
Attribute VB_GlobalNameSpace = False
Attribute VB_Creatable = False
Attribute VB_PredeclaredId = True
Attribute VB_Exposed = False
Private Sub Command1_Click()

Dim ISL_Light_Desk_path As String
Dim ISL_Light_Client_path As String
Dim res As Long
Dim params As String
Dim m As MSG
Dim ISL_Light_Desk_Username As String
Dim ISL_Light_Desk_Password As String
ISL_Light_Desk_path = "ISLLightDesk.exe"
ISL_Light_Client_path = "ISLLightClient.exe"
ISL_Light_Desk_Username = "demo"
ISL_Light_Desk_Password = "demo"
params = params & " --get-code"

params = params & " --username " & ISL_Light_Desk_Username
params = params & " --password " & ISL_Light_Desk_Password
params = params & " --notification-message " & WM_USER + 2
params = params & " --notification-thread " & App.ThreadID
params = params & " --auto-close"
ShellExecute 0, "Open", ISL_Light_Desk_path, params, "", 0

txtOut.Text = txtOut.Text & "Starting ISL Light Desk" & Chr(13) & Chr(10)
While GetMessage(m, 0, 0, 0)
If m.message = WM_USER + 2 Then
t = "Desk notification message: "

t = t & "wparam = " & m.wParam

t = t & " lparam = " & m.lParam
txtOut.Text = txtOut.Text & t & Chr(13) & Chr(10)
If m.wParam = 1 Then
params = " --connect " & m.lParam
params = params & " --notification-message " & WM_USER + 1
params = params & " --notification-thread " & App.ThreadID
params = params & " --auto-close"
ShellExecute 0, "Open", ISL_Light_Client_path, params, "", 0
txtOut.Text = txtOut.Text & "Starting ISL Light Client" & Chr(13) &
Chr(10)
End If
ElseIf m.message = WM_USER + 1 Then
t = "Client notification message: "
t = t & "wparam = " & m.wParam
t = t & " lparam = " & m.lParam
txtOut.Text = txtOut.Text & t & Chr(13) & Chr(10)
Else
TranslateMessage m
DispatchMessage m
End If
Wend
End
End Sub

ISL Light 3.3 Manual Frequently answered questions 232
5 Frequently answered questions
Please refer to the Frequently answered questions manual.

Isl Light 3 3 Manual

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Isl Light 3 3 Manual

Uploaded by

Copyright:

Available Formats

ISL Light 3.

2014 Xlab d.o.o., Ljubljana

2014 Xlab d.o.o., Ljubljana

2014 Xlab d.o.o., Ljubljana

2014 Xlab d.o.o., Ljubljana

Please continue to Welcome to ISL Light 3.3 chapter.

1.1 Welcome to ISL Light 3.3

1.2 How it works

Support customers from your office, quickly and professionally.

See ISL Light in action

Starting a remote desktop support session

2014 Xlab d.o.o., Ljubljana

Firew all Friendly

2014 Xlab d.o.o., Ljubljana

Encryption and Maximum Security

View / Show Desktop

Share Keyboard and Mouse

Application / Region Sharing

Reboot & Reconnect

2014 Xlab d.o.o., Ljubljana

Audio & Video

2014 Xlab d.o.o., Ljubljana

Support anyone anywhere anytime

Scalable to your needs

ISL Customer Care

2014 Xlab d.o.o., Ljubljana

1.) Communication level

1.6 System Requirements

ISL Light Desk and ISL Light Client applications:

Microsoft Windows NT 4.0 [1]

2014 Xlab d.o.o., Ljubljana

Microsoft Windows 2000 Server

Supported network types are the following:

2014 Xlab d.o.o., Ljubljana

1.7 More on port 7615

2014 Xlab d.o.o., Ljubljana

Please continue to How to use ISL Light chapter.

2.1 How to use ISL Light

Once connected you can do the following:

2014 Xlab d.o.o., Ljubljana

Please continue to Register ISL Online account chapter.

2.2 Register ISL Online account

Please continue to the first step: ISL Online account registration.

2.2.1 ISL Online account registration

2014 Xlab d.o.o., Ljubljana

2014 Xlab d.o.o., Ljubljana

2014 Xlab d.o.o., Ljubljana

If the selected username already exists, an error message is shown.

2014 Xlab d.o.o., Ljubljana

Please continue to Open inbox chapter.

2.2.2 Open inbox

2014 Xlab d.o.o., Ljubljana

Please continue to Finish registration chapter.

2.2.3 Finish registration

2014 Xlab d.o.o., Ljubljana

2014 Xlab d.o.o., Ljubljana

Please continue to Login to ISL Online account chapter.

2.2.4 Login to ISL Online account

2014 Xlab d.o.o., Ljubljana

2014 Xlab d.o.o., Ljubljana

Please continue to the next step: Create a session.

2014 Xlab d.o.o., Ljubljana

2.3 Create a session

There are two main ways of creating a session.