SetUp Oviyam2

1. If oviyam2 to be installed on tomcat only then follow below instructions else follow http://www.dcm4che.org/confluence/display/OV/Oviyam+Installation

2. Download Oviyam-2.1-bin.zip from the link below

   http://sourceforge.net/projects/dcm4che/files/Oviyam/2.1/

3. Extract the war file downloaded using the following command
   
   

   jar -xvf filename.war

4. Open the extracted source code in IDE

5. In web.xml 

   4.1 comment the following

   <security-constraint>

        <web-resource-collection>

           <web-resource-name>dispatcher</web-resource-name>

           <description>Only allows users with the role WebAdmin to access the Archive Web Administration pages</description>

           <url-pattern>*.jsp</url-pattern>

           <url-pattern>*.html</url-pattern>

           <url-pattern>*.do</url-pattern>

           <url-pattern>/oviyam</url-pattern>

           <http-method>GET</http-method>

           <http-method>POST</http-method>

       </web-resource-collection>

       <auth-constraint>

           <role-name>*</role-name>

       </auth-constraint>

    </security-constraint>

   4.2 uncomment the following 

   <servlet-mapping> 

                <servlet-name>ConfigurationServlet</servlet-name> 

                <url-pattern>/configuration.do</url-pattern> 

   </servlet-mapping>

   <servlet> 

                <servlet-name>ConfigurationServlet</servlet-name> 

                <servlet-class>in.raster.oviyam.servlet.ConfigurationServlet</servlet-class> 

   </servlet

6. In config.html, remove the if else condition below and just use the command $( "#tabs" ).tabs();

   if(role == 'Admin') {
    $( "#tabs" ).tabs();
   } else {
    $( "#tabs" ).tabs().tabs( "remove", 0);
   }

   Reason : We are not using any login credentials and by default we need to see all the tabs. But as per the code, if you logged in as admin then only you will be able to see all the tabs.

7. Build war file again using IDE.

8. Copy the war file to tomcat/webapps

9. Copy the following line to apache-tomcat-8.0.12/bin/setenv.sh: 

   CLASSPATH="/home/bahmni/apache-tomcat-8.0.12/webapps/oviyam2/WEB-INF/lib/*"

10. if it is still not working do the following:
    

    1. Copy the files from Oviyam2.1-bin/tomcat to tomcat/lib

        

11. Access the Patient Order using the below URL template

    http://10.0.0.30:8080/oviyam2/viewer.html?patientID=175903&accessionNumber=ACCNO004999&serverName=dcm4chee

Below are the common issues with Oviyam to display any image.

1. For this error please make sure you have the lib path set to tomcat CLASSPATH

   java.util.NoSuchElementException
   javax.imageio.spi.FilterIterator.next(ServiceRegistry.java:825)
   javax.imageio.ImageIO$ImageReaderIterator.next(ImageIO.java:528)
   javax.imageio.ImageIO$ImageReaderIterator.next(ImageIO.java:513)
   in.raster.oviyam.servlet.WadoServlet.doGet(WadoServlet.java:188)
   javax.servlet.http.HttpServlet.service(HttpServlet.java:618)
   javax.servlet.http.HttpServlet.service(HttpServlet.java:725)
   org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52)

2. For this error make sure you have the jai-image-1.1.jar in tomcat/lib  

   java.lang.NullPointerException from ImageReader.java of oviyam.raster.in

   java.lang.ExceptionInInitializerError
   	org.dcm4cheri.imageio.plugins.DcmImageReaderSpi.createReaderInstance(DcmImageReaderSpi.java:124)
   	javax.imageio.spi.ImageReaderSpi.createReaderInstance(ImageReaderSpi.java:320)
   	javax.imageio.ImageIO$ImageReaderIterator.next(ImageIO.java:529)
   	javax.imageio.ImageIO$ImageReaderIterator.next(ImageIO.java:513)
   	in.raster.oviyam.servlet.WadoServlet.doGet(WadoServlet.java:188)
   	javax.servlet.http.HttpServlet.service(HttpServlet.java:618)
   	javax.servlet.http.HttpServlet.service(HttpServlet.java:725)
   	org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52)

3. For this error Cop files in Oviyam-2.1-bin/tomcat to tomcat/lib

   java.lang.NoClassDefFoundError: Could not initialize class org.dcm4cheri.imageio.plugins.DcmImageReader
   	org.dcm4cheri.imageio.plugins.DcmImageReaderSpi.createReaderInstance(DcmImageReaderSpi.java:124)
   	javax.imageio.spi.ImageReaderSpi.createReaderInstance(ImageReaderSpi.java:320)
   	javax.imageio.ImageIO$ImageReaderIterator.next(ImageIO.java:529)
   	javax.imageio.ImageIO$ImageReaderIterator.next(ImageIO.java:513)
   	in.raster.oviyam.servlet.WadoServlet.doGet(WadoServlet.java:188)
   	javax.servlet.http.HttpServlet.service(HttpServlet.java:618)
   	javax.servlet.http.HttpServlet.service(HttpServlet.java:725)
   	org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52)