ISL AlwaysOn 2.0 Manual
Transcription
ISL AlwaysOn 2.0 Manual
ISL AlwaysOn 2.0 Manual ISL AlwaysOn 2.0 Manual Contents 2 Table of Contents Foreword 0 Part I Introduction 4 ............................................................................................................................................................................... 1 Welcome to ISL Alw aysOn 2.0 4 ............................................................................................................................................................................... 2 How it w orks 4 ............................................................................................................................................................................... 3 Features 5 ............................................................................................................................................................................... 4 Reliability 12 ............................................................................................................................................................................... 5 Security 13 ............................................................................................................................................................................... 6 System Requirements 15 Part II Getting started 16 ............................................................................................................................................................................... 1 How to use ISL Alw aysOn 16 ............................................................................................................................................................................... 2 Register ISL Online account 16 .............................................................................................................................................................................. ISL Online account registration 17 .............................................................................................................................................................................. Open inbox 20 .............................................................................................................................................................................. Finish registration 21 .............................................................................................................................................................................. Login to ISL Online account 23 ............................................................................................................................................................................... 3 Add a new computer 26 .............................................................................................................................................................................. Login 26 .............................................................................................................................................................................. Install ISL AlwaysOn 29 .............................................................................................................................................................................. Send Remote Computer Invite 34 ............................................................................................................................................................................... 4 Access a computer 35 .............................................................................................................................................................................. Login 37 .............................................................................................................................................................................. Connect 40 .............................................................................................................................................................................. Control 41 ............................................................................................................................................................................... 5 Features overview 42 Part III Manual 43 ............................................................................................................................................................................... 1 How ISL Alw aysOn w orks 43 ............................................................................................................................................................................... 2 Ways to add a new computer 44 ............................................................................................................................................................................... 3 Access a computer 55 ............................................................................................................................................................................... 4 ISL Alw aysOn GUI 56 .............................................................................................................................................................................. My Computers 58 .............................................................................................................................................................................. Overview 59 .............................................................................................................................................................................. Menu Tab 63 ............................................................................................................................................................................... 5 ISL Alw aysOn ex ecutables and processes 64 ............................................................................................................................................................................... 6 User Management 65 .............................................................................................................................................................................. Grouping 66 ............................................................................................................................................................................... 7 Customization 67 .............................................................................................................................................................................. Command line arguments 67 ............................................................................................................................................................................... 8 Settings 69 .............................................................................................................................................................................. Basic 70 © 2014 Xlab d.o.o., Ljubljana 2 ISL AlwaysOn 2.0 Manual Contents 3 ........................................................................................................................................................................ Computer Status 71 ........................................................................................................................................................................ Access Password 75 ........................................................................................................................................................................ Remote Users 81 ........................................................................................................................................................................ Email Notifications 83 ........................................................................................................................................................................ Computer 84 .............................................................................................................................................................................. Desktop Sharing 86 ........................................................................................................................................................................ Computer Status 87 ........................................................................................................................................................................ Session 88 ........................................................................................................................................................................ Recording 93 .............................................................................................................................................................................. File Sharing 97 ........................................................................................................................................................................ Computer Status 98 ........................................................................................................................................................................ File Sharing 99 .............................................................................................................................................................................. Advanced 109 ........................................................................................................................................................................ Wake On LAN 110 ........................................................................................................................................................................ Sleep Mode 116 ........................................................................................................................................................................ Connection 116 ........................................................................................................................................................................ Filters 117 ........................................................................................................................................................................ History 119 Part IV Server licence 123 ............................................................................................................................................................................... 1 Quick setup 123 ............................................................................................................................................................................... 2 Conference Prox y points of interest 124 ............................................................................................................................................................................... 3 Add a new computer 125 ............................................................................................................................................................................... 4 Access a computer 133 ............................................................................................................................................................................... 5 Customization 135 .............................................................................................................................................................................. Command line arguments 135 ............................................................................................................................................................................... 6 User management 137 .............................................................................................................................................................................. Grouping 138 ............................................................................................................................................................................... 7 Pushing updates 139 ............................................................................................................................................................................... 8 Integration 139 .............................................................................................................................................................................. XMLMSG 139 ........................................................................................................................................................................ Querying computer list 140 ................................................................................................................................................................ Source code 143 Part V Frequently answered questions Index 145 0 © 2014 Xlab d.o.o., Ljubljana 3 ISL AlwaysOn 2.0 Manual 1 Introduction 4 Introduction Please continue to Welcome to ISL AlwaysOn 2.0 chapter. 1.1 Welcome to ISL AlwaysOn 2.0 ISL AlwaysOn is business software for fast and secure access to your PC over the Internet. ISL AlwaysOn automatically handles all special network configurations, therefore remote access can be easy even if both computers are behind a firewall and complex networks. Be more flexible and save time. You can work on your office PC or administer a remote server from home, while on vacation or anywhere else using either Windows or Apple MAC computers. 1.2 How it works Enable Remote Access and Access Your Computer from Anywhere. Set up remote access on a computer or server and gain 24/7 unattended remote access. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Introduction To make your computer accessible over the Internet, you need to log into your ISL Online Account Don't have an account yet? Sign up. 1.3 Once logged in, choose Remote Access from the product list and click on the "Add this Computer" button. 5 After a quick remote access set-up, you can access your PC from anywhere. Log in to your ISL Online Account from any Windows,Mac, or Linux computer or from a mobile device like iPad. Once logged in, click on the 'Connect' button beside the computer you wish to access and enter your Access Password. Download and install the remote access application on your computer and set a computer Access Password. Please note that this password is an important For more information on how to set this up please view the Add a new computer part of security. topic. Features Unattended Remote Access Access a remote computer or remote server from anyw here in the w orld. Remote Work Use ISL AlwaysOn remote access and safely connect to your office PC from another Windows, Mac, Linux computer. You can access your Windows computer also from iPad or iPhone, and experience maximum flexibility of working remotely. View and control a desktop, toggle between multiple monitors, restart the computer or switch users, transfer and synchronise files and folders, print remote documents locally... Work on a remote computer as if you were sitting right there in front of it. Remote File Access Be carefree when you go to a business meeting or on holiday. Access remote files and applications by means of one click. Connect to your home computer or your office PC from any Internet-connected computer or mobile device in seconds. Remote Administration of Unattended Servers © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Introduction 6 Administer Windows 7, Vista or older Microsoft OS computers and servers remotely from anywhere anytime without actually being there. After a quick remote access set-up, you can reach unattended computers and servers through always accessible Web-based access. Easy Setup Follow an automatic remote access set-up and have your remote PC accessible in minutes. Quick Installation Install and configure remote access to your computer or a server automatically without changing settings on your firewall. ISL AlwaysOn executable automatically launches, installs, and configures itself. No restart is required. Firewall-Friendly Worried to end up at a third party's firewalls or NAT proxies? No need. ISL AlwaysOn remote access connects through a firewall, both yours and you clients'. It does not require a special configuration and it will pass even the tightest firewall without even blinking. Web-Based Access Access a remote PC or server via the Internet using any w eb brow ser. No Installation With ISL AlwaysOn, you can access any computer remotely over the Internet. No installation is required; just log in to your user account through any Web browser and click on 'Connect'. Log in From Anywhere Feel free to work on a remote PC from any Internet-connected computer (Windows, Mac, Linux) or an iOS mobile device (iPhone, iPad, iPod touch). Log in to your ISL Online user account and connect to one or more computers and servers with a previously setup remote access application. Mobile Access Access your computer from iPhone or iPad and control your computer from virtually anyw here. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Introduction 7 iOS Mobile You are on the road and need to access your office PC? Grab your iPhone, iPad, or iPod touch and connect to your remote computer in seconds. Use remote access no matter whether you are in a business meeting in a room next door or on an exotic holiday halfway around the world. Provide remote support and server administration from anywhere. Learn more about remote access from iPhone and iPad. Remote Computer Management Manage remote computers from one place Name Tags Give each remote computer a name tag for easier recognition. Keep them organised for a quicker search through your list of remote devices. Remote Computer Sharing Multiple operators of your help desk support centre can access unattended computers and servers and provide remote support. With ISL AlwaysOn remote access software, you can share remote computers among co-workers without any additional installation. Once the administrator of ISL Online account has set up remote access to a computer, he/she can pass the access rights to help desk operators in just a few clicks. Online Status Display See which computers are online and available for remote access. Turbo Desktop Control Access your PC and w ork remotely w ith virtually no delay. Also w hen view ing high definition content. Full Remote Access Access remote computers and control them using administrator rights. In this way, you can reboot a computer and reconnect into the same remote access session, switch between users, send Ctrl+Alt+Del, install software, or do whatever you would if sitting right there in front of it. Best Quality Sharing © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Introduction 8 Is the quality of viewing a remote desktop important for your remote access? If yes, then choose the best quality option. It delivers smooth high definition content sharing with almost no delay if the bandwidth on both sides is good enough. High Speed Sharing Default option. You will hardly notice you are working on a remote computer as there is practically no delay. The high speed option provides a remote desktop with 256 colours and is recommended for lower bandwidth connections. Adjust Viewing Window Zoom in or zoom out, get the exact size of your remote desktop or adjust it to fit into a viewing window. Multi Monitor Navigation Enjoy simple remote desktop control of multiple monitors. Access Multiple Monitors Access and control remote computers with one or multiple monitors. Toggle between different monitors or fit all monitors into one screen. ISL AlwaysOn’s default option shows all monitors on one screen side by side. Choose One Monitor Limit your remote view to one monitor. Although you can view multiple monitors of a remote computer, you might still want to work on one desktop alone. Please see our manual to learn how to limit a remote view to one monitor. Administrator Rights Access a remote computer w ith administrator rights Reboot and Reconnect Install software remotely, restart a PC and automatically reconnect to the same remote access session. Do anything on a remote computer as if you were on your PC. Blank Screen If you prefer privacy during your remote access, you can always turn on black screen on the remote computer. The remote desktop will be hidden behind a black screen. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Introduction 9 Send Ctrl+Alt+Del Send Ctrl+Alt+Del to a remote desktop to perform administrative tasks, start a task manager, switch between users or log off, all without interrupting the session in progress. Easy File Transfer and Sync Quickly transfer files and folders betw een computers in both directions SendTo Use an integrated SendTo option in the Windows Explorer menu (available to Windows Vista and Windows 7 users). Right-click on the selected file or folder, open ‘Send to’, and choose ISL Light to send the documents to a remote computer. File Manager Manage a file transfer. Change the default destination folder, pause or resume a file transfer, or limit the file transfer's bandwidth usage. Drag & Drop To transfer files from a remote to a local computer, simply drag the files or folders on one computer and drop them into the ISL Light GUI. Or transfer documents in the other direction - from a local to a remote computer. File Sync If you often transfer files between your home and your work computer, you will appreciate the file synchronisation option. Remote Printing Access a remote computer and share a printer. Print a local document on a remote printer, or print remote computer's documents on your local printer. Share Printer The ISL Light Remote Printing feature allows you to share a printer with a remote user during remote computer access. It requires a simple, one-click-and-one-time installation of the ISL Remote Printer driver on the remote computer. Print Remotely © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Introduction 10 Share a printer and provide a remote user with your local document’s hard copy without sending the file over. Or print a remote user’s document on your local printer. Just open a document and choose ISL Remote Printer in the Print menu to send it to the remote printer. Please read more at Remote Printing in the manual. Session Recording Record remote desktop sessions for later playback. Improve remote access management and security w ith the help of session recordings. Record Remote Desktop Sessions Have you granted remote access to your computer to others? For security reasons, you can capture everything or just selected parts of the remote access to your computer. You can record desktop sharing, video, audio and text chat, and then play back each recorded element in a separate window. ISL Recording Player A session recording is originally saved in a special highly compressed .isr format, which requires ISL Recording Player for playback. Please download ISL Recording Player for FREE and play back everything you have recorded - desktop sharing, text chat, video and audio communication, with a lot of playback options. Automatic Session Recording Automate session recording at the beginning of every remote access to your computer. To do that, just open ISL AlwaysOn on the remote computer, open the ‘Security’ tab and check ‘Enable session recording’ under Session Options. Convert to .avi Save session recordings, play them again and easily convert the highly compressed .isr format into .avi. Remote system information Run computer diagnostic tools and instantly gather vital information about a remote printer computer's hardw are and softw are. Instant Remote Diagnostics After establishing the remote access connection with a client, run remote diagnostic tools to access the complete system © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Introduction 11 information of the remote computer easily. Get a snapshot of basic data followed by a complete list of the remote system information. Remote System Information at Hand Having in-depth software and hardware information always at hand is sometimes indispensable when working on a remote computer. Run the computer diagnostic tools, save the file with remote system information details and raise the efficiency of your remote access session. Have instant access to basic information about the System, CPU, Memory and Data Drives. List information of all on-going processes and applications on the remote system, view all the active hardware and software drivers and more. Secure Remote Access Have carefree access to a remote computer. ISL Alw aysOn guarantees maximum remote access security w ith top industry standards security technologies: AES 256 Bit SSL, Verisign certificate and a computer access passw ord. AES 256-bit End-to-end Encryption AES 256 Bit SSL (Secure Sockets Layer) tunnel is established between two connected computers during remote access. All the information exchanged between your and remote computer is encrypted end-to-end, meaning that nothing can decrypt the contents of the session transferred from one side to another. VeriSign Certificate ISL Online remote access application is digitally signed by means of a VeriSign Code Signing certificate. Lock Feature Lock your computer to block others from accessing it remotely. If you have permitted access to your computer to other people, use the temporary lock feature when leaving for your holidays. Military Strength Encryption The Advanced Encryption Standard (AES) is an encryption standard adopted by the U.S. government for data security and is now used worldwide. If the lower 128-bit hard drive-based encryption suffices to address all commercial, bank and non-top secret government applications, the 256-bit AES, also used in ISL Online’s remote access security, is known as military strength encryption. It protects top secret government information and has a higher security level than your online banking. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Introduction 12 Computer Access Password Installing ISL AlwaysOn on a computer does not yet enable remote access itself. Only after you have also set a locally stored computer access password, will the computer become available for remote access. ISL Online Remote Access Security Learn more about ISL Online’s remote access security by reading the Remote Desktop Security Statement. 1.4 Reliability ISL AlwaysOn, as a part of ISL Online network, uses an architecture that is designed for maximum reliability, security and performance. With ISL AlwaysOn's screen-sharing technology and intuitive interface, accessing remote computers could not be easier - simply add computers to your list and then access any of them from anywhere on the internet. Access any computer anywhere anytime ISL AlwaysOn sessions are established through a global network of servers called ISL Online network. It assures 24/7 availability of the service with a strong and reliable desktop connection between any two points in the world. ISL Online network's 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 points. Scalable to your needs You can rely on ISL AlwaysOn to optimize its performance regardless of your Internet connection or the number of computers being accessed remotely. Whether you are accessing 1 or 1,000 computers, our compression mechanisms and color depth dynamically adapt to your Internet bandwidth, enabling optimized speed and quality of the remote screen. We are committed to taking your ISL AlwaysOn sessions to a seamless and © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Introduction 13 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://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 Introduction Security should be a crucial part of a remote access product, no matter for what purposes you are using it; business or personal. ISL AlwaysOn uses maximum security. ISL AlwaysOn is secured on multiple layers: 1. ISL AlwaysOn computer to ISL Online products user visibility. 2. ISL AlwaysOn computer access password. 3. ISL Light remote desktop session security. 4. MS Windows OS access security scheme. Each ISL AlwaysOn connection from a computer to an ISL Conference Proxy server is encrypted with SSL. ISL AlwaysOn's activities can be monitored by tracking the history of accesses to a computer. This report shows which ISL Online users accessed the computer and when they accessed it. A user can always lock access to his/her computer. When disabled, that computer becomes inaccessible until further action. 1st layer - ISL Alw aysOn computer to ISL Online products user visibility To access a remote computer, you need to establish a link between your ISL Online account and a computer you want to add access to. Each user has its own digitally signed executable identifying his/her ISL Online user account. No other ISL Online user will be able to see or try to start a remote connection if the ISL AlwaysOn computer administrator has not installed a customized ISL AlwaysOn program. The procedure of adding a new computer is described in the Add a new computer chapter. 2nd layer - ISL Alw aysOn computer access passw ord Installing ISL AlwaysOn on a computer does not completely enable access to the computer. To enable access, a strong access password must be set first. This password is stored in the Local Machine registry as MD5 hash. The plain text password is not available anymore. After installing ISL AlwaysOn and setting the access password, remote access for the specific ISL Online user is finally enabled. Whenever the ISL Online user wants to connect to the remote computer, he/she needs to enter the ISL AlwaysOn access password for each remote access session he/she starts. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Step 1. Introduction ISL Online products user <challenge> = generate challenge send "encrypt(authentication_required({chmd5, <challenge>}))" request input of password make chal-passmd5=md5(challenge,md5(password)) send encrypt("authenticate({chmd5, <chal-passmd5>})") 4. 5. request = decrypt(received_data) if request[key] = chmd5 then load md5-password from registry into memory if request[1] = md5(challenge, md5-password) then set authenticated user = true send encrypt("get_code") else send encrypt("error authentication failed") end else send encrypt("error authentication not supported") end if received = get_code then start ISL Light Desk, request code send encrypt("code <ISL Light session code>") else goes again to step 3. end 6. 7. ISL AlwaysOn computer send encrypt("connect") 2. 3. 14 received = decrypt(recieved_data) if received = "code <code>" then start ISL Light Client with --connect <code> set authenticated user = false end ISL Light Desk is connected into session ISL Light Client is connected into session 3rd layer - ISL Light remote desktop session security The remote desktop control session is enabled by ISL Light. ISL Light (version 3.1) enables to create an instant remote desktop control session, which is secured with SSL (a 1024-bit RSA key for the handshake and a 256bit AES session key). Once a session is established, no one can see this session's encrypted data. And when an ISL Light session is ended you cannot connect to the same session again. For more information on ISL Light security, please refer to this link. 4th layer - MS Window s OS security Once an ISL Online user is connected to a remote computer, he/she can see the Windows console desktop session running on the computer. It is recommended that the user sets passw ords for all Window s accounts and disables accounts w hich are not in use. The user should always log off the computer when not © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Introduction 15 present, so when accessing the computer he/she needs to type in the Windows account password. 1.6 System Requirements Operating Systems: Microsoft Windows 7 (32-bit and 64-bit) Microsoft Windows Vista (32-bit and 64-bit) Microsoft Windows XP (32-bit and 64-bit) Microsoft Windows 2000 Microsoft Windows Server 2000 Microsoft Windows Server 2003 Microsoft Windows Server 2008 Apple MAC OS X Snow Leopard 10.6 or higher Internet Connection: ISL AlwaysOn uses less than 1 KB/minute when a computer is connected to ISL Online Network servers. When connected to a remote computer, the required bandwidth minimum is not defined, although we recommend at least a 50 kbits/s connection for more comfortable work. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual 2 Getting started 16 Getting started Please continue to How to use ISL AlwaysOn chapter. 2.1 How to use ISL AlwaysOn ISL AlwaysOn is a part of ISL Online family of products and there are two user models: a hosted service (1-year subscription or PayPerUse Coupon) and a stand-alone server application (Server License). Using ISL AlwaysOn as a hosted service, a secure connection is established through the ISL Online network ISL Online's massive network of servers worldwide. Using ISL AlwaysOn as a server licence, a secure connection is established through your server (or a grid of your servers) running ISL Conference Proxy. ISL AlwaysOn works on both Windows and Apple Mac platforms. This chapter describes the basic setup procedure and main features of ISL AlwaysOn. You need to do the following: 1. Register an ISL Online account 2. Add a new computer 3. Access a computer When you complete this basic procedure, please continue to the Features overview chapter to learn the ISL AlwaysOn usage basics. Please continue to the first step: Register ISL Online account. 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. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual 2.2.1 Getting started 17 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 AlwaysOn Remote Assistance software, 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. ISL Online Account Registration page will appear. You should enter a valid e-mail address which will serve as your future ISL Online Account name: © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 18 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. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 19 If the selected username already exists, an error message is shown: © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 20 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. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 21 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. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 22 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. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 23 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 a 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 Login button to enter your ISL Online Account. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 24 Select Forgot your 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: © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 25 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: Add a new computer. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual 2.3 Getting started 26 Add a new computer This chapter describes the basic instructions on how to add a computer to your list of computers. It involves two steps: 1. Login 2. Install ISL AlwaysOn Please continue to the first step: Login. 2.3.1 Login Please follow these steps: 1. Please go to ISL Online home page. 2. Click on the Log In button top right side of the web page. 3. Enter your ISL Online username and password in the provided space. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 27 4. Click the Products tab on the My Account page. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 28 5. Here you will see a list of your Remote access computers. If you do not have any setup then click Dow nload to add the computer you are currently using to the list. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 29 Please continue to the next step: Install ISL AlwaysOn. 2.3.2 Install ISL AlwaysOn 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 following topic in the ISL LIght manual: Checking system account connection settings Please follow these steps: © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 30 1. Click the marked icon to download ISL AlwaysOn for this computer. 2. A security warning should appear - select Run (Windows) Open (MAC). Important: To install ISL AlwaysOn, administrative privileges are required! © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 31 3. ISL AlwaysOn setup wizard will appear. Click Next (windows) Continue (MAC) and follow the wizard. NOTE: Skip to Step 5 if ISL AlwaysOn is already installed on this computer. 4. ISL AlwaysOn will now prompt you for the password. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 32 As an important part of security, you need to set a strong access password. You will need to provide the access password each time you try to access the remote computer. The access password can be changed in the Computer Access Configurations, but everybody having access to this computer has to be informed about the change. The password is stored locally in the computer registry. 5. Once you have typed in the password you will see this box. Note: If you have already installed ISL AlwaysOn to the current PC and are just adding a new user to the current PC click on the Grant Access button. 6. After the access is granted, you will see the ISL AlwaysOn Overview Remote Access box. a) Select the server from the drop down list (for hosted users select: ISL Online Network). b) Type in your ISL Online Username and Password (check remember password if you would like ISL AlwaysOn to remember your account details). © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 33 c) Click "Login" to access your account. The same screen can later be reached simply by double-clicking the ISL AlwaysOn icon in the taskbar - the icon appears after the installation of ISL AlwaysOn: © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 34 You have now successfully added a computer to your list. Please continue to the Access a computer chapter to learn how to access that computer from anywhere. 2.3.3 Send Remote Computer Invite To connect to a remote computer you first need to send that computer an invitation code/link. Once the end user clicks the link, the installation will take place. Once setup the computer will be added to the ISL AlwaysOn computer list. Please follow these steps: 1. Click on the Add Remote Computer link as shown in the example below. 2. Type in the email address of the computer you wish to send the link to. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 35 Note: You can also contact the person sat next to the computer and ask them to enter the 12 digit code manually. To enter the code you need to ask the client to: a. Navigate to www.islonline.com b. Click on Join Session located at the top of the website. c: Enter 12 digit code (in the following format xxx-xxx-xxx-xxx) into the white box. d. Click Connect. 2.4 Access a computer This chapter describes the basic instructions on how to access a computer from your list of computers. It involves three steps: 1. Login 2. Connect © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 36 3. Control Please continue to the first step: Login. Tip: If you access your computers on a regular basis and want to store a direct link on your desktop follow the quick guide below. 1. Login to the ISL Online website www.islonline.com 2. Click the Login Box top right corner of the web page. 3. Enter your Login details and click Log In. 4. Click on the Products Tab from the My Account menu bar. 5. Click Remote Access from the list of options. 6. Locate the computer/s you wish to store on your desktop and right click the Connect button. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 37 7. Click Save link as... and locate your desktop from the Save As box that appears on screen. 8. Click Save and the link to this computer will appear on your desktop. All you need to do is load the file from the desktop and enter the unique password in the connection box that appears on screen. Once entered successfully you will have access to the computer. 2.4.1 Login Please follow these steps: 1. Please go to ISL Online home page. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 38 2. Click on the Log In button top right side of the web page. 3. Enter your ISL Online username and password in the provided space. 4. Click the Products tab on the My Account page. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 39 5. Here you will see a list of your Remote access computers. If you do not have any setup then click Dow nload to add the computer you are currently using to the list. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 40 Please continue to the next step: Install ISL AlwaysOn. 2.4.2 Connect Please follow these steps: 1. You will be presented with a list of computers. Click Connect next to the computer you wish to connect to. 2. A security warning will appear - select Run. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 41 3. When prompted, enter the remote computer's access password and click OK. Please continue to the next step: Control. 2.4.3 Control ISL Light will automatically start on both your (ISL Light Desk) and the remote computer (ISL Light Client), exchange a session code and connect. ISL View window will appear and you can start working on the remote computer as if you were there. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Getting started 42 Please continue to the Features overview chapter. 2.5 Features overview ISL AlwaysOn in its current form is a kind of a wrapper around ISL Light - all the computers that you have added to your list have a service running that allows you to connect to those computers without someone manually entering a session code. When you are connected through ISL AlwaysOn, the situation is identical to the situation where you are connected directly using ISL Light, with the addition of automatically enabled administrative mode and restart and resume support. Please refer to the ISL Light manual for more information on ISL Light, especially the following chapters: In session features ISL Light GUI Desktop sharing © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual 3 Manual 43 Manual This manual describes ISL AlwaysOn 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 AlwaysOn that are specific for server licence users. This manual is divided into the following sections: How ISL AlwaysOn works Add a new computer Access a computer ISL AlwaysOn GUI ISL AlwaysOn executables and processes User Management Customization Settings 3.1 How ISL AlwaysOn works ISL AlwaysOn is a business software for fast and secure access to your PC over the Internet. ISL AlwaysOn automatically handles all special network configurations, therefore remote access can be easy even if both computers are behind a firewall and complex networks. Be more flexible and save time. You can work on your office PC or administer a remote server from home, while on vacation or anywhere else. You have a list of your computers within your ISL Online products username with computer descriptions and their status. You can access any online computer from the list from anywhere in the world or add new computers. You assign an access password to each computer and you need to enter it for each access. ISL AlwaysOn in its current form is a kind of a wrapper around ISL Light - all the computers that you have added to your list have a service running that allows you to connect to those computers without someone manually entering a session code. When you are connected through ISL AlwaysOn, the situation is identical to the situation where you are connected directly using ISL Light, with the addition of automatically enabled administrative mode and restart and resume support. ISL Online offers two user models ISL AlwaysOn 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 © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 44 established through the ISL Grid - ISL Online's massive network of servers worldwide. 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. 3.2 Ways to add a new computer Important notice when cloning an installation: If you are using ISL AlwaysOn 1.2.2 or newer, please follow these instructions, otherwise follow the notice below this one. ISL AlwaysOn can also be installed in environments where computers are installed as clones from one master image. First ISL AlwaysOn is installed (with predefined changes) onto the master computer, but final steps are then performed on cloned computers. Before cloning the master image to target computers, the master machine must have ISL AlwaysOn already installed and please make sure that you have granted access to all the desired users (the users that you intend to allow access to cloned computers). Having done that, please follow these steps: 1. Stop ISL AlwaysOn service on the master machine (go to command prompt and execute net stop isl_always_on) 2. Close any ISL AlwaysOn computer configuration dialogs that might be running. 3. Open regedit and navigate to HKEY_LOCAL_MACHINE\SOFTWARE\ISL Online\ISL AlwaysOn 4. Delete the binary content key called uid 5. Create a new binary content key called _ghost_ with content 01 This concludes the preparation steps - you should now shut down the master computer and clone it. Please be extra careful not to boot the master computer after the last step or the cloning process will not work properly! Important notice when cloning an installation and using an older version of ISL AlwaysOn (version lower than 1.2.2): In case you are cloning an installation, please make sure that the following key is not present in the registry prior to cloning: KEY_LOCAL_MACHINE\Software\ISL Online\ISL AlwaysOn\uid © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 45 This key represents a unique machine ID and does not get deleted when you uninstall ISL AlwaysOn! If it remains on the machine and gets cloned, then all machines will have this key with the same ID, effectively identifying themselves as the same computer. To avoid this, please follow the correct procedure for situations where cloning is involved 1. Make sure that the key mentioned above is not present on the machine before cloning. If you have previously installed ISL AlwaysOn on that machine, it will be there, otherwise not. 2. Clone the computer to n computers. 3. Install ISL AlwaysOn manually on each of the n computers. 4. Each cloned computer will now have a unique machine ID for ISL AlwaysOn and you will see them all in your list of computers. 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 following topic in the ISL Light manual: Checking system account connection settings Server license users: The procedure for server license differs from the procedure for hosted service users please go to this topic for more information. Apart from the procedure described in the Add a new computer topic (in the getting started section), there are also additional options when adding a new computer: 1. Please go to ISL Online home page. 2. Click on the Log In box to the top right of the web page. 3. Enter your ISL Online username/email and password and press Log In. 4. Click the Products tab to view the remote access "My Computers" area. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 46 5. You can send these instructions via email by clicking the Send button - if you choose this option, please proceed to the next step (step 7). The procedure can also be performed manually - if you choose this option, please skip to step 9. 6. Invitation page will appear. Provide the email address(es), click the Send Invitations button and automatically generated invitation will be sent out immediately. If you want to modify the content of the message seen in the Preview, click the Change button, enter your changes and Apply them: © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 47 7. The recipient will receive an e-mail that looks like the picture below. If the recipient follows the grant link, please proceed to step 11. If the grant link does not work and the recipient follows the alternate link, please proceed to the next step (step 8). © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 48 8. Instruct your client to navigate to http://www.islonline.net/join from the computer to be available to the ISL AlwaysOn user and then tell him/her to enter the code that was displayed to you in the step 5. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 49 9. The client will see the Grant remote access confirmation page. If the client agree to grant access to the current computer to the user who has issued the user code, he/she should click the Grant Access button. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 50 10. A security warning will appear - the client should select Run. Important: To install ISL AlwaysOn, administrative privileges are required! © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 51 11. ISL AlwaysOn setup wizard will appear. The client should click Next and follow the wizard. 12. ISL AlwaysOn will now prompt for the password. As an important part of security, the client will need to set a strong access password. This password is required for every access to the remote computer. The access password can be changed in the ISL AlwaysOn Settings (click here for more info), but everybody having access to the client's computer has to be informed about the change. The password is stored locally in the computer registry. Obviously, the client will need to contact you and tell you the password in order for you to access the client's computer. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 52 13. The client should click OK to grant access. 14. After the access is granted, the client will see the ISL AlwaysOn window. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 53 16. Login using your ISL Online product username and password assigned to you by your ISL Online account holder. Process to add a new computer: 1. Click Add Remote Computer. 2. An email will open with the invitation code, and grant link. Now you just need to type in the email address you wish to send it to. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 54 3. The email is now sent to client, please ask client to navigate to this address. Once he opens the link he will see option to Grant Access as shown below. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 55 How to access ISL Alw aysOn through the task bar Another way of accessing ISL AlwaysOn is simply by double-clicking the ISL AlwaysOn icon in the taskbar this icon appears after the installation process for ISL AlwaysOn is complete: You have now successfully added a computer to your list. Please continue to the Access a computer chapter to learn how to access that computer from anywhere. 3.3 Access a computer Server licence users: The procedure for server licence differs from the procedure for hosted service users - please go to this topic for more information. Apart from the procedure described in the Access a computer topic (in the Getting started section), where you chose the Run option in step 5, you can also choose Save and save the executable for later use - e.g. place it on your desktop and rename it to a more friendly name, e.g. J o h n ' s h o me c o mp u t e r . e x e . When you wish to access that remote computer, simply double-click the executable on your desktop, enter your ISL Online products username and password when prompted, then the computer access password and you will be connected - there is no need to visit ISL Online web pages each time. It is possible to use command line arguments for ISL AlwaysOn Connect, allowing you to skip the password entry form. All the parameters are specified as "key=value". Available parameters: Username (you can use it to provide your ISL Online username, e.g. \ \ my c o mp a n y \ u s e r 1 ) Passw ord (you can use it to provide your ISL Online password) ComputerPassw ord (you can use it to provide the computer access password) ComputerPassw ordMD5 (you can use it to provide the raw computer access password as written in the registry - check HKEY_ L OCAL _ MACHI NE\ SOFTWARE\ I SL On l i n e \ I SL Al wa y s On \ p a s s wo r d ) StreamOptions (you can use it to enable the desired checkboxes [separate them with a semicolon] in the list, e.g. s ma l l _ f o o t ; l e a v e _ b a c k g r o u n d ; ) If you specify a username, password and a computer password (either in plaintext or as MD5), you will get a single-click solution that connects to a certain ISL AlwaysOn machine without having to enter any credentials or login to your ISL Online account beforehand. Important: Please keep in mind that if you create a shortcut and set those parameters for it, anyone with access to your machine can do a right-click on that shortcut and read the parameters. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 56 Example: I SL Al wa y s On Co n e n c t . e x e " Us e r n a me =\ \ my c o mp a n y \ u s e r 1 " " Co mp u t e r Pa s s wo r d =a c c e s s p wd " 3.4 " Pa s s wo r d =u s e r p wd " ISL AlwaysOn GUI ISL AlwaysOn GUI consists of two separate parts - the first part is the computer access configuration window that can be reached by double-clicking the ISL AlwaysOn icon in the taskbar - the icon appears after the installation of ISL AlwaysOn: Login Box When you load ISL AlwaysOn either by right clicking on the icon in the task bar, then clicking Open on the selection you will be shown the Login Box. To login you need to enter your Username and Passw ord. Tick the Remember me check box if you wish the computer to remember the details for next time you login. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 57 For help at any time click on the (?) button. You will be directed to the relevant topic on our help center manuals. Important: If you use only the global access password and change it, other users will obviously not be able to connect until you tell them the new global password. Consider using a password for each user or one-time global passwords to avoid such situations. To view some more detailed information about the ISL AlwaysOn GUI click on the links below. My Computers Overview Menu Tab Once your connection to the computer is established you will notice the ISL Light GUI. Please refer to the ISL Light manual for more information on ISL Light, especially the following chapters: © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 58 In session features ISL Light GUI Desktop sharing 3.4.1 My Computers My Computers Here you will see a list of all the computers that you have access to. It states the IP Address of the computer, the status whether it is online or offline, tags associated with the computer, and the action to connect to the computer if it is available and online. You can add a new remote computer by clicking on the Add Remote Computer button at the bottom of the My Computers window. If you have a long list of computers in the list, then the search function may come in handy. To search for computers in the list type in the IP Address (if you have it to hand) or any combination of characters that enable you to dictate what the computer is called. Example: © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 59 1. If I search for PC in the search box then I will only see WORKGROUP\ADAM-PC and WORKGROUP\ADAMDESKTOP-PC in the list. 2. If I search for 90.212.135.17 (or the first few numbers) in the search box then I will only see WORKGROUP \ADAM-LAPTOP in the list. For help at any time click on the (?) button. You will be taken to the relevant topic on our help center manuals. 3.4.2 Overview Overview Here you can change the Computer status, add Remote Users, customize File Sharing, and view the Access History of the connection (please view this topic for more information). © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 60 The overview allows you to view the general details regarding this computers setup. You can logout by clicking on the blue Logout button at the top right. For help at any time click on the (?) button. You will be taken to the relevant topic on our help center manuals. Computer Status You can change what is accessible on this computer by clicking on the Change button. It will allow you to enable/disable Remote Access, Desktop Sharing, and File Sharing. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 61 Remote Users Here you will see a list of all the users who have access to the computer. To add a new user to the list of shares click on the Add button. It will prompt you to first select the server (for hosted users: ISL Online Network), type in the new users granted access code, or username and password. Click Grant Access to confirm or Cancel to quit. To view more help click on the (?) Button to the bottom left. You will be taken to the relevant topic on our help center manuals. File Sharing You can select which folders on the computer can be shared and access by the supporter. Click on the Add button to browse for folders you wish to share on your computer. For more information click here. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 62 Access History The access history is where you can search what connections have been made using your account, desktop connection start and end times, and other useful information. To view more help click on the (?) Button to the bottom left. You will be taken to the relevant topic on our help center manuals. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual 3.4.3 Manual 63 Menu Tab Menu Tab At the top left of the control panel you will see a green ISL AlwaysOn clickable button. Once you click on it, it will bring up a sub menu where you can select Language, Settings, Help, About, Close Language There are many languages you can select in ISL AlwaysOn. Languages are as follows: English, German, Japanese, Slovenian, Serbian (Cyrillic and Latin). © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 64 Settings This will bring up the ISL AlwaysOn settings. Help This will take you to the Online Help Manuals. About You would go here if you would like to check for latest updates and the current version number. Close Closes the ISL AlwaysOn window. 3.5 ISL AlwaysOn executables and processes This topic describes executables and processes that are running/started on a computer that has ISL AlwaysOn installed as well as on computer that is trying to connect to it via ISL AlwaysOn Connect. On server side: I SL Al wa y s On Se r v i c e . e x e (watchdog service process - it ensures that ISLAlwaysOn server process is always running) © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 65 I SL Al wa y s On . e x e (main process that serves ISL AlwaysOn functionality) I SL Al wa y s On Mo n i t o r . e x e (proxy process is started in each windows session - this program starts ISL Light program in the appropriate session) I SL Al wa y s On . e x e (tray process is started in each session - it shows ISL AlwaysOn status icon in system tray) When a user connects, I SL Al wa y s On Mo n i t o r . e x e will start I SL L i g h t . e x e that will enable restart and resume: I SL L i g h t . e x e (main ISL Light program showing GUI in serving remote desktop session) I SL L i g h t Se r v i c e . e x e (watchdog service process - it ensures that ISLLight process is always running; proxy process that starts desktop streaming service under appropriate account) I SL L i g h t Se r v i c e . e x e (desktop streaming service process) i s l l i g h t . e x e (main ISL Light program showing GUI in serving remote desktop session that was restarted due to FUS, restart or logoff) So on the computer there might be running many I SL Al wa y s On Mo n i t o r . e x e processes (one for each windows session) and there might be running many I SL Al wa y s On . e x e processes showing tray icon status (one for each windows session). On client side (accessing remote desktop) there are only two processes: I SL Al wa y s On Co n n e c t . e x e (process where you enter your ISL Online product password, computer access password and see the connection progress) I SL L i g h t . e x e (main ISL Light program that is started by ISL AlwaysOn Connect) 3.6 User Management Server licence users: The procedure for server licence differs from the procedure for hosted service users - please go to this topic for more information. 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: © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 66 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) 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 . Useful hint: It is possible to share a computer from one user's list with another user. Please check the following topic for instructions: Grouping Warning: "Back to simple administration" option deletes your ISL Online Domain and all users within this domain! 3.6.1 Grouping It is possible to share a computer from one user's list with one or more other users from the same domain. Please note that it is required to have a registered ISL Online domain within your ISL Online account. If you have not done it yet, please do so before following the procedure below. Check the user management topic for instructions. With a registered ISL Online domain your ISL Online product username will look like this (replace my d o ma i n with your ISL Online domain and u s e r with the appropriate username): \ \ my d o ma i n \ u s e r If you have not done it yet, you should create at least one more user within your ISL Online account, e.g. u s e r 2 . Now you can login with the user that wishes to share a computer, e.g. \ \ my d o ma i n \ u s e r and click Edit next to the desired computer from the list. You will see an option called Share this computer w ith - mark the checkbox and enter the desired ISL Online product username, e.g. u s e r 2 and click Save changes. From that moment on, the user \ \ my d o ma i n \ u s e r 2 will see that computer in his/her list (with a comment © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 67 about the owner below the computer description), but available options next to that computer will only be Connect and History (instead of Connect, Edit, Delete, History), since that user is not the owner. When the user \ \ my d o ma i n \ u s e r 2 clicks History, he/she sees only his access history. When the user \ \ my d o ma i n \ u s e r (i.e. the main user) clicks History, he/she also sees only his access history. If you open ISL AlwaysOn GUI at the remote computer and click History, you can see a list of all accesses. The main user (in this case \ \ my d o ma i n \ u s e r ) can remove the sharing at any moment by clicking Edit next to that computer and removing the checkbox next to the appropriate user in the Share this computer w ith section. 3.7 Customization Server licence users: The procedure for server licence differs from the procedure for hosted service users - please go to this topic for more information. The following ISL AlwaysOn customizations are available at the moment: change the icon for each computer in the list change the description for each computer in the list command line arguments (e.g. implementing silent install) Apart from these ISL AlwaysOn customizations, you can use customizations that are specific to ISL Light. Please refer to the following chapter in the ISL Light manual for more information: ISL Light customization Please note that certain options are already used or enabled due to the way ISL AlwaysOn works, e.g. desktop sharing is automatically started, control is automatically granted, administrative mode and restart and resume support activated etc. 3.7.1 Command line arguments ISL AlwaysOn is controlled through command line parameters. When installing ISL AlwaysOn through product pages, the same parameters are used as a whole command line in the CGI parameter c md l i n e . Important: These command line arguments are discarded when passed to push upgrade of ISL AlwaysOn from ISL Conference Proxy, so you cannot use them when doing a push upgrade. They are also not used when ISL AlwaysOn management dialog or setup is started from a non-admin or non-system account. In order to allow the ISL AlwaysOn management dialog (and use command line arguments) under system account please add the command line option i g n o r e _ s y s t e m_ a c c o u n t . An example of a valid URL that has these command line parameters can be seen on the first ISL AlwaysOn product page (link dow nload) after the user has entered its username - it looks like this: http://alwayson.islonline.net/start/ISLAlwaysOn&...&cmdline=grant+...&... Syntax of parameters © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 68 [ / SI L ENT] [ g r a n t | g r a n t _ s i l e n t <g r a n t b l o b >] [ p a s s wo r d <d e f a u l t p a s s wo r d >] [ d e s c r i p t i o n <c o mp u t e r d e s c r i p t i o n >] [ pus h_upgr ade ( t r ue| f al s e) ] [ r ec or d <p a t h to r e c o r d i n g s >] [ s h u t d o wn | s h u t d o wn _ s i l e n t ] [ g r a n t _ p a s s wo r d <c o n n e c t i o n _ p a s s wo r d >] - - opt s " <c g i _ e n c o d e d _ o p t i o n s >" [ i g n o r e _ s y s t e m_ a c c o u n t ] [ s k i p _ c h e c k _ s t a r t ] [ r e c o r d <p a t h >] [ g r a n t _ p a s s wo r d <p a t h >] [ s har e| s har e_s i l ent <p a t h >] [ s h u t d o wn | s h u t d o wn _ s i l e n t ] Command line option / SI L ENT enables silent setup of ISL AlwaysOn computer. The setup will not be started when ISL AlwaysOn is already installed on computer. Adding option p u s h _ u p g r a d e will enable or disable automatic software updates initiated from the ISL Conference Proxy server - this options is useful for corporate environments where administrator wants to update multiple computers at the same time. Option p u s h _ u p g r a d e is available in ISL AlwaysOn version 1.2.2 or newer. Option r e c o r d is used to set the session recordings folder. When an ISL Light session is started and session recording folder is set, the session will be recorded to the specified folder. Option r e c o r d is available in ISL AlwaysOn version 1.2.2 or newer. Link that is used by the default ISL AlwaysOn web page used command line option g r a n t that is followed by grant blob. If silent install is needed (no user confirmation), g r a n t _ s i l e n t can be used instead. Option p a s s wo r d will set access password if the password hasn't already been set. Command line option d e s c r i p t i o n is followed by the description text that will be shown in the ISL AlwaysOn page. Description text can also specify environment variables that are available to ISL AlwaysOn process and some additional variables: d i s k i d (disk serial ID) ma c (MAC addresses of network cards that are present on system delimited with '_'. Single MAC address has the following syntax x x : : x x : : . . . , where x x is a hexadecial number in lowercase) n i f s (all (but localhost) IPs that are present on system, delimited with ',') c p u i d ... (processor cpuid - normally 0) n a me (computer name as it would be seen in ISL AlwaysOn web page without "description" command line option) Environment and additional variables must be prefixed with $ [ and must end with ] . An example of a valid description text: " $ [ n a me ] - $[ ni f s ] " Option s h u t d o wn stops all ISL AlwaysOn services on local computer. If no user confirmation is needed, use s h u t d o wn _ s i l e n t . Option g r a n t _ p a s s wo r d defines a new granted connection password. This option is used together with the option g r a n t _ s i l e n t . List of possible entries for c g i _ e n c o d e d _ o p t i o n s : © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 69 a u t o _ u p d a t e s =1 (this will enable automatic software updates initiated from the ISL Conference Proxy server) c o n f _ p r o t e c t =1 (this will protect ISL AlwaysOn computer management dialog with the global password) Option s k i p _ c h e c k _ s t a r t will always upgrade the ISL AlwaysOn program first and then perform actions that are specified with parameters. These are general steps that need to be done: 1. Declare wanted command line arguments. 2. Login to ISL AlwaysOn product page and obtain common URL link for granting access. 3. Add/change URL encoded string of declared command line arguments from the first step (google for online urlencoding). 4. If needed, replace g r a n t with g r a n t _ s i l e n t . An example of such procedure: 1. We want the following command line: / SI L ENT g r a n t _ s i l e n t $ [ n i f s ] - $ [ ma c ] " <b l o b > p a s s wo r d " 5 g r 4 t x x " des c r i pt i on " t es t $ [ n a me ] - 2. After login, we have obtained: https://alwayson.islonline.net/start/ISLAlwaysOn?cmdline=grant+%22.some.grant.blob.%22 3. We added the following URL encoded string to the c md l i n e CGI parameter: %2 FSI L ENT+p a s s wo r d +%2 2 5 g r 4 t x x %2 2 +d e s c r i p t i o n +%2 2 t e s t +%2 4 %5 Bn a me %5 D+- +%2 4 % 5 Bn i f s %5 D+- +%2 4 %5 Bma c %5 D%2 2 4. We also changed g r a n t to g r a n t _ s i l e n t . 5. Final URL looks like this: https://alwayson.islonline.net/start/ISLAlwaysOn?cmdline=grant_silent+%22.some.grant.blob.%22+% 2FSILENT+password+%225gr4txx%22+description+%22test+%24%5Bname%5D+-+%24%5Bnifs%5D+-+% 24%5Bmac%5D%22 3.8 Settings The settings section will take a look at the ISL AlwaysOn v2.0 GUI and give an in depth guide, taking account of all features available in the program. Here is a list of options you have access to in Settings: Basic Desktop Sharing File Sharing Advanced © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual 3.8.1 Manual 70 Basic This chapter will explain in detail how to configure the basic settings. To access the Basic area of ISL AlwaysOn settings, right mouse click on the ISL AlwaysOn Icon located in the system tray > Click Settings... > Enter Global Password (if set). Click Basic from the side menu. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 71 Here is a list of options you have access to in Settings: Overview Security Granted Access Notifications Computer 3.8.1.1 Computer Status The Computer Status notifies you of 3 important options. Remote Access (Enabled/Disabled) Desktop Sharing (Enabled/Disabled) File Sharing (Enabled/Disabled) You can change the options by clicking on the change button. Examples: 1. Here is an example of what happens when a supporter tries to connect to a computer where the Computer is accessible option is set to NO. Login to your ISL Online account via the website. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 72 The My Computers list shows that the computer is Offline. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 73 2. Here is an example of what happens when a supporter tries to connect to a computer where the Computer is accessible option is set to YES but Desktop connection is turned OFF. Follow the same steps as in the previous example. Click Connect next to the computer you wish to connect to from the My Computers List. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 74 Click Run when the download finishes. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 75 When ISL AlwaysOn tries to connect to the computer, you will be given this message shown below. 3.8.1.2 Access Password The Access Password option allows you to configure passwords so either the user or the administrator has access to the settings area. To set a global password or change the password for the connection click on Change Password. Type in the © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 76 password you want to use for this computer then click OK to confirm. If you wish for the user to have access to the settings area for only the one occasion where you for example might want them to access the settings are to make a change, you can enable a one-time password Check the One time password checkbox. Click the Generate Passwords button. Confirm by clicking the OK button (you will be offered a PDF file (pwd.pdf)) Select a location to save this file. (The file contains 50 generated one time passwords for this computer.) When connecting to this computer, you can enter: 1. the global password. 2. The connection password (if set). 3. The required one time password (e.g. you will be prompted for the one time password number when the ISL AlwaysOn starts to connect to the remote computer). Important: We recommend you save a copy of the One time passwords list for when you want to access to the computer. You have the option to Save To PDF or send the list to the printer. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 77 The purpose of the global password is to stop the users accessing the AlwaysOn settings for security reasons. The administrator is normally the only person who has access to this password so he can make changes to the connection. If you type in the incorrect global password, the password box disappears. To re enter the global password you need to right click on the ISL AlwaysOn icon in the system tray > Click Settings. Example: The computer security configuration is setup for one time password: The administrator of the connection to this computer sets the security to use a one time password upon connection to the computer. In order for the supporter to connect they will need to enter the one time password. Important: You can also access the AlwaysOn list of computer via our website. 1. Right click on the ISL AlwaysOn system tray icon > Click "Open". This will bring up the ISL Online Login Box. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 78 2. Login to your account using your ISL Online Username and Password. 3. Find the computer you wish to connect to from the list. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 79 4. Click connect 5. ISL AlwaysOn Connect will now download in your default Internet Browser. 6. Click "Run" to start the process. ISL AlwaysOn connect will now load on your desktop. Once it has loaded and starts connecting to the computer, it will ask you to enter the One time password. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 80 7. In this example it is asking us to enter one time password number 11. Refer to the list of one time passwords and enter the correct code into the Password box as shown above. 8. Click "OK" and if it accepts the password your connection will be established. Important: If you enter the incorrect password, a failed message will appear in the connection box. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual 3.8.1.3 Manual 81 Remote Users The Access Passw ord list shows important details on who has access to their computers using ISL AlwaysOn. There are two ways you can add new computers to the list. Either you can enter a valid ISL Online account username, or by typing in an invitation code and it will be added to the list. Highlight over a user account from the list by using your mouse. You will see an icon appear to the right side of the box. Here you can access the Connection Settings. Adding a new user to access your computer There are two ways to add a new computer to the list either enter the invitation code and click on the + icon to the right side of the box, (click here for more information on how to get hold of the invitation code), or hover the mouse over "Enter user name or invitation code" and click on the + icon. It will bring up the Add Remote User box. For help at any time click on the (?) button. You will be taken to the relevant topic on our help center manuals. Select the Server from the drop down list. For hosted service users select ISL Online Netw ork for Server License users select the name of your server. Now enter either your Granted Access code (refer to the email generated by the supporter) or enter your ISL Online product login user name and passw ord and click Grant Access. The user account will now be added to the list as shown below. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 82 To enter the connection settings for this user, hover the mouse over the user name and click on the icon to the right side of the box, then click Change Connection Settings from the drop down list. The connection settings area allows you to customize each user accounts security settings, Notifications, Desktop sharing properties, ability to start recordings, and use filters each explained below. Access Passw ord Global Passw ord: If this is selected then only the administrator who sets the global password will have access to this computer. This connection passw ord: Allows you to set a password for this connection only. One time passw ord: Allows you to generate a list of passwords for this computer that once used, become obsolete. Please see the Security topic for more information. Notifications Please see the Notifications topic for more information. Desktop Sharing Please see the Desktop Sharing Session topic for more information. Recording Please see the Desktop Sharing Recording topic for more information. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 83 Important: Each user account is given its own password to access the ISL AlwaysOn settings for only their account. The administrator is the only person allowed to configure user accounts on the computer by using the Global Password.Im 3.8.1.4 Email Notifications Here you will find a list of Email Notifications that can be enabled/disabled. To receive email notifications enter email addresses into the Enter new email box. All the email addresses added will receive notifications with details on when sessions have either: Successfully started. Ended. Failed to start. Had files successfully downloaded. Example: Notification sent to email after a session was started successfully. 1. Email address entered into Enter new email box. Checked tick boxes for Successful start of desktop sharing session, and File downloaded. 2. After a connection is made to a computer a notification is sent to the email address entered in the box as shown above. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual 3.8.1.5 Manual 84 Computer Within the Settings menu you have some Computer options. The list of options you have available to you are shown in the screenshot below. Show tray notifications icon: Allows you to see the ISL AlwaysOn button in the taskbar notification area. Protect computer configuration w ith global passw ord: Allows you to protect the ISL AlwaysOn settings with a global password. Enable automatic updates initiated from ISL Conference Proxy server: Allows you to receive updates automatically. You will notice a notification window appear. Once ISL AlwaysOn is installed to a computer an icon will appear in the notification area of the desktop taskbar. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 85 Right click on the icon to bring up a sub menu which allows you to open certain windows. Open ISL Alw aysOn...: Allows you to open the ISL AlwaysOn login window. Settings...: Allows you to configure the ISL AlwaysOn user settings. About: Allows you to view the version of ISL AlwaysOn you are using. Exit: Closes the ISL AlwaysOn process from your computer. Important: You can disable the ISL AlwaysOn notification icon by unticking Show tray notification icon. After you check the box for Protect computer configuration w ith global passw ord a window appears when you try to access the Settings area of ISL AlwaysOn. You will be asked to enter the global password. Every time you close the settings box down you will need to re enter the global password to access it again. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual 3.8.2 Manual 86 Desktop Sharing This chapter will explain in detail the Desktop Sharing settings. To access the Desktop Sharing area of ISL AlwaysOn settings, right mouse click on the ISL AlwaysOn Icon located in the system tray > Click Settings... > Enter Global Password (if set). Click Desktop Sharing from the side menu. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 87 Here is a list of options you have access to in Settings: Overview Session Recording 3.8.2.1 Computer Status The desktop overview lets you select whether or not desktop sharing is switched on or off. Important: The same option can be found in the Basic > Computer Status topic which explains in more detailed information. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 88 You can change some options by clicking on the Change button. You can choose whether or not the computer is accessible, and desktop and file sharing are enabled. 3.8.2.2 Session The desktop sharing options allow you to change a number of settings when running a session. The 4 options are shown below. Show Notification of incoming connection: Allows client to see a countdown notification to when a connection is will be established. This can be customized to any time limit. Allow local user to reject connection: This option is only available after the Show notification of incoming connection is ticked. This brings up a prompt box allowing the local user to reject the connection by the supporter. Lock computer when session starts: This will stop the user from being able to control the desktop when a session is in progress. Enable black screen when session starts: This means the local user will not be able to see the screen when the session is active. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 89 Examples: 1. Here is a demonstration of what you would expect to see when you check the box Show notification of incoming connection and set a Notification Timeout of 24 seconds. a) Start ISL AlwaysOn connection with client b) Type in the ISL AlwaysOn connection password for this computer c) Client will see the countdown timeout notification on their screen © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 90 d) Once countdown is complete the connection to the client is established 2. Here is a demonstration of what you would expect to see when you check the box Allow local user to reject connection. a) Start ISL AlwaysOn connection with client b) Type in the ISL AlwaysOn connection password for this computer c) Client will be given the options to either Allow or Reject the supporters connection © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 91 3. Here is a demonstration of what you would expect to see when you check the box Lock computer when session starts. a) Start ISL AlwaysOn connection with client b) Type in the ISL AlwaysOn connection password c) Connection will now be made to the clients computer © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 92 d) Clients computer will be locked when session starts 4. Here is a demonstration of what you would expect to see when you check the box Enable black screen when session starts. a) Start ISL AlwaysOn connection with client b) Type in the ISL AlwaysOn connection password c) The connection will now be made to the clients computer d) The clients computer will turn black when session starts © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual 3.8.2.3 Manual 93 Recording ISL AlwaysOn allows you to enable session recording when running an active connection with a participant. Click the tick box to enable session recording and choose a destination folder to save your recording files. Example: Setting a recording folder: Click on the Browse button to select a folder in which ISL Light session recordings to be stored. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 94 How to setup a recording w ithin ISL Alw aysOn: 1. Start an ISL AlwaysOn connection. 2. Wait until the connection is established and you can see the computer screen you are connecting to, then click on the Tools option from the AlwaysOn menu. 3. Click on the recording option from the bottom of the list. 4. Click on "Load Plugin". © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 95 5. Repeat previous steps 2, 3, and 4 but this time click Start. 6. A message will appear on the clients side asking to give permission to start recording. Since you are in control of the session you can either speak to your client to confirm this is Ok, or if it has been pre agreed, click Yes to this message. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 96 7. A recording location box appears on your screen. If you have not already done so you need to specify a folder where the saved recording files will be stored. Click Browse to locate your preferred folder. Then click OK to confirm the folder and OK again to start the recording. 8. After you have finished recording repeat steps 2, 3 and 4 but this time click Stop. 9. A save notification box will appear on screen after you stop the recording. To watch the recording click View. 10. An internet explorer box will open and you will be asked to download the ISL Recording Player to watch the recording. Confirm this download to open the Recording Player. Important: To find out more information about the Recording player read through this Manual. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 97 11. If you have already downloaded the ISL Recording Player and are familiar with it, repeat steps 2, 3, and 4 this time click Start Player. 3.8.3 File Sharing This chapter will explain in detail how to configure file sharing within ISL AlwaysOn. To access the File Sharing area of ISL AlwaysOn settings, right mouse click on the ISL AlwaysOn Icon located in the system tray > Click Settings... > Enter Global Password (if set) Click File Sharing from the side menu. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 98 Here is a list of options you have access to in Settings: Overview Shared Files 3.8.3.1 Computer Status Here you will find options on file sharing. The overview for File Sharing is much like the basic overview, but only File Sharing is shown. Please refer to © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 99 the Basic > Computer Status topic where you will also find more detailed information. You can start and stop File Sharing by simply clicking on the Change button and clicking the File sharing tick box, as shown below. 3.8.3.2 File Sharing Here you will be able to to determine the location of shared files on your computer and set the permissions for those who can access the files. To browse for a share location on your computer hover the mouse over the Enter new share location box and click on the + button. The share settings box will appear on the screen. Here you will be able to browse for a specific share folder along with the ability to change who has authentication and permission to access the files. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 100 Folder: Location of file share. Authentication: Public access: Allows everyone to see the files. Private access: Allows only you or users who you granted access to see the files. Access Permission: Download Only: Allows users access to download files in your share location. Full Control: Allows all users access to files in your share location. 1. Click Browse to locate a folder, 2. Locate this folder on your computer/network. 3. Click Select Folder. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 101 4. Select the Authentication type. (details shown bottom of page) 5. Select preferred Access Permissions. (details shown bottom of page) 6. Click OK You will now see a list of folders that are shared, as seen in the example below. Here is an example of how to share a file from your Computer: 1. First you need to locate the file you wish to share with ISL AlwaysOn. 2. Right mouse click on the file you wish to share (you will see a list of options as seen in the screenshot below). © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 102 3. Click on the option Share this folder with AlwaysOn. 4. You will then be asked to enter the Global Password 5. Now you will be given a choice of how you want to share this file, along with permissions, and authentication. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 103 6. Click "OK" to confirm settings. An example to show how you view the shared folders: Important: ISL AlwaysOn does not allow access to shared folders from within the ISL AlwaysOn GUI, it is a web based feature only. 1. First login to the ISL Online product login area. 2. Click on ISL AlwaysOn from the menu bar to view the My Computers list. 3. Locate the computer you wish to view shared folders, then click Files from the options as shown below. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 104 4. You will now be able to see a list of folders shared on this computer, along with the description, authentication and permissions. Click on the folder you want to view shared files from. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 105 5. Enter the password you used when installing ISL AlwaysOn Remote Access to the computer. 6. Now you have the option to either, download files in a zip format, upload files to this folder, delete files or create a new folder inside the current folder. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 106 6. This is what happens when you delete files from this folder. A warning message box will appear. 7. If you click OK the file will be deleted from the computer. 8. If you click "Download zip" the file will download to your downloads folder. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 107 9. If you wish to upload files to the folder click Upload and a file Upload screen will appear, asking you to choose the file you wish to upload to the folder. Once you have located the file click Open, then click Send. 10. The file will now be uploaded to the folder. You will find it is added to the File List. 11. To create a new folder click on the Create new folder button. For this example we will enter "TEST" as the folder name. 12. A new folder will appear in the File list. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 108 13. You can preview certain file types by holding the mouse over the magnifying glass. An example of a preview is shown below. 14. Some file types are not available for preview. You will receive this message when the file is not available. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 109 Important: Certain files such as txt, out, js, html, htm, cs, css, vb, ini, reg can be seen in a preview but only if the file size is less than 320Kb. Image files such as png, jpg, jpeg, gif can be seen in a preview if the files size is less than 32Kb. 3.8.4 Advanced This chapter will explain in detail more about the advanced settings inside the ISL AlwaysOn Control Panel. To access the Advanced area of ISL AlwaysOn settings, right mouse click on the ISL AlwaysOn Icon located in the system tray > Click Settings... > Enter Global Password (if set). Click Advanced from the side menu. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 110 Here is a list of options you have access to in Settings: Filters History Wake On LAN Sleep Mode Connection 3.8.4.1 Wake On LAN In the advanced settings you have the option to enable Wake On LAN. Tick the Automatic detection of WakeOnLan parameters. If you wish to customise Wake On LAN to your own address and port numbers you need to untick the selection box. To make Wake On LAN secure, type in a password into the SecureON © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 111 password box. Some important factors to take note of before you set up Wake On LAN 1. Wake On LAN works on both Window s and Apple Mac. 2. Wake On LAN only works with w ired network connections. 3. At least one machine on the subnet needs to be online in order for Wake On LAN to work. 4. Wake On LAN works by sending a wake-up frame or packet to a client machine from a server machine that has remote network management software installed (to use Wake On LAN technology you need a Wake On LAN network adapter, Wake on LAN enabled motherboard). Once a connection is started the Wake On LAN network adapter installed in the client receives the wake-up frame and turns on. Window s Example: BIOS Changes made to enable Wake On LAN: 1. You will need to check Wake On LAN is enabled on your machine. To do this you need to enter the BIOS setup utility during system startup in order to check the setting. 2. The screenshot below shows how you can enable Wake On LAN inside BIOS. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 112 3. You can also enable Wake On LAN on from within Windows. 4. To run Device manager: Click Start > Run > Type "devmgmt.msc" and press "Enter". © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 113 5. Locate and double left mouse click Netw ork Adapters from list > Double left mouse click the network controller you are using (the network adapters properties box will appear) > Click the Advanced tab > Locate from the Property list Wake Up Capabilities/Wake On LAN > set the Value to Magic Packet this will enable you to Wake your computer up. Click OK to confirm changes. 6. Now go back to the Network Adapter properties and this time click on the Pow er Management tab. Check the second and third boxes to enable Wake On LAN. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 114 7. Press OK until you are back to the network connections. Now the computer can be started from Hibernate, Standby, or PowerOff modes via a special management packet. 8. Your computer is now configured to be accessible with Wake On LAN. For Apple Mac please follow these steps: 1. Open System Preferences from the task bar. 2. Click Energy Saver. 3. Make sure that the Wake for Ethernet netw ork access is ticked. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 115 Window s and Apple Example continued: 9. Login to the ISL AlwaysOn computer list via the user login area of our website. 10. Click on the Products tab. 11.By Default you will see the list of computers and notice that the computer is set to Offline (if this is not the case then click the Remote Access option). Now you can send a Wake On LAN request to the computer by clicking on Send WOL. After a few seconds (depending on the speed of your internet) the computer will wake up and the status will change to Online. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 116 Important: In order to connect to a computer you need to install the ISL AlwaysOn client. Click here for more information on how to install a new computer. Important: If the security software installed on the client's computer blocks Wake On LAN then you can configure ISL AlwaysOn to use UDP Port 7 or 9. This will ultimately enable the client computer to be woken even when protected by Firewalls/NAT. So instead of using automatic detection of Wake On LAN parameters you can untick the checkbox and in the Port box type UDP Port 7 or 9. 3.8.4.2 Sleep Mode Here you have an option to allow or not allow your ISL AlwaysOn computers to go to sleep. If you tick Use default server settings, you will be using the settings based on our servers. However, If you untick it, you have the choice to allow/not allow a computer to got to sleep. So by ticking the Allow computer to go to sleep box you can let your computer sleep but by unticking it the computer will always stay awake. 3.8.4.3 Connection Here you can customise the connection settings for ISL AlwaysOn. The default setting is set to Use default server settings but you can set the connection to use either Port 80, 443 or 7615. These ports are what allows the software to run through your internet connection. So changing default server setting to use specific port number would be recommend if you have your firewall setup to block certain ports. You can also test the connection by clicking on the Test Connection button and even open up the ISL Online Connection Tester. To see more information on Connection tester please view this topic. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 117 If you are running your internet connection over a proxy server click on the Advanced checkbox and fill in your HTTP proxy connection details and click Test Connection to check the settings are working. If you have any problems when trying to connect or use any of the ISL Online products you can use the ISL Online Connection Tester to test your internet connection is setup correctly. For more information on the ISL Online Connection Tester please read this manual. 3.8.4.4 Filters You can enable access filters for this connection by checking the Enable access filters checkbox. This will allow you to set certain limitations, based on the IP and/or MAC address. 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: (allow_|deny_)(all|ip|mac) <filter description> [;(allow_|deny_)(ip|mac) <filter description 1> ...] First part of the pair begins with allow_ or deny_ and is followed by ip or mac (applying IP or MAC filtering). The second part (filter_description) depends on the filtering type - either an IP address/subnet/... or a MAC address © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 118 using the aa-bb-cc-dd-ee 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, deny_all 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 deny_all to your list. Example: deny_ip 192.168.0.14 allow_ip 192.168.0.13/255.255.255.0 allow_mac 00-19-d1-06-c9 This will allow connections from any IP in the 192.168.0.* subnet except 192. coming from the 00-19-d1-06-c9 MAC address with any IP. Important: IP and MAC addresses can be spoofed, so filters alone are not a substitute for a strong access password! 168.0.14 and allow connections Example of a filter to deny a specific IP Address In this example we will deny the ip 192.168.0.14 The filter shows that the IP has been denied. If you try to make a connection to this IP, ISL AlwaysOn will attempt to download but when it tries to access the client you receives this error message. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual 3.8.4.5 Manual 119 History With ISL AlwaysOn you can search all of your connection history. To do this click on Open which will bring up a fully customizable search box. In the Access History box you can search by User, Type and Time Range. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 120 Search Criteria Drop downs User: Scroll through all users who are connected to your ISL Online account. Type: Choose between all and Connect. Time Range: Select the time range you wish to search by. This can be set by Today, Yesterday, This Week, Last Week, This Month, Last Month, Custom. Options: Show all events for more detailed look at your session histories. Once you have customized the search criteria, type in your search string and you will notice the data will appear in the results box below. An example is shown below with the show all events option selected. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 121 Export: You can export your histories to your computer for future reference. Important: All exports are saved in the .xml format. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Manual 122 © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual 4 Server licence 123 Server licence This chapter describes usage and options of ISL AlwaysOn 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 Add a new computer Access a computer Customization User management Pushing updates 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.1 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.4 packet - it contains two files: Readme.html and confproxy-3-4.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. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 124 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 _ 4 _ x _ l i n u x . b i n (where 3.4.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, ...). 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 ISL AlwaysOn. For more information on user management, refer to the User management chapter. This concludes the Quick setup chapter. Please continue to the Add a new computer chapter to learn how to add a new computer to your list. You may also be interested in some of the main ISL AlwaysOn-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 AlwaysOn 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 © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 125 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 Alw aysOn Shows a list of active ISL AlwaysOn sessions. 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 Alw aysOn General ISL AlwaysOn options. 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 Add a new computer Standard interface for accessing ISL Online products can be reached through the http://localhost/ address in your browser (replace l o c a l h o s t in the address with the appropriate server address for your situation): © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 126 Click ISL Alw aysOn on the left and login with the desired username and password. Once logged in, you will be presented with a list of your computers (initially it is empty). 1. There are two ways of adding a new computer. The default way is to click the marked icon to download ISL AlwaysOn for this computer. The alternative way is to use the invitation code. If you choose the default way, please click the download icon and skip to step 8. If you choose the alternative way, check the Show more possibilities option and proceed to the next step (step 2). © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 127 2. Installation instructions for the client will appear. 3. You can send these instructions via email by clicking the Send button - if you choose this option, please proceed to the next step (step 4). The procedure can also be performed manually - if you choose this option, please skip to step 6. 4. Invitation page will appear. Provide the email address(es), click the Send Invitations button and automatically generated invitation will be sent out immediately. If you want to modify the content of the message seen in the Preview, click the Change button, enter your changes and Apply them: © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 128 5. The recipient will receive an e-mail that looks like the picture below. If the recipient follows the grant link, please proceed to step 7. If the grant link does not work and the recipient follows the alternate link, please proceed to the next step (step 6). 6. Instruct your client to navigate to http://localhost:7615/join (replace localhost with your server's address) from the computer to be available to the ISL AlwaysOn user and then tell him/her to enter the code that was © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 129 displayed to you in the step 2. 7. The client will see the Grant remote access confirmation page. If the client agree to grant access to the current computer to the user who has issued the user code, he/she should click the Grant Access button. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 130 8. A security warning will appear - select Run. Important: To install ISL AlwaysOn, administrative privileges are required! 9. ISL AlwaysOn setup wizard will appear. Click Next and follow the wizard. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 131 10. ISL AlwaysOn will now prompt you for the password. As an important part of security, you need to set a strong access password. You will need to provide the access password each time you try to access the remote computer. The access password can be changed in the Computer Access Configurations, but everybody having access to this computer has to be informed about the change. The password is stored locally in the computer registry. 11. Click OK to grant access. 12. After the access is granted, the client will see the ISL AlwaysOn window. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 132 The same screen can later be reached simply by double-clicking the ISL AlwaysOn icon in the taskbar - the icon appears after the installation of ISL AlwaysOn: You have now successfully added a computer to your list. Please continue to the Access a computer chapter to learn how to access that computer from anywhere. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual 4.4 Server licence 133 Access a computer Standard interface for accessing ISL Online products can be reached through the http://localhost/ address in your browser (replace l o c a l h o s t in the address with the appropriate server address for your situation): Click ISL Alw aysOn on the left and login with the desired username and password. Once logged in, you will be presented with a list of your computers. To access a computer from the list, please follow this procedure: 1. Click Connect next to the computer you wish to connect to. 2. Security warning will appear - select Run. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 134 3. When prompted, enter the remote computer's access password and click OK. 4. ISL Light will automatically start on both your (ISL Light Desk) and the remote computer (ISL Light Client), exchange a session code and connect. ISL View window will appear and you can start working on the remote computer as if you were there. Apart from the above procedure, where you chose the Run option in step 2, you can also choose Save and save the executable for later use - e.g. place it on your desktop and rename it to a more friendly name, e.g. J o h n ' s h o me c o mp u t e r . e x e . When you wish to access that remote computer, simply double-click the executable on your desktop, enter the appropriate username and password when prompted, then the computer access password and you will be connected - no need to visit the product pages of your ISL Conference Proxy each time. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 135 It is possible to use command line arguments for ISL AlwaysOn Connect, allowing you to skip the password entry form. All the parameters are specified as "key=value". Available parameters: Username (you can use it to provide your username, e.g. \ \ d e f a u l t \ u s e r 1 ) Passw ord (you can use it to provide your password) ComputerPassw ord (you can use it to provide the computer access password) ComputerPassw ordMD5 (you can use it to provide the raw computer access password as written in the registry - check HKEY_ L OCAL _ MACHI NE\ SOFTWARE\ I SL On l i n e \ I SL Al wa y s On \ p a s s wo r d ) StreamOptions (you can use it to enable the desired checkboxes [separate them with a semicolon] in the list, e.g. s ma l l _ f o o t ; l e a v e _ b a c k g r o u n d ; ) If you specify a username, password and a computer password (either in plaintext or as MD5), you will get a single-click solution that connects to a certain ISL AlwaysOn machine without having to enter any credentials or login to your user beforehand. Important: Please keep in mind that if you create a shortcut and set those parameters for it, anyone with access to your machine can do a right-click on that shortcut and read the parameters. Example: I SL Al wa y s On Co n e n c t . e x e " Us e r n a me =\ \ d e f a u l t \ u s e r 1 " " Co mp u t e r Pa s s wo r d =a c c e s s p wd " 4.5 " Pa s s wo r d =u s e r p wd " Customization The following ISL AlwaysOn customizations are available at the moment: change the icon for each computer in the list change the description for each computer in the list command line arguments (e.g. implementing silent install) To access these settings for a certain computer on the list, please select the Edit action. Apart from these ISL AlwaysOn customizations, you can use customizations that are specific to ISL Light. Please refer to the following chapter in the ISL Light manual for more information: ISL Light customization Please note that certain options are already used or enabled due to the way ISL AlwaysOn works, e.g. desktop sharing is automatically started, control is automatically granted, administrative mode and restart and resume support activated etc. 4.5.1 Command line arguments ISL AlwaysOn is controlled through command line parameters. When installing ISL AlwaysOn through product pages, the same parameters are used as a whole command line in the CGI parameter c md l i n e . An example of a valid URL that has these command line parameters can be seen on the first ISL AlwaysOn product page (link dow nload) after the user has entered its username - it looks like this: © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 136 http://localhost:7615/start/ISLAlwaysOn&...&cmdline=grant+...&... Syntax of parameters [ / SI L ENT] [ g r a n t | g r a n t _ s i l e n t <g r a n t [ d e s c r i p t i o n <c o mp u t e r d e s c r i p t i o n >] b l o b >] [ p a s s wo r d <d e f a u l t p a s s wo r d >] Command line option / SI L ENT enables silent setup of ISL AlwaysOn computer. The setup will not be started when ISL AlwaysOn is already installed on computer. Link that is used by the default ISL AlwaysOn web page used command line option g r a n t that is followed by grant blob. If silent install is needed (no user confirmation), g r a n t _ s i l e n t can be used instead. Option p a s s wo r d will set access password if the password hasn't already been set. Command line option d e s c r i p t i o n is followed by the description text that will be shown in the ISL AlwaysOn page. Description text can also specify environment variables that are available to ISL AlwaysOn process and some additional variables: d i s k i d (disk serial ID) ma c (MAC addresses of network cards that are present on system delimited with '_'. Single MAC address has the following syntax x x : : x x : : . . . , where x x is a hexadecial number in lowercase) n i f s (all (but localhost) IPs that are present on system, delimited with ',') c p u i d ... (processor cpuid - normally 0) n a me (computer name as it would be seen in ISL AlwaysOn web page without "description" command line option) Environment and additional variables must be prefixed with $ [ and must end with ] . An example of a valid description text: " $ [ n a me ] - $[ ni f s ] " These are general steps that need to be done: 1. Declare wanted command line arguments. 2. Login to ISL AlwaysOn product page and obtain common URL link for granting access. 3. Add/change URL encoded string of declared command line arguments from the first step (google for online urlencoding). 4. If needed, replace g r a n t with g r a n t _ s i l e n t . An example of such procedure: 1. We want the following command line: / SI L ENT g r a n t _ s i l e n t $ [ n i f s ] - $ [ ma c ] " <b l o b > p a s s wo r d " 5 g r 4 t x x " des c r i pt i on " t es t $ [ n a me ] - 2. After login, we have obtained: http://localhost:7615/start/ISLAlwaysOn?cmdline=grant+%22.some.grant.blob.%22 3. We added the following URL encoded string to the c md l i n e CGI parameter: %2 FSI L ENT+p a s s wo r d +%2 2 5 g r 4 t x x %2 2 +d e s c r i p t i o n +%2 2 t e s t +%2 4 %5 Bn a me %5 D+- +%2 4 % 5 Bn i f s %5 D+- +%2 4 %5 Bma c %5 D%2 2 © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 137 4. We also changed g r a n t to g r a n t _ s i l e n t . 5. Final URL looks like this: https://localhost:7615/start/ISLAlwaysOn?cmdline=grant_silent+%22.some.grant.blob.%22+%2FSILENT +password+%225gr4txx%22+description+%22test+%24%5Bname%5D+-+%24%5Bnifs%5D+-+%24%5Bmac %5D%22 4.6 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: 1. Login to your ISL Conference Proxy administration (http://localhost:7615/conf). 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 ?. 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. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 138 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. Useful hint: It is possible to share a computer from one user's list with another user. Please check the following topic for instructions: Grouping 4.6.1 Grouping It is possible to share a computer from one user's list with one or more other users. Your ISL Online product username looks like this (replace d o ma i n with the appropriate domain and u s e r with the appropriate username): \ \ d o ma i n \ u s e r If you have not done it yet, you should create at least one more user in the ISL Conference Proxy administration, e.g. \ \ d o ma i n \ u s e r 2 . Check the user management topic for instructions. Now you need to enable the grouping feature: 1. Login to your ISL Conference Proxy administration (http://localhost:7615/conf). 2. Go to User management. 3. Click the Domains tab and select the desired domain (in this example, it is d o ma i n ). 4. Click the ISL Alw aysOn tab. 5. Uncheck the Use grouping functionality option and change the setting on the right to Yes. 6. Uncheck the User (as guest) can share connection w ith ow ner in the same domain option and change the setting on the right to Yes. 7. Click Save to save these changes. Now you can login at http://localhost:7615 (replace l o c a l h o s t with the appropriate server address) with the user that wishes to share a computer, e.g. \ \ d o ma i n \ u s e r and click Edit next to the desired computer from the list. You will see an option called Share this computer w ith - mark the checkbox and enter the desired ISL Online product username, e.g. u s e r 2 and click Save changes. From that moment on, the user \ \ d o ma i n \ u s e r 2 will see that computer in his/her list (with a comment about the owner below the computer description), but available options next to that computer will only be Connect and History (instead of Connect, Edit, Delete, History), since that user is not the owner. When the user \ \ d o ma i n \ u s e r 2 clicks History, he/she sees only his access history. When the user \ \ d o ma i n \ u s e r (i.e. the main user) clicks History, he/she also sees only his access history. If you open ISL AlwaysOn GUI at the remote computer and click History, you can see a list of all accesses. © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 139 The main user (in this case \ \ d o ma i n \ u s e r ) can remove the sharing at any moment by clicking Edit next to that computer and removing the checkbox next to the appropriate user in the Share this computer w ith section. 4.7 Pushing updates ISL AlwaysOn 1.2.2 or newer includes a special option for enabling/disabling push updates - please refer to the following topic for more information: Global security To push an update to one or more computers that have push updates enabled, please login to your ISL Conference Proxy administration (at http://localhost:7615/conf, replace l o c a l h o s t with the appropriate address), go to Activity Monitor - Sessions - Active, select the ISL Alw aysOn tab. Then select the desired computers from the list that have push updates enabled (please note the Supports Upgrade column), click the Push Upgrade radio button, select the desired ISL AlwaysOn version from the list and click Execute. Please note that the value in the Supports Upgrade column for a specific computer gets updated only when a computer connects, so if you change the option, it will not be refreshed until the next time this computer connects. However, the functionality is enabled immediately - you can push an update immediately after enabling the option on a specific computer. Useful tip: If you are using (or plan to use) a default customization, you can set the that customization's option Enable automatic updates to enabled and all ISL AlwaysOn installations will have the push updates enabled by default, making your administration tasks much easier. Please note that changing the option manually overrides the customization preference - if at some point you disable this option in the ISL AlwaysOn GUi, the setting from the customization will not be used any more and you will have to enable it manually. 4.8 Integration This chapter contains some integration examples for ISL AlwaysOn 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: XMLMSG (includes a few ISL AlwaysOn-related XMLMSG examples) Since ISL Light is a part of ISL AlwaysOn, ISL Light-related integration instructions also apply. Please refer to the Integration chapter in the ISL Light manual for more information on ISL Light integration. 4.8.1 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:// © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 140 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: Querying computer list 4.8.1.1 Querying computer list Information about ISL AlwaysOn Computers can also be obtained through XMLMSG interface - it offers same functionality as default web pages served by ISL AlwaysOn module on Conference Proxy. Querying ISL AlwaysOn computer list is supported on ISL Conference Proxy 3.2.5 or newer with ISL AlwaysOn module 1.2.1dev1 or newer. Replace dbsecret in the examples below with the appropriate database secret. Query user id <mo d u l e s e c r e t =" d b s e c r e t " n a me =" I SL _ AL WAYSON" > <u s e r u s e r n a me =" t e s t e r " p a s s wo r d =" 1 2 3 " / > </ mo d u l e > Returned is user information (direct user ID in database and user tags). Returned user ID can be used in subsequent queries. Error is returned if invalid username and/or password is specified. Setting valid user tags <mo d u l e s e c r e t =" d b s e c r e t " n a me =" I SL _ AL WAYSON" > <u s e r i d =" s - 1 _ 0 _ 2 " > <t a g s ><t a g >t e s t </ t a g ><t a g >wo r k </ t a g ></ t a g s > </ u s e r > </ mo d u l e > Query latest used computers (equal to first page) <mo d u l e s e c r e t =" d b s e c r e t " n a me =" I SL _ AL WAYSON" > <u s e r u s e r n a me =" t e s t e r " p a s s wo r d =" 1 2 3 " / > <l i s t / > </ mo d u l e > © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 141 Query computers through search (equal to search page) <mo d u l e s e c r e t =" d b s e c r e t " n a me =" I SL _ AL WAYSON" > <u s e r i d =" s - 1 _ 0 _ 2 " / > <l i s t > <c g i > <p r o p n a me =" s e a r c h _ f o r m" >t r u e </ p r o p > <p r o p n a me =" a o n l i s t _ c o u n t " >2 </ p r o p > <p r o p n a me =" s e a r c h _ d e s c " ></ p r o p > <p r o p n a me =" s e a r c h _ t a g " ></ p r o p > </ c g i > </ l i s t > </ mo d u l e > Search parameters can be obtained by studying URL location of default ISL AlwaysOn search page. Pass relevant search parameters in cgi/prop elements. Query stored icon for connection <mo d u l e s e c r e t =" d b s e c r e t " n a me =" I SL _ AL WAYSON" > <u s e r i d =" s - 1 _ 0 _ 2 " / > <i c o n i d =" 1 c 1 6 f 2 7 0 9 f a d 4 9 7 6 7 5 1 0 3 6 2 e 7 3 4 0 a 4 5 5 5 0 3 8 b 4 a a 0 0 1 2 b 9 7 2 9 f e 5 8 a 0 9 9 7 6 4 4 a 3 4 d 9 a 4 d 0 8 3c ed0595490e19d65d06de59c c 8d9980010d15a6448c 0f f e84e0916340181" / > </ mo d u l e > Query ISL Alw aysOn history (equal to history page) <mo d u l e s e c r e t =" d b s e c r e t " n a me =" I SL _ AL WAYSON" > <u s e r u s e r I d =" s - 1 _ 0 _ 2 " / > <h i s t o r y > <c g i > <p r o p n a me =" s e a r c h _ c o mp u t e r " >* MUX</ p r o p > </ c g i > </ h i s t o r y > </ mo d u l e > To specify range use following fields: session_after_date_year=2009 session_after_date_month=3 session_after_date_day=22 session_after_time_hour=0 session_after_time_minute=0 © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 142 session_before_date_year=2009 session_before_date_month=3 session_before_date_day=23 session_before_time_hour=0 session_before_time_minute=0 Search parameters can be obtained by studying URL location of default ISL AlwaysOn history page. Pass relevant search parameters in cgi/prop elements. Delete ISL Alw aysOn computer <mo d u l e s e c r e t =" d b s e c r e t " n a me =" I SL _ AL WAYSON" > <u s e r u s e r I d =" s - 1 _ 0 _ 2 " / > <d e l e t e c o _ i d =" 2 3 4 5 2 3 4 5 2 3 4 5 2 3 4 5 2 3 4 5 2 3 4 5 " > </ d e l e t e > </ mo d u l e > To update ISL Alw aysOn computer options <mo d u l e s e c r e t =" d b s e c r e t " n a me =" I SL _ AL WAYSON" > <u s e r u s e r I d =" s - 1 _ 0 _ 2 " / > <o p t i o n s c o _ i d =" 2 3 4 5 2 3 4 5 2 3 4 5 2 3 4 5 2 3 4 5 2 3 4 5 " > <d e s c r i p t i o n >t e s t c o mp u t e r </ d e s c r i p t i o n > <t a g s ><t a g >t e s t </ t a g ></ t a g s > <i c o n >2 9 8 3 5 2 3 4 5 6 2 3 4 5 </ i c o n > </ o p t i o n s > </ mo d u l e > Element i c o n must be base64 encoded content of PNG file that will be displayed in web page. Show a list of offline ISL Alw aysOn computers This example includes a perl script that shows a list of offline computers for a specific user - the output looks like this: 1 . 2 . 3 . 4 Wo r k 5 . 6 . 7 . 8 Ho me (the first column represents the IP address, the second column represents the computer description) Prerequisites: 1. Enabled XMLMSG access with database secret set. 2. Perl (on most Linux systems it is already installed; on Windows, you can install ActivePerl: http:// downloads.activestate.com/ActivePerl/Windows/5.10/ActivePerl-5.10.1.1006-MSWin32-x86-291086.msi) 3. Perl packages L WP: : Us e r Ag e n t and XML : : DOM © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 143 Having fulfilled those prerequisites, please follow these steps: 1. Download example_aon_offline.zip and extract a o n _ o f f l i n e . p l to the desired location. To view the source of a o n _ o f f l i n e . p l , click here. 2. Change the parameters in the script with the correct values for your case (i.e. $ d b s e c r e t , $ u s e r , $ p wd , $ s e r v e r ). 3. Go to the directory where you extracted aon_offline.pl, open the command prompt (Windows) or terminal (Linux), then run the script by typing p e r l a o n _ o f f l i n e . p l and it will show a list of offline computers. 4.8.1.1.1 Source code This section includes source code for the following scripts (click the desired script to go to its source): aon_offline.pl aon_offline.pl us e s t r i c t ; u s e L WP: : Us e r Ag e n t ; u s e XML : : DOM; #- - - - - - p a r a me t e r s - - - - - - my $ d b s e c r e t my $ u s e r = " dbs ec r et " ; = " us er 1" ; my $ p wd = " u s e r 1 " ; my $ s e r v e r #- - - - - - = " h t t p : / / 1 2 7 . 0 . 0 . 1 : 7 6 1 5 / x ml ms g " ; body - - - - - - my $ f r o m = " 0 " ; my $ d o m_ p a r s e r = n e w XML : : DOM: : Pa r s e r ; my $ u a = L WP: : Us e r Ag e n t - >n e w; s u b n o d e Va l u e { my ( $ e l m, $ v a l u e ) = @_ ; r et ur n $ e l m- >g e t El e me n t s By Ta g Na me ( $ v a l u e ) - >i t e m( 0 ) - >g e t Fi r s t Ch i l d >g e t No d e Va l u e ( ) ; } wh i l e ( 1 ) { my $ o u t $out .= = ' ' ; <<EOF <mo d u l e s e c r e t =" $ d b s e c r e t " n a me =" I SL _ AL WAYSON" > <u s e r u s e r n a me =" $ u s e r " p a s s wo r d =" $ p wd " / > <l i s t > © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual Server licence 144 <c g i > <p r o p n a me =" s e a r c h _ f o r m" >t r u e </ p r o p > <p r o p n a me =" a o n l i s t _ c o u n t " >1 0 0 </ p r o p > <p r o p n a me =" a o n l i s t _ f r o m" >$ f r o m</ p r o p > <p r o p n a me =" s e a r c h _ d e s c " ></ p r o p > <p r o p n a me =" s e a r c h _ t a g " ></ p r o p > </ c g i > </ l i s t > </ mo d u l e > EOF ; my $ r e q = HTTP: : Re q u e s t - >n e w( POST => $ s e r v e r ) ; $ r e q - >c o n t e n t _ t y p e ( ' t e x t / x ml ' ) ; $ r e q - >c o n t e n t ( $ o u t ) ; my $ r e s = $ u a - >r e q u e s t ( $ r e q ) ; my $ d o m = $ d o m_ p a r s e r - >p a r s e ( $ r e s - >c o n t e n t ) ; my @c o mp s =$ d o m- >g e t El e me n t s By Ta g Na me ( ' c o mp u t e r ' ) ; i f ( s c a l a r ( @c o mp s ) == 0 ) { ex i t ; } $ f r o m += s c a l a r ( @c o mp s ) ; f o r e a c h my $ c o mp ( @c o mp s ) { my $ s t a t u s = n o d e Va l u e ( $ c o mp , i f ( $s t at us eq ' of f l i ne' ) ' s t at us ' ) ; { pr i nt n o d e Va l u e ( $ c o mp , ' addr es s ' ) . " "; pr i nt n o d e Va l u e ( $ c o mp , ' des c r i pt i on' ) . " \ n" ; } } } © 2014 Xlab d.o.o., Ljubljana ISL AlwaysOn 2.0 Manual 5 Frequently answered questions 145 Frequently answered questions Please refer to the Frequently answered questions manual. © 2014 Xlab d.o.o., Ljubljana