Tips
for installing PSYCHOfree
PSYCHOfree
is a software
tool developed
by the GOADB Group at
the DISI - University of Genoa
for research
purposes
PSYCHOfree is a client-server application
developed on top of PostgreSQL with three main components, which can be
distributed on different hosts in the same network:
· the
PSYCHOfree client (available in two versions: a textual user interface and
a graphical user interface, which has currently limited functionalities);
· the
PSYCHOfree server;
· the PBMS
The utility for installing and configuring PSYCHOfree
environment is available on this site at the SOFTWARE section.
To correctly create and configure the PBMS used by
PSYCHOfree, you need to set up the environment within the PostgreSQL
server. This can be done either from the machine where the PostgreSQL
server resides or from a remote machine where a PostgreSQL client resides,
as described below in the “PSYCHOfree PBMS set-up”
section.
After this initial set up phase, you
may use PSYCHOfree as many times as you want in a client-server mode. To
this end, you first need to start the PSYCHOfree server and, then, a
PSYCHOfree client (either the textual one or the graphical one, as you
prefer). The procedure to run PSYCHOfree server and clients is described in
the “Run PSYCHOfree”
section.
We remark that the current version of PSYCHOfree server accepts
multiple connections from different PSYCHOfree clients, but not running on
the same host.
Pre-installed software required:
· PostgreSQL
Release 8.2.3
· Java
Virtual Machine 1.5 (or, at least, the Java Runtime Environment 1.5)
Download PSYCHOfree software:
After downloading the utility to install PSYCHOfree (see
the SOFTWARE
section), extract the content of the PSYCHOfree.zip file on your file
system (be sure the path does not include directories whose name contains
white spaces)
PSYCHOfree PBMS set-up:(*)
1. Move to the
PSYCHOfree_installer\classes\com\psychofree\install directory and launch
“run.cmd” (you will be required to enter the PostgreSQL
administrator account’s password and information concerning the PostgreSQL
host and database you want to use)
2. Move to the
PSYCHOfree_server\classes\com\psychofree\server directory, edit the file
PBHOST, and put in the name of your PostgreSQL host
Installing
PSYCHOfree in a remote way on a machine where a PostgreSQL client resides
is possible. In this case, if you experience connection problems with the
PSYCHOfree server it may depend on your network protection policies.
ATTENTION: the installer executes javac and java
commands. Thus, you need to register in the classpath of your system the
reference for the JDK to be used (which as to be at least a JDK1.5). Be
sure that the corresponding path is inserted in the classpath.
Run PSYCHOfree:
1. Lauch the
PSYCHOfree server:
a. Move to
your PSYCHOfree home
b. Move to the
path “PSYCHOfree_server\classes\com\psychofree\server” and
lauch the “run.cmd” file
2. If you wish
to use the textual PSYCHOfree client:
- Move to your PSYCHOfree home
- Move to the path “client\classes\com\psychofree\client”
and lauch the “run.cmd”
file.
A wizard will ask you to enter:
i. a
user name for the PBMS you want to use;
ii. its
corresponding password;
iii. the
name of the host where PSYCHOfree server is running;
iv. the
PostgreSQL service name used to connect to the PosgreSQL instance where the
PBMS has been created
- If you wish to use the graphical PSYCHOfree
client:
a. Move to
your PSYCHOfree home
b. Move to the
path “ClientExtended\classes\com\psychofree\GUI” and lauch the
“run.cmd” file. A wizard will ask you to enter:
i. a
user name for the PBMS you want to use;
ii. its
corresponding password;
iii. the
name of the host where PSYCHOfree server is running;
iv. the
PostgreSQL service name used to connect to the PostgreSQL instance where
the PBMS has been created
|
