CADViewer 10.2 Collaborator Installation

Collaborator Installation Help

How it works

A collaborator session is established when more than one CADViewer instances communicate with the Collaborator servlet installed on a server. CADViewer instances will send changes and will request changes made by users to the CollaboratorServlet. Once a user changes something with the CADViewer instance, CADViewer will send the changes to the servlet. The servlet will store the changes in files at a given folder/directory. CADViewer repeatedly will send a request to the servlet to see whether there is any changes that other users have made. If there are changes, the servlet will get the data and send them back to CADViewer.

How to set up Collaborator Module to work with CADViewer

You need to have "CollaboratorServlet.class"servlet . If you have File Conversion Module, this "cadviewer_ent.txt" would be the same one.

Collaborator Module

  • Copy the servlet "CollaboratorServlet.class" to your servlet container. Typically, the servlets will be in WEB-INF/classes directory.
  • Modify "web.xml" in WEB-INF if applicable and reset your servlet container, typically you'll have to add the following:

  • <servlet>
    <servlet-name>CollaboratorServlet</servlet-name>
    <servlet-class>CollaboratorServlet</servlet-class>
    </servlet>
    <servlet-mapping>
    <servlet-name>CollaboratorServlet</servlet-name>
    <url-pattern>/servlets/servlet/CollaboratorServlet</url-pattern>
    </servlet-mapping>

  • Use a browser to run the "CollaboratorServlet" servlet i.e. http://xyz.com/servlets/CollaboratorServlet
  • The servlet will give you the location where to put the cadviewer_ent.txt file
  • Copy the cadviewer_ent.txt to the location given above
  • Use an editor to modify the following parameters in cadviewer_ent.txt file:
  • CADViewer

  • Install CADViewer
  • To enable collaborator module from CADViewer, either add the parameter "CollaboratorURL" in the viewer.cfg /viewer.txt or in the html file that launches CADViewer
  • "collaborator_username" parameter is optional and if this is used, CADViewer will list the active sessions from the server and CADViewer sets the user name using the value of this parameter rather than have the username typed in by the user
  • How to use Collaborator