Client/Server Technology
(Separate Purchase
Required)
This is a common topic for MovALyzeR, GripAlyzeR & ScriptAlyzeR. These programs will be referred to as MovAlyzeR on this page.
* Legal
Installation (only by someone with administrator privileges)
When installing MovAlyzeR, ensure that you choose the option to include the client-server component. If you already have MovAlyzeR installed, rerun the install and choose that option. The location of the server is in the "c-treeServer" folder within the MovAlyzeR folder. You will be provided with an activation key after you have purchased your licenses.
To input the key, click Start > Programs > NeuroScript > MovAlyzeR > "Activate c-tree Server".
The c-tree Server must be running for clients to connect to it. To start the server, click Start > Programs > NeuroScript > MovAlyzeR > "c-tree Server". By default, the name of the server is "NEUROSCRIPT" (all caps). To change this, you can edit the "ctsrvr.cfg" file in the "c-treeServer" folder. The first two lines in the configuration file are:
;FairCom
server name
SERVER_NAME NEUROSCRIPT
If you desire, you can simply change the "NEUROSCRIPT" to whatever you prefer. The server name IS case sensitive. NOTE: Edit this file at your own risk. We cannot take responsibility for user error.
From the server, click the Control > Shutdown menu item. An administrator must enter the username and password of a user with appropriate privileges (see below). The default administrator username and password (after the first install) is "ADMIN" and "ADMIN".
You will need to setup users in order to use the server. Click Start > Programs > NeuroScript > MovAlyzeR > "c-tree Server Admin". The admin utility is a console application (i.e., no graphical user interface). It is menu driven and more-or-less self-explanatory. For the default setup, the following is the procedure to add a group and a user.
-
When you first open the admin utility:
- Enter the administrator username - Default: "ADMIN"
- Enter the administrator password (case sensitive) - Default: "ADMIN"
- Simply hit ENTER to skip the "Optional File Password"
-
Enter the
server name (case sensitive)- Default: "NEUROSCRIPT"
To add a group:
- Enter 2 for "Group Definitions"
- Enter 1 to "Add New Group"
- Enter a unique ID for the group
- Enter a description for the group
-
Use the
default options for the remaining items (refer to Faircom documentation
for explanations)
To add a user:
- If you just did the above, enter "q" to return to the main menu
- Enter 1 for "User Operations"
- Enter 1 for "Add New User"
- Enter a unique ID for the user
- Enter a description for the user
- Use the default option for the next two items
- Enter a password for the user (case-sensitive)
- Re-enter the password for confirmation
- Enter the desired group ID for the user
- You can continue to add the user to additional groups or just hit "ENTER" to complete
- Enter the user's beginning access date ("ENTER" for immediate)
- Enter the user's last available access date ("ENTER" for no expiration)
- Enter the user's limit of failed login attempts ("ENTER" for default, "-1" to disable)
MovAlyzeR currently provides two cooperative features to utilize the client-server technology. Users can upload their experiments to the shared server, and users can download experiments from the server to their client. Available options are:
- Upload/download a category, element, stimulus, subject, group, condition or experiment
- Upload/download a stimulus or experiment, also uploading each of the sub-components (groups, conditions, etc)
- Upload/download all items of a folder (group folder, subject folder, etc.)
- Upload/download all items of the stimulus or experiment folder, including the sub-components of each stimulus or experiment
- Upload/download the master questionnaire
The first time (each execution) after a user attempts to use a client-server feature, MovAlyzeR will prompt the user to enter the server's name, the username, and a password. The server name and password are case-sensitive. The server name (default is "NEUROSCRIPT") will change depending on where it is installed. If it is on the same computer as the user, the user would simply enter "NEUROSCRIPT". If the server is on a network on a computer named "COMPUTER_4" (for example), the user would enter "NEUROSCRIPT@COMPUTER_4". Servers residing on a publicly visible internet location would replace the computer name with the IP or domain name of that machine. For example, "NEUROSCRIPT@111.11.222.22" or "NEUROSCRIPT@server.mydomain.com".
To upload data, you must open the desired user with the data you want to upload.
Right-click on the item you want uploaded (under the corresponding folder, not under experiment) and click the "Upload..." menu item.
You will be asked whether you want to overwrite any existing items. Clicking yes would overwrite items that are already on the server and clicking no would not overwrite the existing items, but other items are written. If it is an experiment or a stimulus, you will also be asked whether you want to upload the sub-components as well.
Experiment > upload.., would include all of its groups, subjects, conditions, and all of the stimuli, elements, and categories associated with each condition.
If you right-click on an item's parent folder, you have an option to choose "Upload All...". For example, if you right-click on the "Experiments" folder and click on "Upload All...", you can upload each and every experiment for that user. You will again be prompted to overwrite and include all sub-components (where appropriate).
To download data, you must open the built-in "UUU" user. This is the user that represents all of the data on your server. The procedure to download an item (or items) is the same as uploading...with one additional step.
When you select "Download..." from an item's menu, you will be presented a dialog from which to choose the specific user to download to (with options to overwrite and include sub-components). NOTE: Users "UUU" and "UU1" (the server and example users) are not available to select.
To upload/download the master questionnaire click the appropriate menu item under "Settings" in the main menu.
CAUTION: We are not responsible for users overwriting data inappropriately. We do not have a built-in user password-protection system (perhaps in a future release). Therefore, please use caution when you choose to overwrite. It is always best to ensure you backup your data regularly.
Portions copyright 1992-2004 FairCom Corporation. "FairCom" and "c-tree Plus" are trademarks of FairCom Corporation and are registered in the United States and other countries. All Rights Reserved.
