From UbikWiki

Batch Administration Webapp:

This section explains the installation of the Web application that controls one or more Batch Servers.

The application comes as a standard EAR to deploy on J2EE 1.3, J2EE 1.4 or J2EE 1.5 server.

Configuration includes:

• Creating the application Database (Separate from Batch Server database)
• Configuring the BAR Upload directory used by this application, this directory holds the BARs that are further sent to one or more batch servers. This directory must be different from directories used by the Batch Servers
• Once installed, add batch servers to make them visible for administration

Database configuration:

Create the Database

Run the script adapted to your database, all databases supported by Hibernate can be used:

• DB2
• Oracle 9i
• Oracle 10G
• Sql Server 2005
• Postgres 8.x.x
• MySQL
• ...

Optional since 5.1.0.0:

Run the following script in the Database of BatchAdmin:

INSERT INTO parameter(par_context, par_id, par_value, par_description, par_date_upd, par_user_upd, par_date_crt, par_user_crt) 
VALUES ('BAR_UPLOAD', 'DIRECTORY', '<PATH TO BAR UPLOAD DIRECTORY>', 
'Directory where uploaded BARs in deployment will be stored', SYSDATE, 'PMD', SYSDATE, 'PMD');
 
INSERT INTO parameter(par_context, par_id, par_value, par_description, par_date_upd, par_user_upd, par_date_crt, par_user_crt) 
VALUES ('CONSOLE_SERVICE', 'IMPLEMENTATION', 'com.ubikingenierie.console.connect.service.JMX', 
'Service implementation type', SYSDATE, 'PMD', SYSDATE, 'PMD');
commit;

Where <PATH TO BAR UPLOAD DIRECTORY> is the path to a directory where BARs will be uploaded before deployment on servers (This is NOT the same one as the directory used by the BATCH Server)

Deploy the EAR batchadmin-XXX.ear.

Tomcat 6 requirements:

Tomcat required libraries

Add to lib folder the following jars:

• ejb-2.1.jar or an upper version
• log4j-1.2.16.jar
• jta-1.1.jar
• JDBC drivers

Application Context

Put in <TOMCAT_HOME>/conf/Catalina/localhost/ a file named "batchadmin.xml" with following content (Adapt necessary elements):

<Context path="/batchadmin" reloadable="false" debug=">
    <Resource name="jdbc/console" auth="Container"
        factory="org.apache.tomcat.dbcp.dbcp.BasicDataSourceFactory"
        type="javax.sql.DataSource" 
        username="DB_USER" 
        password="DB_PASSWORD"
        driverClassName="DRIVER CLASS FOR UNDERLYING DATABASE"
        url="JDBC URL"
        maxActive="5" 
        maxIdle="3" />
    <Resource name="jdbc/batchadmin" auth="Container"
        factory="org.apache.tomcat.dbcp.dbcp.BasicDataSourceFactory"
        type="javax.sql.DataSource" 
        username="DB_USER" 
        password="DB_PASSWORD"
        driverClassName="DRIVER CLASS FOR UNDERLYING DATABASE"
        url="JDBC URL"
        maxActive="5" 
        maxIdle="3" />
  </Context>

Map the pools:

Available roles

BatchAdmin requires users to be authenticated and have specific roles to use all features of Web Application.

Here is the description of the roles:

Adding a Batch Server:

You must have the role MANAGE_CONSOLES to add a Batch server in the Administration Tool

Open menu Configuration > Manage Consoles

Add a Server

Click on Add Console

Fill this form

Where the parameters are:

Finish the Step

Click on Add Server

Authors

• Philippe Mouawad

Document History

• Page created by Pmouawad, 18 September 2012: New page: = Batch Administration Webapp: = This section explains the installation of the Web application that controls one or more Batch Servers. The application comes as a standard EAR to deploy o...
• Last modified by Pmouawad, 15 October 2012: /* Available roles */