Revision dda3f9a9 BUILD.txt

b/BUILD.txt
6 6 
- Java Development Kit version 1.6.
7 7 
- Apache Ant version 1.7.
8 8 

  		





  9
  
  
    
Running GSS requires a running PostgreSQL server for storing the system's data. Setting up PostgreSQL for gss entails configuring the database to accept connections from the application server and create the appropriate database and user:


  		





  
  9
  
    
Running GSS requires a running PostgreSQL server for storing the system's data. Setting up PostgreSQL for gss entails configuring the database to accept connections from the application server and creating the appropriate database and user:


  		





  10
  10
  
    

  		





  11
  11
  
    
# create user gss with password 'gss';


  		





  12
  12
  
    
# create database gssdb owner gss encoding 'UTF8';


  		





  ......




  17
  17
  
    
Installing and configuring dependencies


  		





  18
  18
  
    
---------------------------------------


  		





  19
  19
  
    

  		





  20
  
  
    
Run "ant install" from the gss directory to download the various software dependencies (JBoss, GWT, etc.) and install the configuration files. The install task is something that will need be executed again only if the configuration files or dependencies change. This requirement will be explicitly mentioned in the ChangeLog after a new release.


  		





  
  20
  
    
Run "ant install" from the gss directory to download the various software dependencies (JBoss, GWT, etc.) and install the configuration files. The install task is something that will need to be executed again only if the configuration files or dependencies change. This requirement will be explicitly mentioned in the ChangeLog after a new release.


  		





  21
  21
  
    

  		





  22
  22
  
    

  		





  23
  23
  
    
Building and running the server


  		





  ......




  25
  25
  
    

  		





  26
  26
  
    
Run "ant run" from the gss directory to build and deploy gss and start JBoss. Use Ctrl/Cmd-C to stop the server. If you want to rebuild and redeploy the service after having made changes to the source code, run "ant deploy" or "ant" without a task name, which does the same thing.


  		





  27
  27
  
    

  		





  28
  
  
    
On first launch the database will be empty. If you have successfully setup Shibboleth authentication (see the Authentication section below) you may use existing user credentials to log into the service. If the Shibboleth IdP is itself empty, visit the following URL:


  		





  
  28
  
    
On first launch the database will be empty. If you have successfully setup Shibboleth authentication (see the "Authentication" section below) you may use existing user credentials to log into the service. If the Shibboleth IdP is itself empty, visit the following URL:


  		





  29
  29
  
    

  		





  30
  30
  
    
http://127.0.0.1:8080/pithos/register


  		





  31
  31
  
    

  		





  ......




  89
  89
  
    

  		





  90
  90
  
    
Then point a browser to http://127.0.0.1:8080/pithos/ in order to connect to the service.


  		





  91
  91
  
    

  		





  92
  
  
    
Alternatively, for development purposes, you can use a shortcut in the server to authenticate without Shibboleth. You have to manually initialize a user entry in the database first (using SQL insert) and then set its username in the testUsername property of the jboss\conf\gss.properties configuration file. You can find it deployed in JBOSS_HOME\server\default\conf\gss.properties. The proper URL for using in this scenario is the following, which can be also found in the GWT hosted mode launch configuration:


  		





  
  92
  
    
Alternatively, for development purposes, you can use a shortcut in the server to authenticate without Shibboleth. You have to register a new account (see "Building and running the server" section above) or manually initialize a user entry in the database first (using SQL insert) and then set its username in the testUsername property of the jboss\conf\gss.properties configuration file. You can find it deployed in JBOSS_HOME\server\default\conf\gss.properties. The proper URL for using in this scenario is the following, which can be also found in the GWT hosted mode launch configuration:


  		





  93
  93
  
    

  		





  94
  94
  
    
http://127.0.0.1:8080/pithos/login?next=http://127.0.0.1:8080/pithos/


  		












Also available in:
  Unified diff