How do I configure Resources?

How do I configure Resources?

Pramati Server provides various resources to interact with databases, send mails, and encapsulate URLs. Datasource for the Server enables you to obtain pooled connections to a database. The resources provided by the Server are:

• JDBC Connection Factory to obtain raw connections to a database
• Datasource for a J2EE application
• Datasource cluster to provide auto failover from primary to secondary source
• Mail Resource to send mails from application using the mail session object
• JMS adapter to enable Java programs to create, send, receive, and read messages of a messaging system.
• Connectors to define a set of system-level contracts between the Server and resource adapter.
• URL resource to obtain URL connections.

Resources can be configured on Server by using the:

• resource-config.xml located at <install_dir>\server\nodes\<node_name>\config.
• Resource Shell. At the command prompt type ressh. To add or delete a resource, use the commands described under the specific headings.
• JDBC Resource MBean. Obtain the following MBeans:
  • Root Server MBean by looking up for root-server-mbean from the naming service by entering J2EEServerMBean serverMBean = ic.lookUp("root-server-mbean"); where ic refers to the Initial Context.
  • Resource Service MBean by entering ResourceServiceMBean resourceServiceMBean = serverMBean.getResourceService();
• On the Console, select Configure > Resources. This displays the screen for configuring resources. You can use this screen to add, edit, and delete the desired resources.

In case there is an exception while creating a resource, a proper message is displayed for the same. To know more about the cause of the exception, read the log file that is generated at <install_dir>\server\nodes\<node_name>\logs.

How do I set System Properties in resource-config.xml?

Configuration properties for JDBC datasources are present under each individual datasource entry in the resource-config.xml. Some properties, however, were earlier set as system properties. The following system properties are now moved to the configuration file:

• com.pramati.jdbc.initvalidation.sql.
• com.pramati.jdbc.initvalidation.class.
• com.pramati.jdbc.dbretryintervalmsec
• com.pramati.jdbc.noofdbretrials

The datasource tag in the resource-config.xml has a child tag called connection-initialization, which can be used to provide the system properties.

<connection-initialization sql="..." class=".." db-retrials="8" db-retry-interval-millis="500"/>

Is there an Extension Directory Support?

The ext folder present in the server\lib directory works like the ext folder of <JAVA_HOME>\jre\lib directory. Any jar placed in this directory is picked at runtime. In case you forget to include a particular jar in the Server classpath and need it at runtime, place the jar in the ext directory.

© Pramati Technologies 2007	Runs on Pramati Server | Feedback | Legal