• The Proline Web eXtension (PWX) is based on the use of MongoDB database engine. You need to download it and install it either on the computer which will host the PWX server, or any other network-accessible computer. You will find the installation files on this page : http://www.mongodb.org/downloads
• Download and unzip the PWX archive.

NOT AVAILABLE YET: The automated installer embeds several components of the Proline Suite. You may only install the Proline Web component, but if you want you can perform a full installation. It will install Proline-Admin and Proline-WebCore in the bin directory of Proline Web.

If you installed your MongoDB database on a different computer than the PWX server, you'll need to edit the PWX configuration file :

• Go to the installation directory of your PWX server
• Go to the “conf” folder and open the “application.conf” file with any text editor (like Window default Notepad)
• Edit the mongodb.servers and cache.mongodb.servers parameters by setting the host name and the port number corresponding to your MongoDB server (default MongoDB port is 27017)

If MongoDB is installed on the same computer as the PWX server, you don't need to configure anything at this time.

• First, please make sure that MongoDB is running. If it's not, please start it manually.
• In order to start the PWX server, go to its installation folder. On Windows platforms launch the “start.bat” script. On Linux platforms execute the “start.sh” script (TODO: create this script).

Once PWX is running, you can connect to the Proline Web Desktop by opening a Web Browser and go to the address of this form: “name-of-the-machine:9000” or “local.ip.of.the.machine:39000” (for instance 192.168.0.30). The default user is “admin” and its password is “proline”. Don't forget to change its password from the start menu button once you're logged in.

• The connection between the desktop and the proline core server is provided by the “proline” service. This service is included with the Proline Web eXtension server, but it needs to be configured. The following steps will explain how :
• To set it up, go to “Start”>“Administration”>“Services Manager”. On the “Services Directory Browser”, you should see the “proline” service appear in the the table.
• 
• Select “proline” in the Grid Table, and then click on “Configure”

• Here are some param values you can use :
  • ws_host is the adress of the Proline Web Core server. Use the name or the IP adress of the server to set the URL. Examples :
    • http://servername:8080/proline
    • http://localhost:8080/proline
    • http://198.0.13.37/proline (replace 198.0.13.37 by the right IP adress)
  • uds_db_dsn is the UDS database connexion configuration (DSN stands for Data Source Name). It has the following format dbi: + name of the Driver (Pg for PostgreSQL, SQLite for SQLite) + :db_name= + name of the Postgre SQL database (uds_db or path to the SQLite file D:/path/to/uds_db.sqlite) + ;host= + Postgre SQL erver adress or name + ;port= + port of the Postgre SQL server. The host and port params are not needed if you use a SQLite database. Here are some config examples :
    • dbi:Pg:dbname=uds_db;host=localhost;port=5432
    • dbi:SQLite:dbname=D:/proline/data/uds_db.sqlite
  • data_root is the directory where the user projects data will be stored. You can use something like D:/proline/data. Make sure this directory exists on your disk, Proline won't create it automatically if it doesn't.
  • ps_db_dsn is equivalent to the uds_db_dsn param but points to the PS Database. Set up the connection config the same way you did it for the UDS Database.
  • pwd_mascot_data_root is the Directory where the PWX server will browse mascot result files. Set it up with a simple path like D:/proline/mascot/data or a network adresse like \\servername\mascot\data. Make sure this directory exists on your disk, Proline won't create it automatically if it doesn't.
  • pwc_mascot_data_root is the path from which the Proline Web Core will access this directory. You should leave it blank if you configured it in the Proline Web Core config file (result_files > root_folder param). If you didn't specify any path there, then you must enter one here in the Proline Service config. This param can also be useful if you installed PWX and Proline Web Core on two different servers, and if one of them runs on Linux, for example. These two paths (pwd_mascot_data and pwc_mascot_data must point to the same folder. There are two of them because you need the PWX server and the Proline Web Core server may not access it via the same way. Fill it the right way so the both servers can access the same directory. If they are on the same network and use the same OS (i.e Windows), you can set up the same path on both fields.
  • db_username is the user name used by the PostgreSQL connection. not needed if you use SQLite. The default PostgreSQL user is “ *postgres* ”.
  • db_password is the password you gave to the PostgreSQL user specified above.
  • raw_files_root is the path to your .raw files root directory
  • mzdb_files_root is the path to your .mzdb files root directory

• You must set up the right connection information and data directories in order to access the Proline Core server properly
• You must set up two path to the mascot data root folder : one for the desktop (pwd_mascot_data_root) and one for jetty (pwc_mascot_data_root).
• Set up the SQL Server connection settings, and the path to the raw files and mzdb files root directory.
• Once it's done, simply click “Save Configuration”
• To make sure that the “admin” user is registered in the UDS DB, you need to logout and login, in order to make the Proline Service to check your status in the UDS DB, and create your account if you're not registered yet