JChem Web Services FAQ

Version 6.2.3

  1. Where can I see a live client that uses JChem Web Services?
  2. Where can I see the WSDL files of the services?
  3. How do I fix problems with my database driver?
  4. What if there is something using the default port number?
  5. How do I view or debug the soap messages sent to the JChem Web Services Server?
  6. How do I use the axis2 administration console?
  7. Where can I find more information about JChem Web Services?
  8. Where can I see information about JChem Search performance?

  1. Where can I see a live client that uses JChem Web Services?

    Please see the online AJAX example for a live client.
    If you want to use the built-in AJAX example, please see the AJAX example setup instructions.

  2. Where can I see the WSDL files and API of the services?

    Please see http://localhost:8180/axis2/ and click on the Services link.
    All available web services will be displayed. Clicking on the name of the service will display the individual WSDL files.
    Alternatively, you can find links to current WSDL files and Java APIs for web services online at the JChem Web Services Developer's Guide.

  3. How do I fix problems with my database driver?

    If there are problems with database drivers, confirm that the appropriate driver is located in <JChemWebServices_dir>/tomcat/webapps/axis2/WEB-INF/lib and restart the server.
    For information about database drivers and JChem, see the JChem Developer's Guide.
    For specific examples of database driver and database url values, see the JChem FAQ.

  4. What if there is something already using the default port number?

    If there is another service or program already using the default port, you may change the port number. Change the http connector port (i.e. 8180) to the new desired port number in <JChemWebServices_dir>/tomcat/conf/server.xml, then restart the server.

  5. How do I view or debug the soap messages sent to the JChem Web Services Server?

    Below is the outline for the steps to take:

    1. Insert the soapmonitor module inside of <JChemWebServices_dir>/tomcat/webapps/axis2/WEB-INF/conf/axis2.xml.
      	<module ref="soapmonitor"/>
      The phases orders do not need to be changed inside axis2.xml.
    2. Add the servlet and servlet mapping inside of <JChemWebServices_dir>/tomcat/webapps/axis2/WEB-INF/web.xml.
          <servlet>
             <servlet-name>SOAPMonitorService</servlet-name>
             <display-name>SOAPMonitorService</display-name>
             <servlet-class>
               org.apache.axis2.soapmonitor.servlet.SOAPMonitorService
             </servlet-class>
             <init-param>
                <param-name>SOAPMonitorPort</param-name>
                <param-value>5001</param-value>
             </init-param>
             <load-on-startup>1</load-on-startup>
          </servlet>
      
          <servlet-mapping>
              <servlet-name>SOAPMonitorService</servlet-name>
              <url-pattern>/SOAPMonitor</url-pattern>
          </servlet-mapping>
    3. Obtain the applet classes and place them at the root of the WAR file.
      1. From the <JChemWebServices_dir>/tomcat/webapps/axis2/WEB-INF/lib directory, unpack the soapmonitor jar.
        		jar -xf soapmonitor1.4.jar
      2. Copy the newly created org directory into the axis2 root at <JChemWebServices_dir>/tomcat/webapps/axis2/.
    4. After restarting your server, use a Web browser and go to http[s]://host[:port][/webapp]/SOAPMonitor (e.g.http://localhost:8180/axis2/SOAPMonitor) substituting the correct values for your server.
      This will show the SOAP Monitor applet used to view the service requests and responses.
    For further information, see the Axis2 soap monitor module documentation.
  6. How do I use the axis2 administration console?

    The link is which can point to that site: http://<my server:8180>/axis2/axis2-admin/login. You can find the user name and password in the <JChem Web Services directory>/tomcat/webapps/axis2/WEB-INF/conf/axis2.xml file. The user name and password should be changed before deploying your server for widespread use.

  7. Where can I find more information about JChem Web Services?

    Please see the JChem Web Services Introduction for more information and documentation links.

  8. Where can I see information about JChem Search performance?

    Please see the JChem Performance FAQ.

If your question is not answered, please check out our forum or .

Do you have a question? Would you like to learn more?

Please browse among the related topics on our support forum or search the website. If you want to suggest modifications or improvements to our documentation email our support directly!