Configuring Data Integrators
To configure a data integrator, you must create a property file that contains specific properties for the overall data transfer and for the individual data processors. When you create a property file, you must:
- Define logging properties by using the standard property names and values for SRC logging. To define the logging properties, use the following format:
Logger.<groupName>.<propertyName>=<value>For detailed information about configuring logging properties, see SRC-PE Monitoring and Troubleshooting Guide, Chapter 4, Configuring Logging for SRC Components on a Solaris Platform.
- Define properties for the individual processors. The properties that you must or can configure depend on the particular processor. To define properties for the processors, use the following format:
Processor.<processorName>.<propertyName>=<value>
- <processorName>—Name of processor that you define; each processor in a property file must have a unique name
- <propertyName>—Name of property; may comprise several text strings separated by dots
- <value>—Value of property
To define properties for each processor, see:
- Defining Properties for the Database Reader
- Defining Properties for the LDAP Reader
- Defining Properties for the XML File Reader
- Defining Properties for the Enterprise Audit File Reader
- Defining Properties for the XML File Writer
- Defining Properties for the XSLT Translator
- Defining Properties for the LDAP Writer
For detailed information about each processor, see the online documentation in the SRC software distribution in SDK/doc/dataint.
- Define the order in which the processors are called. To define the order in which the processors will be executed, enter one statement in the following format:
Processor.chain=<comma-separated list of names of processors in order>Processor.chain=dbreader,toldap,xmlfilewriter,ldapwriterDefining Properties for the Database Reader
You must define the following properties for this processor:
Processor.dbreader.dbQuery=SELECT <sqlQuery>Processor.dbreader.driverClass=<driverClass>Processor.dbreader.dbURL=<databaseURL>Processor.dbreader.user=<username>Processor.dbreader.password=<password>
- <username>—Username that the database uses to authenticate the processor
- <password>—Password that the database uses to authenticate the processor
Processor.dbreader.out=domInclusion of data in the XML document that the processor returns Processor.dbreader.genData=trueAny optional properties that you require For information about optional properties for this processor, see the online documentation in the SRC software distribution in SDK/doc/dataint.
The following example is a property file for this processor:
# Database ReaderProcessor.dbreader.class=net.juniper.smgt.ent.datamgt.reader.DBReaderProcessor.dbreader.driverClass=org.gjt.mm.mysql.DriverProcessor.dbreader.dbURL=jdbc:mysql://127.0.0.1:3306/vpnProcessor.dbreader.user=adminProcessor.dbreader.password=secretProcessor.dbreader.genData=trueProcessor.dbreader.out=dom# The SQL queryProcessor.dbreader.dbQuery=SELECT vpn_ownership.vpn_id, vpn_ownership.vpn_owner,vpn_sites.router_name,vpn_sites.interface_name FROM vpn_ownership, vpn_sites where vpn_ownership.vpn_id=vpn_sites.vpn_id# XML element namesProcessor.dbreader.elname.database=database#Processor.dbreader.elname.record=recordDefining Properties for the LDAP Reader
This processor obtains the query it performs as an XML document from the previous processor in the chain, and you do not need to define the query. You must, however, define the following properties for this processor:
Processor.<processorName>.<desProperty>=<value>
- <processorName>—Name of processor that you define; each processor in the same property file must have a unique name
- <desProperty>—Name of the DES property
- <value>—Value of the DES property
For information about DES properties and values, see SRC-PE Getting Started Guide, Chapter 32, Distributing Directory Changes to SRC Components on a Solaris Platform.
For information about optional properties for this processor, see the online documentation in the SRC software distribution in SDK/doc/dataint.
The following example is a property file for this processor:
Processor.ldapreader.class=net.juniper.smgt.ent.datamgt.reader.LDAPReaderProcessor.ldapreader.java.naming.provider.url = ldap://127.0.0.1/Processor.ldapreader.java.naming.security.principal = cn=umcadmin,o=umcProcessor.ldapreader.java.naming.security.credentials = admin123Processor.ldapreader.continuous=trueProcessor.ldapreader.java.naming.provider.url = ldap://127.0.0.1/Defining Properties for the XML File Reader
You must define the following properties for this processor:
- Name of the class of the processor
- In the following format, the XML document from which this processor reads data:
Processor.<processorName>.XMLFileName= <path>
- <processorName>—Name of the processor that you define; each processor in the same property file must have a unique name
- <path>—Path to XML document relative to the folder /opt/UMC/datint
The following example is a property file for this processor:
Processor.xmlfilereader.class=net.juniper.smgt.ent.datamgt.reader.XMLFileReaderProcessor.xmlfilereader.XMLFileName=var/log/dbout.xmlDefining Properties for the Enterprise Audit File Reader
You must define the following properties for this processor:
- Name of the class of the processor
- In the following format, the log file from which this processor reads data:
Processor.<processorName>.auditFileName=<path>
- <processorName>—Name of the processor that you define; each processor in the same property file must have a unique name
- <path>—Path to the XML document relative to the folder /opt/UMC/datint
For information about optional properties for this processor, see the online documentation in the SRC software distribution in SDK/doc/dataint.
The following example is a property file for this processor:
Processor.auditfilereader.class=net.juniper.smgt.ent.datamgt.reader.EntAuditFileReaderProcessor.auditfilereader.auditFileName=ent_audit.logProcessor.auditfilereader.filter=(Action=Unexport-VPN)Defining Properties for the XML File Writer
You must define the following properties for this processor:
- Name of the class of the processor
- In the following format, the XML document to which the processor writes data:
Processor.xmlfilewriter.XMLFileName=<path>The following example is a property file for this processor:
Processor.xmlfilewriter.class=net.juniper.smgt.ent.datamgt.filter.XMLFileWriterProcessor.xmlfilewriter.XMLFileName=var/log/ldapout.xmlDefining Properties for the XSLT Translator
You must define the following properties for this processor:
Processor.<processorName>.XSLTFileName=<path>
- <processorName>—Name of the XSLT translator
- <path>—Path to XSLT file relative to the folder /opt/UMC/datint
The following example is a property file for this processor:
Processor.toabstract.class=net.juniper.smgt.ent.datamgt.filter.XSLTTranslatorProcessor.toabstract.XSLTFileName=xslt/vpn.xsltDefining Properties for the LDAP Writer
You must define the following properties for this processor:
Processor.ldapwriter.<desProperty>=<value>For information about DES properties and values, see SRC-PE Getting Started Guide, Chapter 32, Distributing Directory Changes to SRC Components on a Solaris Platform.
For information about optional properties for this processor, see the online documentation in the SRC software distribution in SDK/doc/dataint.
The following example is a property file for this processor:
Processor.ldapwriter.class=net.juniper.smgt.ent.datamgt.filter.LDAPWriterProcessor.ldapwriter.java.naming.provider.url = ldap://127.0.0.1/Processor.ldapwriter.java.naming.security.principal = cn=umcadmin,o=umcProcessor.ldapwriter.java.naming.security.credentials = admin123Processor.ldapwriter.updateRateLimit=3Processor.ldapwriter.continuous=true