Installing Inline with an Existing Application

This option is the highest performing and involves installing the Composable Architecture Platform server inline with an existing Web application. This is accomplished using a servlet filter and works with all Java application servers that support the servlet specification 2.3 or later.

To install inline, copy the file magic-10.0.jar from the \Tryout Files\jars folder under the Composable Architecture Platform Server installation to the WEB-INF\lib folder of the target Web application.

Once the copy is completed, you need to update your WEB.XML file to ensure that the Composable Architecture Platform server is started with your target application and is correctly sitting inline before your HTTP request processing by servlets or JSPs.

To do this, edit the WEB.XML file and insert the lines highlighted below:

web.xml file

If you already have filters installed with your target application, you can place the Composable Architecture Platform filter anywhere in the chain that is appropriate. Please note that some application servers (such as IBM WebSphere) require all filters to be listed before the full list of filter mappings. Failure to follow this rule can cause the Web application to fail to load.

Once the files are in place, you must copy the magic.properties file from the \Tryout files\configuration folder under your Composable Architecture Platform Server installation to the WEB-INF\classes folder on your target system. Edit it to suit the configuration being created. As a minimum, you will need to provide a home folder. This should be an empty folder on the local file system that the server has authority to read, write and update. Please see the section Understanding the magic.properties configuration settings for more detailed explanations of the configuration settings.