Frequently Asked Questions Frequenty Asked Questions

FAQs

Here you will find commonly asked questions of the ResCarta support team...

Latest JAVA ISSUES

 We have suggested using Oracle (previously Sun Microsystems) JAVA for many years, but recent events has changed our thinking.

Oracle will no longer provide free continuing support (updates) for OpenJDK LTS versions at https://jdk.java.net

AdoptOpenJDK does provide support at https://adoptopenjdk.net/ .

AdoptOpenJDK is now distributing OpenJDK msi installers. The installers will optionally updated the PATH and JAVA_HOME. We recommend removing Oralcle JAVA with the operating system supported method and installing OpenJDK 11 LTS.  Version 7.0.2 of the ResCarta Toolkit supports OpenJDK 11.

AdoptOpenJDK is also providing updates to OpenJDK 8.

The most asked question concerns the use of 32bit JAVA on a 64bit machine.  It you are using a 64bit operating system, download the 64bit JAVA from Oracle.  The current url for JAVA 8 from Oracle is.

http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html   

Take care not to update to unsupported versions of 9, or 10

For those running "ix" operating systems ...

$ sudo apt-get install openjdk-11-jdk

or 

$ su -c "yum install java-1.8.0-openjdk"

 

During the installation of the ResCarta Toolkit you will see that the installer selects 32bit or 64bit options based on your installed JAVA. If you run 32bit JAVA on a 64bit machine you will get poor performance and have access to only one gigabyte of memory.

Most ResCarta problems over the years involve early untested releases of JAVA by Oracle. See the history of releases at wikipedia.  If you see a release date within a day or two of another release date, chances are you will be experiencing some malfunction.  We advise updating JAVA only if you need to do so for some known reason.

https://en.wikipedia.org/wiki/Java_version_history#Java_SE_8

 

 

 

JHOVE and ResCarta

Harvard's JHOVE and ResCarta Data

Jhove invalidates some ResCarta accepted tiff images.

If you are running the Harvard file validator called JHOVE and receive the following error on tiff images in your ResCarta collection.files

Status: Not well-formed”

Add the following line to your configuration file (jhove.conf) in your home directory or create a custom configuration file with this line and use the -c parameter with JHOVE.

<param>byteoffset=true</param>

Change your tiff module from...

<module><class>edu.harvard.hul.ois.jhove.module.TiffModule</class></module>

 to the following...

<module><class>edu.harvard.hul.ois.jhove.module.TiffModule</class>

<param>byteoffset=true</param></module>

After this parameter has been added you will not longer get a “Not well formed” message but you will get an informational message about the values that may not be word aligned. These images have addition tags not modified by the ResCarta data conversion tool and are acceptable TIFF images. The images will then be noted as " Well-Formed and valid" by JHOVE with an informational message like the one below...

TIFF-hul

InfoMessage: Value offset not word-aligned: 493

 

 

JHOVE and the Unknown TIFF IFD tags 5687,5688 and 5689.

 

These tags are the location of the ResCarta metadata which are defined in the ResCarta specifications. These tags were declared PUBLIC when regisstered with the TIFF tag registry with Adobe Corporation. 5697 = MODS XML data, 5688 = Word data, 5689 = Word location and font data.

 

InfoMessage: Unknown TIFF IFD tag: 5687

InfoMessage: Unknown TIFF IFD tag: 5688

InfoMessage: Unknown TIFF IFD tag: 5689

 

 

Tomcat Default Port

I can't see my ResCarta-Web site from outside my institution?

 

The default port for the Apache Tomcat service is 8080.  This port is defined for HTML traffic along with the more often used port 80.  On many campus networks all high ports are blocked.   This means the high HTML port of 8080 is also blocked.

If your server is not using port 80 for any other server (APACHE, IIS), you can change the default port of your Apache Tomcat server to port 80 by editing the  server.xml file located in the conf directory. Look for the connector which should be set to 8080. It should be like the following...

<Connector port="8080" protocol="HTTP/1.1"

connectionTimeout="20000" redirectPort=

"8443" />

Change the 8080 to 80 and restart your Tomcat service.

 <Connector port="80" protocol="HTTP/1.1"connectionTimeout="20000"

redirectPort="8443" />

 If your server is also running IIS and it is located on port 80,  your Tomcat service will not start.  To run both IIS and Tomcat and use a sinlgle port 80 will require a more extensive configuration of both IIS and tomcat. 

 

 

 

 

Browser Support

What browsers are supported by ResCartaWeb?

 

This is the list of tested and confirmed browsers, but this does not mean ResCartaWeb will not run on your browser; it only means that listed browsers have been tested: IE6+, IE7.0, Firefox 1.0, 1.1, 1.2, 2.0, 3.0 Safari OS X Tiger, Netscape 4+, Opera.

 

Seeing Double

I know my data is good but when I copied it from my work area the collection manager does not recognize it as valid data. What could be wrong?

Sometimes while coping using a drag and drop method your mouse may have been a bit off the mark when you dropped your data.  Look for the occurance of another RCDATA01 directory under your top-level RCDATA01 directory.  It might look like  C:\mydata\RCDATA01\myinstid\RCDATA01\myinstid\myaggreg\00000516 

You might have just dropped the RCDATA01 into a lower directory. Since the collection manager looks up and down the tree for valid ResCarta data formats it can be confused by multiple top level names.