LightPIT: INSTALL@fb2ae2d63a56

     1 Installing LightPIT

     2 -------------------

     4 1. Install a supported database server

     6 Currently this is only Postgresql. See the Postgresql manual for installing a

     7 database instance. On most systems it is sufficient to install the server via

     8 the system package manager.

    10 2. Execute the SQL scripts for creating the database

    12 In the setup directory you find three SQL scripts to install the database.

    14 * Modify psql_create_database.sql and choose appropriate usernames and

    15   passwords. Then execute the script as database administrator.

    16 * Log into the new database with the lightpit_dbo user and execute

    17   psql_create_tables.sql and psql_default_data.sql.

    19 3. Configure a data source in your application servlet or servlet container

    21 You may use absolutely anything: Tomcat, TomEE, Glassfish, Payara, you name it.

    22 If it supports Servlet 6.0, JSP 3.1, and EL 5.0, you are good to go.

    23 Just make sure to configure a data source with the name jdbc/lightpit/app.

    24 If you want another name, you can configure the JNDI resource in the

    25 WEB-INF/web.xml and META-INF/context.xml files. It is highly recommended to use

    26 the lightpit_app user which has less privileges to create the data source and

    27 leave the lightpit_dbo user for the database operator.

    29 4. Deploy the WAR file of lightpit

    31 This is the most straight forward step. Just deploy the WAR file as you usually

    32 do in your application server.

    34 5. Configuring a web server and authentication

    36 LightPIT can optionally detect the authenticated user. You may freely decide

    37 whether to enable authentication in your application server or put a web server

    38 in front. The latter is recommended, but keep in might that forwarding the

    39 authentication information may only work with AJP for certain servlet

    40 containers. Consult the respective manuals of the software you are using.

    42 When the remote user is picked up successfully by LightPIT, comments under

    43 issues e.g. are personalized. For this to work the authenticated username must

    44 match one of the configured usernames in LightPIT.

    46 Have fun!

Mercurial > hg > LightPIT / file revision