https://github.com/doctor-phil/xsfs_scripts
Generates a series of scripts for streamlining the interface between our local ztree-unleashed VM and the FSU Economics XSFS server
https://github.com/doctor-phil/xsfs_scripts
Last synced: 3 months ago
JSON representation
Generates a series of scripts for streamlining the interface between our local ztree-unleashed VM and the FSU Economics XSFS server
- Host: GitHub
- URL: https://github.com/doctor-phil/xsfs_scripts
- Owner: doctor-phil
- License: mit
- Created: 2020-04-27T21:26:25.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2022-05-23T22:14:44.000Z (about 3 years ago)
- Last Synced: 2025-01-09T23:24:23.968Z (5 months ago)
- Language: Shell
- Homepage:
- Size: 14.6 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Installing the Virtual Machine for ztree-unleashed
First, ensure that you have downloaded and installed the latest versions of:
1. [VirtualBox](https://www.virtualbox.org/)
2. [The FSU VPN client](https://vpn.fsu.edu) (if applicable)
Follow the instructions [here](https://cler1.gitlab.io/ztree-unleashed-doc/docs/installation/) to download and install the ztree-unleashed virtual machine image. If applicable, use the host/domain name: xsfs.coss.fsu.edu
# XSFS_Scripts
This code builds off of the ztree-unleashed platform developed by researchers at the Cologne Laboratory for Economic Research.
Please visit the [ztree-unleashed documentation](https://cler1.gitlab.io/ztree-unleashed-doc/docs/installation/) for more information about ztree-unleashed.
Also, remember to cite their paper in the Journal of Behavioral and Experimental Finance if you use ztree-unleashed.
This folder MUST be placed on the desktop!
This code will set up a bunch of scripts for using the XS/FS server.
To use, first double click on the launcher called:
XS/FS ONE-TIME-SETUP
When prompted, enter your username for the server and
the domain of the server.
If you want, you can run the OPENSSH ONE-TIME SETUP launcher
This will create a secure SSH key for this VM on the server so
you don't need a password to log in each time.
It is recommended but not required.
Also, remember to change the port number
(NOTE: we no longer need to modify the ports in generate_session.py)
The important launchers are "PRE-SESSION" and "POST-SESSION"
These can be found on the desktop after installation
To run an experiment on the server, follow these steps IN ORDER:
1. Connect to the FSU VPN (if applicable)
2. Run "PRE-SESSION"
3. Run "Start session" and follow the instructions
4. Log in to [the singlelink utility](https://xsfs.coss.fsu.edu/go)
5. Start a new session in singlelink, using the links generated by ztree-unleashed. The title you choose for the session will be used in the URL that is given to subjects.
6. Distribute the URL to subjects in the form: https://xsfs.coss.fsu.edu/go/YOURSESSIONTITLE
WHEN YOU ARE DONE:
1. Run "Terminate session". When prompted, type YES to confirm
2. Run "POST-SESSION"
3. Disconnect from the FSU VPN