Follow the steps below to install PersephoneShell on your operating system.

Windows

To install PersephoneShell on a Windows machines, just unpack the provided ZIP archive to any directory. The application can be started by running a command 'psh.exe' with parameters. Note, that before actually using PersephoneShell, you will need to make changes to psh.exe.config configuration file (next topic).

 A typical command to start PersephoneShell would be:

psh -s dev

where dev is the name of the connection string specified inside the configuration file.

Mac OS X and Linux

To install PersephoneShell on Linux or Mac OS X machines, follow the steps below.

Make sure that the Mono framework of version 6.8 or higher is pre-installed.

1. Extract the archive to a folder (e.g., /usr/local).
2. Change the permission of the psh file to 755.
3. Edit the psh file to replace $PSH_ROOT with the installation folder. (e.g., /usr/local/PersephoneShell). Or, create a $PSH_ROOT environment variable pointing to the installation folder.
4. Put the psh file at a bin directory under the path.
5. Edit the file psh.exe.config (see next topic).
6. The application can be started by running 'mono psh.exe' with parameters or by running the one-line psh script with parameters.

The text of psh normally includes the call to the wrapper mono (that allows running .NET binary executables on other OS) and the database connection name (e.g., dev):

mono $PSH_ROOT/psh.exe -s dev $@

 A typical command using  psh to start PersephoneShell would be just:

./psh