Montag Configuration Guide

This is the main configuration file and it's the unique mandatory configuration step.
Look at this example:

                    
                        <montag-config>
                    
                            <db-driver>org.apache.xindice.client.xmldb.DatabaseImpl</db-driver>
                            
                            <db-uri>xmldb:xindice://localhost:8080/db</db-uri>
                            
                            <services mode="local">
                                <CollectionManager deploy="yes" logRequests="yes" logResponses="yes"/>
                                <AddDocument deploy="yes" logRequests="yes" logResponses="yes"/>
                                <RemoveDocument deploy="yes" logRequests="yes" logResponses="yes"/>
                                <GetDocument deploy="yes" logRequests="yes" logResponses="yes"/>
                                <QueryService deploy="yes" logRequests="yes" logResponses="yes"/>
                                <XUpdateService deploy="yes" logRequests="yes" logResponses="yes"/>
                            </services>
                    
                        </montag-config>
                    
                

You must first configure the XML Database driver to use through the db-driver element and your network database URI through the db-uri element.
Then, you must set the Montag working mode through the mode attribute of the services element; it can take two values:

• local: for local working mode.
• remote: for remote working mode.

Finally, you must configure the deploy information of every service, modifying, for every corresponding element, the following attributes:

• deploy (yes or no): controls the deployment of the single service; if set to no, the service will not be visible and callable.
• logRequests (yes or no): controls the logging of the SOAP requests for the service. If you don't want to log any SOAP request (this could speed up your service), set it to no.
• logResponses (yes or no): controls the logging of the SOAP responses sent by the service. If you don't want to log any SOAP response (this could speed up your service), set it to no.

This step is necessary only if you have configured Montag Web Services to operate in local mode and if the services will access XML Database collections protected by user name and password that you don't want to pass in SOAP headers: the services will read this file for getting the authentication info in order to access the collections.
So, you must store here the usernames and passwords of the XML Database collections.
The structure is very simple; here is an example:

                
                        <local-config>
                        
                                <collection name="test1">
                                                <username>user1</username>
                                                <password>pass1</password>
                                </collection>
                                
                                <collection name="test1/test2">
                                                <username>user2</username>
                                                <password>pass2</password>
                                </collection>
                                
                        </local-config>
                
                

The xml elements to configure are:

collection

This represents the XML Database collection for which you are specifying the authentication info: the name attribute is mandatory and provides the name of the collection with its full path from the root collection.
There can be multiple collection elements, each for every collection for which you want to provide user name and password.

username

This element provides the username for accessing the collection pointed out by its parent element.
It's a mandatory child of the collection element.

password

This element provides the password for accessing the collection pointed out by its parent element.
It's a mandatory child of the collection element.

So, you have to define a collection element, with its username and password children, for every "protected" database collection you want to access.
It's simple.
And it's all.

This step is necessary only if you have configured Montag Web Services to operate in remote mode and if you want to tweak the default settings.
This is the default configuration file provided:

                
                        <remote-config>
                        
                            <session-threshold>10</session-threshold>
                            
                            <session-timeout>30</session-timeout>
                            
                        </remote-config>
                
                

The xml elements to configure are:

session-threshold

This represents the maximum number of active sessions; if exceeded, Montag starts the "search and remove" of timed out sessions.

session-timeout

This represents the maximum time (in minutes) of inactivity for a session; when the session threshold is exceeded, sessions with an inactivity time greater than the session timeout will be removed.

Guard filters configuration