Crestron
e-control Vote SW-VOTE
26
••
Server Configuration In Depth
Installation & Reference Guide — DOC. 5822
Server Configuration In Depth
This section is a reference to all the options available in the
Configuration Options
window. Changes to options in this window are saved to the current Configuration
Settings file when the
OK
or
Apply
buttons are actuated. Therefore, it is important to
make sure you are operating on the appropriate Configuration Settings file before
opening the window.
Specifying a Configuration File
The installer registers the file
demovote.ini
as the current Configuration
Settings file. This file pre-configures the server for all three demos, and particularly
for use with the Quick Start Guide — which instructs you to load demo1.
You can use the
File | Configuration file…
command to select a Configuration
Settings file of your choice. The file pathname so specified is stored in the Windows
registry on your machine. In addition to specifying the configuration filename, this
command also instantly reconfigures the server based on the named file. This is a
very useful feature for the developer working on multiple projects.
N
OTE
:
If the server cannot open a specified configuration file, it uses default values for all options, a
null configuration with no connections and no signal blocks. If any changes are made, a new config
file is created using the specified pathname when the
OK
or the
Apply
buttons are actuated
Creating a New Configuration File
We recommend duplicating the demo configuration file and modifying the copy, as
follows:
•
Locate the file and copy and paste it, renaming it appropriately.
•
Point the server to the new config file using the procedure described above in
“Specifying a Configuration File.”
•
Proceed to modify the duplicated configuration
An alternative approach is to use the
File | Configuration file…
command to enter
the pathname of a non-existing config file. As per the N
OTE
, above, you will start out
with default values. As soon as you modify this null configuration, the config file
you named above is created.
Transporting a Configuration
To prepare a configuration on one machine (a development machine) and transport it
to another (a target machine):
•
Craft the configuration to your liking on the development machine.
•
Copy the config file along with the database file it points to the target machine.
•
Point the server on the target machine to the new config file using the procedure
described above in “Specifying a Configuration File.”
N
OTE
:
If the database file was in the same folder (or a folder subordinate to) the config file’s folder,
the database filename is stored as a partially qualified pathname, relative to that folder. This is
useful, because if you keep that relationship between the files on the target machine, it can use the
relative pathname to locate the file. If, however, you copy the database to a different folder on the
target machine, or the database filename was a fully qualified pathname (beginning with a volume
designator) on the development machine, you may have to reset the pathnames (for each COM
Settings definition) on the target machine.
