Once started, TheVirtualBrain should automatically open your default browser and start on the default http://127.0.0.1:8080/settings/settings. If not, you should manually open your favorite browser from our list of supported browsers and open the before mentioned URL. This should open up the following settings page:
These are the configurable settings for TheVirtualBrain. Note that the Name of the administrator is the only one that cannot be changed later on. The others will be accessible afterward from the profile page of the administrator. These settings are:
Is the amount of disk space that you (as administrator) can specify as the limit for each user, to occupy with TheVirtualBrain data. When a user exceeds this limit, they are no longer allowed to run simulations or other operations producing data. When this limit is exceeded, the user will still be able to visualize their previously created data, and, if desired, to remove data for making space for new results. For instance:
- A default region level simulation with length 1000 ms takes approximatively 1 MB of disk space.
- A surface level simulation, with Local Connectivity pre-computed, Raw monitor and length of 10 ms takes 280 MB.
Default value here is 5GB. We validate upon setup that a value not greater than the available physical disk free space is specified. In case you later get errors when running simulations (with disk full messages), but you still have free space on your hard-drive, feel free to come on this settings page and increase this value of space allocated to TheVirtualBrain.
After selecting your desired settings press the Apply button. This will restart TheVirtualBrain with the new settings. The restart could take a few minutes.
In order to access TheVirtualBrain, you need to have a user account.
There is a single Administrator account in TVB (created when installing the application). Its default user-name and password are admin and pass (exactly these words). These are the default values, but when you setup TheVirtualBrain for the first time (section Settings from above) you can specify different values, if wanted. Please remember what you specify for this Administrator account, as you are the sole responsible for it (TheVirtualBrain being installed in your own environment we have no control of your storage). With the Administrator account you will be able to later validate other TVB accounts.
If you want to create a new user in TheVirtualBrain, you should register using the corresponding link (available on the User Login page), which takes you further to the following form:
When the register button is clicked (on the right), an email is sent to ADMINISTRATOR_EMAIL address. It is the administrator’s task to validate the new account. The administrator needs to be logged in to validate an account. Without validation from the administrator, you will not be able to use the new accounts. For details on how validation is done, see the User Profile section.
This area is available after you login and gives you some basic information, such as:
You have also functionality on this page:
Manage other users (available on the left column, only when logged with Administrator account), takes you to a page for validating or invalidating other user accounts (accounts created with the register function)
access TVB Settings (same settings as in the first setup of TVB; although some of the fields become read-only after the first setup)
change the password and the email address for current logged user (also links on the left column)
enable or disable Online Help for current user. By Online Help we mean a bunch of question marks spread all over the application which can display a tooltip when clicked). In case you find the question marks annoying, feel free to disable them for your user from this page. Some pages will take longer to load when Online Help is on. You might want to disable it once you feel confident with the interface.
logout function (button on the right side)
Tip
TVB is a web application, which gets deployed on every computer where TVB_Distribution is downloaded and tvb_start command is executed. This happens usually in a local environment; which means that the user and resource management will be done locally, in that instance, and not in a centralised manner.
When TVB is started for the first time, you will see a settings page, where you can define the administrator account of that TVB instance. Default that is: admin / pass (exactly these words).
If you are using TVB in a single-user manner (not shared with other colleagues), feel free to use only this user while working with TVB; you do not need to bother with creating/registering other accounts. It is although recommended for you to change the password and the email address for this administrator account, especially if you are working in a LAN and your computer is not having a strong firewall.
If you are using TVB in a shared environment (e.g. installed on a server and accessed from remote by multiple people), you could follow the following steps:
- register accounts (optional)
- login with administrator
- check admin’s profile page, link Manage other users
- in case you haven’t registered accounts (step 1) you can now create new accounts using the button on the right
- check the validate checkbox for new users that you want active, and click Save to apply (see figure from previous page)
- from this very same page you can also invalidate some old users which you want to no longer be able to use TVB