Differences

This shows you the differences between two versions of the page.

--- prolineconcepts:pwd [2013/11/08 15:00]
193.48.0.3
+++ prolineconcepts:pwd [2016/07/07 14:13] (current)
132.168.72.225 [Setup the Proline Service]
@@ Line 1: / Line 1: @@
-====== Installation ======
+====== Installation and configuration of Proline Web Desktop ======
-  * The Proline Web Extension 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 Proline Web Extension server, or any other network-accessible computer. You will find the installation files on this page : [[http://www.mongodb.org/downloads]]
+  * 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 run the Proline Web Extension Installer
+  * 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.
 ====== Configure the Server =====
-If you installed your MongoDB database on a different computer than the Proline Web Extension server, you'll need to edit the Proline Web Extension configuration file :
+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 Proline Web Extension server
+    * Go to the installation directory of your PWX server
-    * Go to the "conifg" folder and open the "pwx.conf" file with any text editor (like Window default Notepad)
+    * Go to the "conf" folder and open the "application.conf" file with any text editor (like Window default Notepad)
-    * Setup the "mongo_db_config" "host" parameter with the right URL to your MongoDB server (ex: 'mongodb://185.532.02.33:27017' or 'mongodb://distant_computer_name:27017')
+    * 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 you defined a specific user and password on your MongoDB server, you should add them as "user:"user_name" and "password:"your_password" parameters
-If MongoDB is installed on the same computer as the Proline Web Extension server, you don't need to configure anything at this time.
+If MongoDB is installed on the same computer as the PWX server, you don't need to configure anything at this time.
 ====== Launch The Server ======
-  * First, please make sure that MongoDB is running. If it's not, please start it manually.
+  * First, please make sure that MongoDB is running. If it's not, please start it manually. [[http://docs.mongodb.org/manual/|See official docs]]
-  * In order to start the Proline Web Extension server components, go to its installation folder, and launch the "start.bat" script. This script will start the following programs :
+  * 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.
-    * The Gearman service : this is a program used to supervise and manage heavy tasks requests that will be executed by the PWX Daemon program.
-    * The PWX Daemon, that handles :
-      * the heavy works that need to be ran in a separated Perl process
+====== Connect to the Proline Desktop ======
-      * the events listenning and dispatching.
-    * The PWX "Mojolicious" Program that is the actual web server. It runs the Web Desktop and the Applications.
+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:9000" (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 User menu button once you're logged in.
 ====== Setup the Proline Service ======
-  * The connection between the desktop and the proline core server is provided by the "proline" service, automatically started at server's launch
+  * 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">"Registered Services"
+  * To set it up, as an admin user, once logged in, click on the "gear" button on the top task bar. Then open the Daemons tab, and click on "Proline" to edit its settings :
-  * Click on "proline" in the Services Grid Table to select it, and then click on "Configure"
-  * {{:prolineconcepts:proline_config.png|o}}
+{{ :prolineconcepts:edit_settings.png?direct |}}
-  * You must set up the right connexion informations and data directories in order to access the Proline Core Web services 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). These to paths must point to the same folder. There are two of them because you need to mount a shared folder between the VM and its host to access its files list, but Jetty won't know anything about it (/media/sf_mascot_data_root).
+  * Here are some param values you can use :
-  * Once it's done, simply click "Save Configuration"
+    * __ws_host__ is the address of the Proline Web Core server. Use the name or the IP address of the server to set the URL. Examples :
-  * 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
+      * ''http://servername:8080/proline''
+      * ''http://localhost:8080/proline''
+      * ''http://198.0.13.37/proline'' (replace 198.0.13.37 by the right IP address)
+    * __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__.
+    * __db_password__ is the password you gave to the PostgreSQL user specified above.
+    * __mascot_server_url__ (optional) is the url of your mascot server
-====== The Dataset Explorer ======
+You might need to restart the PWX server to make sure these new settings are updated.
-FIXME : CBy : cette partie devrait aller dans le how to "create a project" et "create an aggregate"
-  * Click on "Start">"Dataset Explorer" to run the Dataset Explorer app
-  * To create a new Project, click on "New Project". After its creation, it should appear in the left part of the window
-  * Right-Click on your project to access its Menu : click on "Import Result File" to import .dat files in your project
-  * You can follow the import task satuts by clicking on the little piece of cake in the bottom-right of the desktop screen.
-  * When it's done, you can create an identification in your project by right-clicking on its "Identifications Trees" node, and picking the "New Identification" item
-  * Drag and drop the ResultSets from the left table to the selection table of your identification. Make sure to enter a name and a description before clicking Ok
-  * Once it's created, you'll want to validate it by right clicking its node (below the Identifications Trees node) and picking "Launch Validation" on the list.
-  * Set you settings up and run it !
-  * I bet it doesn't work yet ..

Proline

User Tools

Site Tools

Differences

Page Tools