VXWS Overview

VXWS Process/Products That Use This Service

VXWS is the back-end service for VWEBV, Tomcat WebVoyage.

VXWS provides services for the RESTful Web Services and the XML over HTTP Web Service.

Default Port/URL

The VXWS port is xx14.

The base URL format is http://yourserver.edu:xx14/vxws plus the rest of the URL as described for the RESTful Web Services or the XML over HTTP Web Services.

Product Version Compatibility

The RESTful Web Services should be used whenever possible.

The RESTful Web Services are available with 7.2.0 and later.

Restricting Access to VXWS

To restrict access to vxws, change the section shown below that is located in the server.xml file that is in the /m1/voyager/xxxdb/tomcat/conf folder. Specifically note the last two lines in the example. The Valve className= line needs to be uncommented and set with the appropriate IP address.

<Context className="org.apache.catalina.core.StandardContext"
        path="/vxws"
        cachingAllowed="true"
        charsetMapperClass="org.apache.catalina.util.CharsetMapper"
        cookies="true"
        crossContext="false"
        displayName="vxws"
        docBase="/m1/voyagerdev/2008.0.0/dev800ncdb/tomcat/vxws/context/vxws"
        privileged="true"
        reloadable="false"
        swallowOutput="false"
        useNaming="true"
        wrapperClass="org.apache.catalina.core.StandardWrapper">
 
        <ResourceLink name="jdbc/voyager"
            global="jdbc/voyager"
            type="javax.sql.DataSource"
        />
 
        <!-- uncomment the following to limit access to connections from this machine only -->
        <!-- <Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="127.0.0.1"/> -->
 
</Context>

Increase/Decrease Level of Logging

The level of logging can be adjusted through the log4j.properties file that is located in /m1/voyager/xxxdb/tomcat/vxws/context/vxws/WEB-INF/classes.

For debug (extended logging) mode, comment or uncomment the following lines as shown in the example below:

log4j.logger.com.endinfosys=DEBUG, LOGFILE
log4j.logger.com.endinfosys.web.util=DEBUG
#log4j.logger.com.endinfosys=FATAL

For non-debug (brief logging) mode where only fatal errors are reported, comment or uncomment the following lines as shown in the example below:

#log4j.logger.com.endinfosys=DEBUG, LOGFILE
#log4j.logger.com.endinfosys.web.util=DEBUG
log4j.logger.com.endinfosys=FATAL

Note that the location of the log file is specified in the line

log4j.appender.LOGFILE.File=