Ubik Batch Server Advanced features
From UbikWiki
(add cold deployment feature from other page) |
(add snmp config example) |
||
Line 114: |
Line 114: | ||
Database creation succeded for development mode | Database creation succeded for development mode | ||
... | ... | ||
+ | |||
+ | === SNMP support === | ||
+ | |||
+ | You can add an SNMP (Simple network management protocol) extension in extension-manager.xml file. | ||
+ | |||
+ | example: | ||
+ | |||
+ | <extension className="com.ubikingenierie.console.snmp.SnmpConfiguratorExtension" > | ||
+ | <set-property property="enterpriseOID" value=".1.3.6.1.4.1.107.118"></set-property> | ||
+ | <set-property property="targetSnmpHost" value="127.0.0.1"></set-property> | ||
+ | <set-property property="targetSnmpPort" value="162"></set-property> | ||
+ | <set-property property="errorOid" value=".1.3.6.1.4.1.107.191.1.43"></set-property> | ||
+ | <set-property property="errorCode" value="31"></set-property> | ||
+ | <set-property property="errorSeverity" value="72"></set-property> | ||
+ | <set-property property="warningOid" value=".1.3.6.1.4.1.107.191.1.44"></set-property> | ||
+ | <set-property property="warningCode" value="32"></set-property> | ||
+ | <set-property property="warningSeverity" value="74"></set-property> | ||
+ | <set-property property="messagePrefix" value="TST"></set-property> | ||
+ | <set-property property="textMessageMaxLength" value="250"></set-property> | ||
+ | <set-property property="additionalInfoMaxLength" value="250"></set-property> | ||
+ | </extension> |
Revision as of 12:36, 10 April 2009
Contents |
Features
Cold deployment
What is it
This feature enables the (re)deployment at Server Startup of one or more BARs:
- If BAR is already deployed the new version is deployed
- If BAR is not deployed, it is deployed. If file called “<BAR_ID>-binding.xml” is present it is used to customize Pools binding otherwise default mapping is used
What it does exactly
At Startup, the Batch Server will do the following:
- If BAR with another version exists, it will be undeployed
- If file <BAR_ID>-binding.xml exists in batches-cold-deploy folder it will be used
- If file <BAR_ID>-binding.xml does not exist in batches-cold-deploy but exists batches-deploy it will be used
- Otherwise a default binding that maps logical to same physical name will be created
- The BAR will be deployed
- If it succeeds:
- It will appear in deployed BARs on BatchAdmin application
- Success will appear in Deployment History on BatchAdmin application
- If it fails:
- old BAR (if there was one) will be undeployed
- New BAR will not be deployed and moved to batches-deploy-failure and a file called <BAR File Name>.failure will be written that will contains the Failure
- Failure will appear in Deployment History on BatchAdmin application
How To
To do this:
- Put the bar in folder “<INSTALL_DIRECTORY>\batches-cold-deploy”
- Put a file called “<BAR_ID>-binding.xml” where BAR_ID is the <display-name > in bar.xml to customize JNDI Mapping (see next paragraph)
JNDI Mapping Customization
If you have to customize the mapping of JNDI resources (Pools), example map jdbc/masterdatas to jdbc/masterdatas_beta, you must put in the folder “<INSTALL_DIRECTORY>\batches-cold-deploy” a file called “<BAR_ID>-binding.xml” where BAR_ID is the <display-name > in bar.xml.
Example: If you BAR_ID is “STCOM_BATCH”, you will put a file called STCOM_BATCH-binding.xml that contains:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE bar-resources PUBLIC "-//Ubik-Ingenierie //DTD BAR Binding Resource Configuration 1.0//EN" "http://www.ubik-ingenierie.com/consolebatch/config/bar-binding.dtd"> <bar-resources> <bar-resource nameinbar="jdbc/masterdatas" boundname="jdbc/masterdatas_vbeta" /> <bar-resource nameinbar="jdbc/stcom" boundname="jdbc/stcom" /> </bar-resources>
Development Mode
Explanation:
When development mode is enabled, Batch Server can automatically create an HSQLDB database and all needed SQL tables by itself, so users don't have to create the database.
In development mode HSQL database files are created in a directory that you specify in configuration files. By deleting this files your batch server will recreate an empty database at startup. You can also save this files to make backups of a particular database state.
How to:
To enable the development mode in your batch server you just have to add the following line in your config.properties (see installation guide):
config.propertie:
... DEVELOPMENT_MODE=true
This feature only works with an HSQLDB database, so you have to change the "username", "driverClassName" and "url" parameters in your datasource.xml like this:
Datasource.xml:
... <ResourceParams name="jdbc/console"> <parameter> <name>username</name> <value>sa</value> </parameter> <parameter> <name>isPasswordEncrypted</name> <value>false</value> </parameter> <parameter> <name>driverClassName</name> <value>org.hsqldb.jdbcDriver</value> </parameter> <parameter> <name>url</name> <value><![CDATA[jdbc:hsqldb:file:C:\jdbc\hsql\console\consoleHSQL2]]></value> </parameter> <parameter> <name>validationQuery</name> <value><![CDATA[select 1 from INFORMATION_SCHEMA.SYSTEM_USERS]]></value> </parameter> <parameter> <name>testOnBorrow</name> <value>true</value> </parameter> ...
- username: you have to set this parameter with a "sa" default value
- driverClassName: "org.hsqldb.jdbcDriver"
- url: the jdbc url for development mode is formatted like this: "jdbc:hsqldb:file:$DIRECTORY_PATH/$DATABASE_NAME"
You just have to ensure that $DIRECTORY_PATH exists and is readable because the HSQL database will be created in it. A $DATABASE_NAME.properties and $DATABASE_NAME.log will be created by Batch server to store database.
Example of startup log in development mode:
... starting naming service naming service started starting connector ... connector started ... server started ... Development mode actived... Starting database creation script for development mode... Database creation succeded for development mode ...
SNMP support
You can add an SNMP (Simple network management protocol) extension in extension-manager.xml file.
example:
<extension className="com.ubikingenierie.console.snmp.SnmpConfiguratorExtension" > <set-property property="enterpriseOID" value=".1.3.6.1.4.1.107.118"></set-property> <set-property property="targetSnmpHost" value="127.0.0.1"></set-property> <set-property property="targetSnmpPort" value="162"></set-property> <set-property property="errorOid" value=".1.3.6.1.4.1.107.191.1.43"></set-property> <set-property property="errorCode" value="31"></set-property> <set-property property="errorSeverity" value="72"></set-property> <set-property property="warningOid" value=".1.3.6.1.4.1.107.191.1.44"></set-property> <set-property property="warningCode" value="32"></set-property> <set-property property="warningSeverity" value="74"></set-property> <set-property property="messagePrefix" value="TST"></set-property> <set-property property="textMessageMaxLength" value="250"></set-property> <set-property property="additionalInfoMaxLength" value="250"></set-property> </extension>