Server Manual. For Administrators of Cameleon Version 4

Transcription

1 Server Manual For Administrators of Cameleon Version 4

2 Cameleon Version 4 Server Manual For Administrators of Cameleon Version 4 R4-07OCT04 Copyright Surveillance Inc. Camera Cameleon is a trademark of 360 Surveillance Inc. The entire risk of the use or the result of the use of this software and documentation remains with the user. No part of this documentation may be reproduced by any means, electronic or mechanical, for any purpose, without the consent of 360 Surveillance Inc. 360 Surveillance Inc Commerce Circle Victoria, B.C. V8Z 6N6 Canada Phone Toll free Fax mail1@360surveillance.com Web

3 Table of Contents Chapter 1 - Introduction Conventions Used in this Manual Chapter 2 - Configuring a New System Set up the Minimal Configuration Test the Minimal Configuration Chapter 3 - Starting and Stopping Device Drivers About Device Drivers Start a Device Driver Shut Down a Device Driver Chapter 4 - Starting and Stopping Servers About Configuration Mode and Run Mode Saving the Server Configuration Launch a Server Configure a Server While it is Running Log Out of Configuration Mode and Launch Run Mode Shut Down a Server Chapter 5 - Understanding the Configuration Interface Title Bar Menu Bar File Menu View Menu Zoom Menu Tools Menu Help Menu Map Viewport Object Browser Pop-Up Menus Use Copy and Paste to Create a New Object Use Copy and Paste Many to Create Multiple New Objects Chapter 6 - License Manager About License Manager Add a License Activate a License Delete a License Chapter 7 - Project Properties About Project Properties Edit Project Properties Network Tab Configure a Primary Server Configure a Backup Server Additional Steps Switching Tab Archiving Tab Date/Time Tab Tab Cameleon Server Manual i

4 Chapter 8 - Archive Servers About Archive Servers Start an Archive Server View Archive Server Status Shut Down an Archive Server Chapter 9 - User Groups About User Groups Group Permissions The Predefined User Group Add a New User Group Edit a User Group Delete a User Group Chapter 10 - Users Predefined User Accounts The Predefined Administrator Account The Predefined Operator Account Add a New User Edit a User Delete a User Chapter 11 - Maps About Maps Add a New Map Edit a Map's Properties Load a Map Customize Your Maps Delete a Map Chapter 12 - Named Views About Named Views Add a New Named View Edit a Named View Load a Named View Update a Named View Delete a Named View Chapter 13 - Hotlinks About Hotlinks Add a New Hotlink Edit a Hotlink's Properties Modify a Hotlink's Shape and Size Move a Vertex Add a Vertex Delete a Vertex Delete a Hotlink Chapter 14 - Labels About Labels Add a New Label Place a Label on a Map Edit a Label Move a Label Scale a Label Remove a Label from a Map Delete a Label ii Table of Contents

5 Chapter 15 - Device Drivers and Devices About Device Drivers and Devices Device Drivers Add a New Device Driver Autodiscover Device Drivers Edit a Device Driver's Properties Delete a Device Driver Devices Add a New Device Autodiscover Devices Edit a Device's Properties Edit a Device's Local Settings View a Device's Read and Write Properties Edit Device Interlocks Delete a Device Device Icons About Device Icons Place a Device Icon on a Map Move a Device Icon Scale and Rotate a Device Icon Remove a Device Icon from a Map Move a Device Label Scale a Device Label Edit a Device Label Remove a Device Label Chapter 16 - Scripts and Expressions About Scripts and Expressions Variables and Values Properties of Objects View Run-Time Values of Variables Expressions Statements Mechanics of Editing Scripts Keystroke Editing Context-Sensitive Help The Expression Wizard The Script Wizard Syntax Error-Checking Example Scripts Example 1: Initialization Script Example 2: Camera Sequence Example 3: Alarm Location Script Chapter 17 - Global Scripts About Global Scripts Add a New Global Script Edit a Global Script Delete a Global Script Chapter 18 - Prompts About Prompts Add a New Prompt Edit a Prompt Delete a Prompt Chapter 19 - Global Tags About Global Tags Add a New Global Tag Cameleon Server Manual iii

6 19.3 Edit a Global Tag Delete a Global Tag Chapter 20 - Timers About Timers Add a New Timer Edit a Timer Delete a Timer Chapter 21 - Recipient Groups About Recipient Groups The Predefined Recipient Group Add a New Recipient Group Edit a Recipient Group Delete a Recipient Group Chapter 22 - Alarms and Events About Alarms and Events How Alarms and Events Work When an Alarm or Event is Triggered Operator Replays Acknowledgement Access Alarms and Events Defined on Another Server Alarm/Event Categories Add a New Alarm/Event Category Edit an Alarm/Event Category Delete an Alarm/Event Category Alarms, Events, and Normal Occurrences Add a New Alarm or Event Edit an Alarm or Event Delete an Alarm or Event Alarm/Event Icons About Alarm/Event Icons Place an Alarm/Event Icon on a Map Move an Alarm/Event Icon Scale an Alarm/Event Icon Remove an Alarm/Event Icon from a Map Move an Alarm/Event Label Scale an Alarm/Event Label Edit an Alarm/Event Label Remove an Alarm/Event Label Chapter 23 - Schedules About Schedules Add a New Schedule Edit a Schedule Delete a Schedule Chapter 24 - Clients, Custom Windows, and Canvases About Clients, Custom Windows, and Canvases Clients Workspaces Add a New Client Edit a Client's Properties Delete a Client Custom Windows Add a New Custom Window Edit a Custom Window iv Table of Contents

7 Delete a Custom Window Canvases Add a New Canvas Edit a Canvas Re-order a Window's Canvases Delete a Canvas Chapter 25 - Connections About Connections Managing Connections Chapter 26 - Server Ties About Server Ties Prevent Other Servers from Monopolizing Your Ties Configure a Server Tie Test a Server Tie Add a New Server Tie Edit a Server Tie Delete a Server Tie Chapter 27 - FTP Sites About FTP Image Capture Add a New FTP Site Edit an FTP Site Write an FTP Script The FTP Command FTP Scripts Delete an FTP Site Chapter 28 - System Logs About System Logs View System Logs Chapter 29 - Database Utilities Back Up the Server Database Restore the Server Database Appendix A - Adjusting How Windows Display A.1 Adjust the Object Browser Display A.1.1 Undock the Object Browser A.1.2 Dock the Object Browser to the Left A.1.3 Dock the Object Browser to the Right A.2 Resize Windows A.3 Reposition Windows Cameleon Server Manual v

8 vi Table of Contents

9 List of Figures Chapter 3 - Starting and Stopping Device Drivers Figure Corrupt or Missing Database dialog box Figure Restore Database dialog box Chapter 4 - Starting and Stopping Servers Figure Server Login dialog box Figure Synchronizing Drivers window Figure Server Login dialog box Chapter 5 - Understanding the Configuration Interface Figure Configuration window Figure About window Figure Map viewport and Object Browser Figure Paste Many dialog box Chapter 6 - License Manager Figure Base License Required dialog box Figure License Manager window Figure Add License dialog box Figure License Properties dialog box Chapter 7 - Project Properties Figure Edit Project Properties pop-up menu Figure Project Properties - Network tab Figure Project Properties - Network tab for a backup server Figure Project Properties - Switching tab Figure Project Properties - Archiving tab Figure Add Archive Server dialog box Figure Project Properties - Date/Time tab Figure Add Time Server dialog box Figure Project Properties - tab Figure Firewall Settings dialog box Chapter 8 - Archive Servers Figure Configure Archive Server dialog box Figure Archiving options Figure Archive Server status window Chapter 9 - User Groups Figure Example of the Permissions tree Figure Add New Group dialog box Figure Edit Group Properties dialog box Chapter 10 - Users Figure Add New User dialog box Figure Browse Users dialog box Figure Edit User Properties dialog box Chapter 11 - Maps Figure Add New Map dialog box Figure Edit Map Properties dialog box Cameleon Server Manual vii

10 Chapter 12 - Named Views Figure Add new named View dialog box Figure Edit Named View Properties dialog box Chapter 13 - Hotlinks Figure Add New Hotlink dialog box Figure Edit Hotlink Properties dialog box Figure Hotlink vertices selected for editing Chapter 14 - Labels Figure Add New Label dialog box Figure Edit Label Properties dialog box Figure Edit Label Properties dialog box Chapter 15 - Device Drivers and Devices Figure Warning about configuring devices and device drivers Figure Add New Driver dialog box Figure Browse Drivers dialog box Figure Browse Drivers dialog box Figure Warning about autodiscovering device drivers Figure Edit Driver Properties dialog box Figure Add New Device dialog box Figure Edit Device Properties dialog box Figure Edit Local Settings dialog box Figure Edit Label Properties dialog box Figure Read and write properties Figure Edit Device Interlocks dialog box Figure Examples of device icons Figure Device icon pop-up menu Figure Device label pop-up menu Figure Edit Label Properties dialog box Chapter 16 - Scripts and Expressions Figure Status window Figure Keystroke editing pop-up menu Figure Context-sensitive help at the beginning of a new line Figure Context-sensitive help after a command Figure Context-sensitive help for object properties Figure Expression Wizard dialog box Figure Location of Script Wizard button Figure Script Wizard Figure Hover help for command syntax Figure Script and expression verification Figure Initialization script Figure Camera sequence script Figure Alarm location script Chapter 17 - Global Scripts Figure Add New Global Script dialog box Figure Edit Global Script Properties dialog box Chapter 18 - Prompts Figure Add New Prompt dialog box Figure Example: Prompt operator to confirm request to open door Figure Script that opens the door Figure Preview of prompt to confirm request to open door Figure Edit Prompt Properties dialog box viii List of Figures

11 Chapter 19 - Global Tags Figure Add New Global Tag dialog box Figure Edit Global Tag Properties dialog box Chapter 20 - Timers Figure Add New Timer dialog box Figure Edit Timer Properties dialog box Chapter 21 - Recipient Groups Figure Alarm category that notifies all users in the Operators group Figure Add New Recipient Group dialog box Figure Edit Recipient Group Properties dialog box Chapter 22 - Alarms and Events Figure Remote Server Driver Figure Add New Category dialog box Figure Edit Category dialog box Figure Add New Alarm or Event dialog box Figure Edit Label Properties dialog box Figure Example of an alarm that uses source association Figure Alarm/Event Action for source association example Figure Edit Alarm or Event Properties dialog box Figure Alarm/event icon pop-up menu Figure Alarm/event label pop-up menu Figure Edit Label Properties dialog box Chapter 23 - Schedules Figure Add New Scheduled Action dialog box Figure Daily Schedule dialog box Figure Sunrise/Sunset Setup dialog box Figure Edit Holidays dialog box Figure Edit Scheduled Action Properties dialog box Chapter 24 - Clients, Custom Windows, and Canvases Figure Add New Client dialog box Figure Edit Client Properties dialog box Figure Add New Window dialog box Figure Edit Window Properties dialog box Figure Add New Canvas dialog box Figure Video for Windows canvas settings - General tab Figure Quad Video Display canvas settings - General tab Figure Canvas settings - Advanced tab Figure Edit Canvas Properties dialog box Chapter 25 - Connections Figure Analog Video Connections dialog box Figure Select desired source device Figure Select desired destination device Figure Source and destinations devices connected Chapter 26 - Server Ties Figure Example of server tie to share video between two servers Figure Remote Server Driver sources Figure Remote Server Driver alarms Figure Three-way server ties Figure Create connection for server tie Figure Add users for server tie Figure Browse for a remote server driver Cameleon Server Manual ix

12 Figure Expand Remote Server Driver in Object Browser to view alarms Figure Create connection for server tie Figure Add New Server Tie dialog box Figure Edit Server Tie Properties dialog box Chapter 27 - FTP Sites Figure New FTP Site Properties dialog box - General tab Figure New FTP Site Properties dialog box - Firewall tab Figure FTP site Properties dialog box Figure Example of a script to take scheduled image captures Chapter 28 - System Logs Figure Log Viewer window Chapter 29 - Database Utilities Figure Backup dialog box Figure Restore Database dialog box x List of Figures

13 List of Tables Chapter 4 - Starting and Stopping Servers Table Options available from the run mode pop-up menu Chapter 5 - Understanding the Configuration Interface Table Configuration mode pop-up commands Chapter 9 - User Groups Table Core group permissions Chapter 16 - Scripts and Expressions Table Properties and values of different types of objects Table Comparison operators Table Logical operators Table Script commands Table Keystrokes for editing scripts Chapter 20 - Timers Table The timer property, Value, and how it is set Cameleon Server Manual xi

14 xii List of Tables

15 C HAPTER 1 Introduction Welcome to the Cameleon advanced camera control system, designed to provide security and surveillance applications in a highly customizable and user-friendly environment. Cameleon supports client-to-server, client-to-multiple servers, and server-to-server control and monitoring of surveillance equipment via both analog and IP connections. The three main system components servers, clients, and device drivers can all reside on the same PC, or on separate PCs connected over an IP network. Cameleon's strength lies in its ability to control virtually any number and combination of analog and IP devices from different manufacturers with point and click simplicity. Cameleon seamlessly integrates cameras, monitors, switchers, DVRs, and a host of other types of devices. New device drivers with widely varying functionality can be developed for the system without changing the core server and client applications, improving system stability and reducing cost of ownership. Device drivers operate on any network-enabled platform, making the system easy to expand and highly scalable. Cameleon can be installed in a variety of display configurations. Built-in IP video allows clients with no special PC hardware to display live video in multiple windows. VGA-based configurations can display up to four video windows per monitor. This manual is directed at administrators responsible for configuring and maintaining Cameleon servers. Device drivers, which are installed as separate applications, are described in individual Driver Application Notes. 1.1 Conventions Used in this Manual Instructions for performing an action are presented as numbered steps. Whenever possible, a step is labeled with a meaningful heading in bold, capitalized text For example: CLIENT MAP LOADING Some steps include an arrow ( ) followed by text. The text following the arrow describes the effect that step will have on the system. For example: The Add New User dialog box will close. The names of windows, dialog boxes, and menus are written in title case. For example: Object Browser window Add New User dialog box File menu Cameleon Server Manual 1

16 The names of areas within dialog boxes and windows where related information is grouped are written within single quotes. For example: The Remote Host Information area is used to enter information about the FTP server. The names of boxes in which you type information in dialog boxes are written within single quotes. For example: If no user name is defined on the firewall host, then leave the User Name box empty. Items you click or select to perform an action are in bold face. For example: Click Yes to close the dialog box. Script commands are written in all capitals. For example: LOAD Admin_Building Menu navigation is represented using a greater-than symbol (>) between options. For example: Tools > Database Utilities > Restore Tree navigation uses a double greater-than symbol (») between branches. <Project> refers to the project name at the root of the Object Browser. Angle brackets denote a branch for a custom object created and named by an administrator. For example: Navigate the Object Browser to <project>» Clients» <client>» Windows When instructed to navigate a tree, expand each element and select the final element listed. In the preceding example, you would expand <project>» Clients» <client> and select Windows. Cross-references to another section within this manual provide the chapter or section number and name, as well as the starting page number. For example: See Chapter 8 - Archive Servers (p.43) for more information. See Section Customize Your Maps (p.65) for instructions. In the on-line version of this manual, cross-references to other sections within this manual are hyperlinked. Click the cross-reference to follow the hyperlink. TIP Notes indicate an important fact that users should be aware of when using a particular feature. Tips point out ways for users to optimize their use of Cameleon Introduction

17 C HAPTER 2 Configuring a New System When configuring a new Cameleon system, it is recommended that you start with a minimal configuration that allows you to test core system functionality, such as viewing video and controlling devices. Once this is working, build on the minimal configuration by adding additional clients, users and user groups, workspaces, maps, archive servers, automation, and whatever other customization you want. 2.1 Set up the Minimal Configuration This section outlines how to configure a single server with a minimal configuration. If your system has more than one server, repeat these steps for each server. Each server must have its own base license. CABLING: You can cable your equipment before or after you set up the minimal configuration. For information on cabling, refer to the Driver Application Notes for your equipment. INSTALLATION: Before you set up the minimal configuration, install the server and client applications and whatever device drivers you need to control devices in your system. Install the server application on the computer the server application will run on. Install the client application on the computer you will use to test the minimal configuration. Install the device drivers on the computer the drivers will run on, as well as on the client computer. To set up the minimal configuration, perform the following steps in the given order: 1. START SERVER: Run the server from the Windows Start menu, or double-click the Cameleon icon on the Windows desktop, if there is one. 2. ENTER BASE LICENSE: When asked whether you want to enter a base license, click Yes. Follow the instructions in Section Add a License (p.25). 3. CREATE DATABASE: When prompted to create or restore the server database, click Create. 4. LOG IN TO CONFIGURATION MODE: Use the predefined administrator account (user name: administrator, password: vis) to log in to configuration mode. See Section Launch a Server (p.10) for instructions. 5. ADD CLIENT: Add the client computer. See Section Clients (p.170) for instructions. 6. ADD WINDOWS: Add the custom windows the client will have access to. See Section Custom Windows (p.172) for instructions. 7. ADD CANVASES: For each custom window, add the canvases required to view video. See Section Canvases (p.174) for instructions. Cameleon Server Manual 3

18 8. START DEVICE DRIVERS: Start each device driver installed on the computer the drivers will run on. You do not need to start the drivers on the client machine. Create a database for each driver when prompted. See Section Start a Device Driver (p.6) for instructions on starting device drivers. 9. ADD DEVICE DRIVERS: Add each device driver to the server configuration. Add as many drivers as you can using the Autodiscover feature. If the Autodiscover feature missed any drivers, add them using the Add feature. See Section Devices (p.88) for instructions. 10. ADD DEVICES: Add each device in the system to the appropriate device driver. See Section Devices (p.88) for instructions. 11. DEFINE CONNECTIONS: Add connections to reflect the analog connections between devices. See Chapter 25 - Connections (p.181) for instructions. TIP 12. EXIT CONFIGURATION AND RUN SERVER: Select File > Exit and Run. You will be asked whether you want to save the changes you made to the configuration. Click Yes. If you are adding a number of similar custom windows to the same or different clients, configure the window once, then copy and paste it as needed. The canvases defined for the window will be copied with the window. 2.2 Test the Minimal Configuration Testing the minimal configuration ensures that the devices in your system are correctly connected and configured and custom windows are correctly configured. To test the minimal configuration: 1. START CLIENT: To start the client, select the Cameleon client from the Windows Start menu, or double-click the Cameleon client icon on the desktop, it there is one. 2. CONFIGURE SERVER: Click Servers at the bottom of the Client Login dialog box. Click Discover All to autodiscover servers. Select the server and Set as Home Server. Refer to the Cameleon Client Manual for more information. 3. LOG IN: Use the predefined user account (user name: user, no password) to log in to the client. Refer to the Cameleon Client Manual for more information. 4. BUILD WORKSPACE: When asked whether you want the system to build a workspace for you, click Yes. 5. TEST DEVICES: Drag a camera from the Device List to a custom window with the appropriate type of canvas to make sure you can view video from the camera. Rightclick the camera in the Device List and select Show Control Dialog to open the camera's Device Control dialog box. Test controlling the camera. Repeat this for all the cameras configured. Test the other devices in the Device List. How you test each device will depend on the type of device. Refer to the appropriate Driver Application Notes for information on controlling devices Configuring a New System

19 C HAPTER 3 Starting and Stopping Device Drivers 3.1 About Device Drivers Device drivers are programs that control devices. Device drivers are separate applications in Cameleon. You must install, run, and configure a device driver for each type of device you will use in your system. For example, if your system uses CamBrand cameras connected to A-1 switchers with ViewAll monitors and Living History DVRs, you must install, run, and configure the CamBrand Camera Driver, the A-1 Switcher Driver, the ViewAll Monitor Driver, and the Living History DVR Driver. INSTALLING DRIVERS: Device drivers must be installed before they can be run. Install each device driver on the computer the driver will run on, as well as on every client computer. You do not need to run the drivers installed on client machines; they simply have to be installed. If a device driver is not installed on a client, that client will not be able to display device icons on maps, device names in the Device List, or device gadgets for that type of device. The copy of a device driver you will configure and run can be installed on any computer on the network. Device drivers do not need to be installed on the same computer as the server application, nor do all the drivers need to be installed on the same computer. RUNNING DRIVERS: A device driver must be running in order to: Configure devices of that type in the server configuration Control the devices configured under that driver Start each device driver needed to control devices in your system. You can start the drivers before you start the Cameleon server, or after. TIP To perform a quick check of whether any device drivers are not running, right-click the Cameleon icon in the Windows system tray and select Current Status from the pop-up menu. Scan the Status window for variables with value Uninitalized. The value Uninitialized indicates that the device driver is not running. EXECUTABLE VS. SERVICE: When you start a device driver, you have the choice of running it as an executable or as a service. If you ever have to restart a driver that is run as an executable, you will have to follow the steps outlined here. To restart a driver that is run as a service, restart the computer the driver is installed on, or start the driver through the Windows Control Panel Administrative Tools. TIP If you run a device driver as a service, you can set the driver to restart automatically in the event of failure. To set a driver to restart automatically, run the driver as a service, open the Administrative Tools in Windows Control Panel, open the driver service, and set the restart options on the Recovery tab. Cameleon Server Manual 5

20 3.2 Start a Device Driver To start a device driver: 1. RUN DRIVER: Run the device driver application from the Windows Start menu, or double-click the driver icon on the Windows desktop, if there is one. 2. CREATE OR RESTORE DATABASE: If the device driver's database is corrupted or missing, you will be prompted to either restore a backup or create a new database. Figure 3.1 Corrupt or Missing Database dialog box (a) (b) CREATE: To create a new database for the device driver you are launching, click Create. Creating a new database destroys the existing database, if there is one. RESTORE: To restore a backup version of the driver database, click Restore. The Restore Database dialog box will open. Figure 3.2 Restore Database dialog box Select the backup you want to restore and click OK. Alternatively, click Browse, locate the desired backup from the file system, and click Open. Once a valid database is in place, the Configure Driver dialog box will open. 3. If the driver is currently installed to run as a service and you want to run it as an executable, click Remove the driver as a service, then click OK. Repeat step 1 to re-open the Configure Driver dialog box. 4. LOCAL NETWORK ADAPTER: Select the IP address of the computer the driver is installed on from the drop-down list Starting and Stopping Device Drivers

21 5. LISTENING PORT: The listening port is the port the device driver uses to receive commands from the server. If you have not yet added the device driver to the server configuration, use the default port number provided, or type in a port number between 2000 and that has not been assigned to another driver. Use this port number as the Listening Port when you add the device driver to the server configuration. If the device driver has previously been added to the server configuration, select the driver's listening port from the drop-down list. The listening port is the port that was specified when the driver was added to the server configuration. To find out the listening port, log in to configuration mode. The port is displayed beside the driver in the Object Browser. 6. MODE: (a) (b) EXECUTABLE: To run the device driver as an executable, click Start the driver as an executable. SERVICE: To run the device driver as a service, click Install the driver as a service. 7. Some device drivers support additional options. For more information on a particular driver's options, refer to the Driver Application Notes for that driver. 8. Click OK. TIP The Configure Driver dialog box will close. If you are running the driver as a service, start the driver through the Windows Control Panel Administrative Tools, or restart the computer the driver is installed on. An icon representing the driver will appear in the Windows system tray, indicating that the driver is running. To check whether a device driver is running, log in to configuration mode, edit the device driver, and click Check Now. While the server is checking, the buttons in the dialog box are unavailable. If the server succeeds in finding a driver, the buttons become available again. If no driver is found, the server displays a warning message. See Section Edit a Device Driver's Properties (p.87) for more information. 3.3 Shut Down a Device Driver To shut down a device driver: 1. Right-click the driver icon in the Windows system tray and select Exit from the pop-up menu. You will be prompted to confirm. 2. If you are sure you want to shut down the driver, click Yes. The driver will shut down. If the device driver is running as a service, you can also shut it down through the Windows Control Panel Administrative Tools. Cameleon Server Manual 7

22 8 3 - Starting and Stopping Device Drivers

23 C HAPTER 4 Starting and Stopping Servers 4.1 About Configuration Mode and Run Mode The server application must be installed before it can be run. Cameleon servers can be launched in run mode or configuration mode. CONFIGURATION MODE: Configuration mode has a user interface that allows you to configure any type of object, including, users, maps, devices, scripts, and alarms and events. To launch a Cameleon server in configuration mode, a user must have permission to configure the software. See Section Group Permissions (p.49) for more information. RUN MODE: Run mode has no user interface. When a Cameleon server is in run mode, the server application appears in the Windows system tray, where the application continues to run in the background. A server must be in run mode for clients to connect to it. Run mode has a pop-up menu that is opened by right-clicking the Cameleon icon in the Windows system tray. Table 4.1 lists the options provided by the run mode pop-up menu. Table 4.1 Options available from the run mode pop-up menu MENU OPTION Configure Current Status Exit SECTION OF MANUAL Section Configure a Server While it is Running (p.11) Section View Run-Time Values of Variables (p.107) Section Shut Down a Server (p.13) TIP You can log in and out of configuration mode while a server is running. This allows you to perform administrative tasks without interfering with operators working in the Cameleon client. See Section Configure a Server While it is Running (p.11) for instructions Saving the Server Configuration When you change the server configuration, most changes don't come into effect until after the configuration has been saved. Only changes to device drivers and devices come into effect immediately, with the exception of a device's local settings, which come into effect after the configuration is saved. See Section Edit a Device's Local Settings (p.91) for information on local settings. To save the server configuration, select File > Save or press Ctrl-S, or exit configuration mode and click Yes when asked whether you want to save the configuration. VERIFICATION: The server will verify that all scripts and expressions are valid before saving. Operators logged in to the Cameleon client will be momentarily interrupted while the configuration is being saved. After the interruption, operators will see the new configuration. Cameleon Server Manual 9

24 If one or more scripts or expressions contain errors, the server displays an error message and gives you the opportunity to make corrections. See Section Syntax Error-Checking (p.116) for instructions on making corrections. Scripts and expressions are also verified when you launch the server. If there are any errors, you do not have the option to launch the server in run mode. You are automatically presented with the login dialog box for configuration mode. A server will not save changes to the configuration if there are any errors. If you do not correct the errors before exiting, all the changes you made to the configuration will be lost, except for changes to device drivers and devices. 4.2 Launch a Server If this is the first time you have launched the server, or if your base license has expired, you must enter a base license before proceeding with the configuration. Click Yes when asked whether you want to enter a base license. The License Manager will open. Follow the instructions in Section Add a License (p.25). If the server configuration has more devices or clients than your licensing allows, possibly because an upgrade license has expired, Cameleon will warn you and present you with the login dialog box for configuration mode. If desired, log in to configuration mode and delete devices and clients until you are within the allowable limit, or contact Sales at to obtain a new upgrade license. To start a server: 1. Run the Cameleon application from the Windows Start menu, or double-click the Cameleon icon on the Windows desktop, if there is one. If the server database is corrupted or missing, you will be prompted to either restore a backup or create a new database. Creating a new server database destroys the existing server database, if there is one. For information on restoring a backup, see Chapter 29 - Database Utilities (p.207). Once a valid database is in place, the Cameleon splash screen will open. The splash screen has a timer that counts down from 15 seconds. 2. MODE: (a) (b) RUN MODE: To launch the server in run mode, click Run, or let the timer count down to zero. The Cameleon icon will appear in the Windows system tray, indicating that the server is running. CONFIGURATION MODE: To launch the server in configuration mode, click Configure before the counter reaches zero. The Server Login dialog box will open Starting and Stopping Servers