12. OHMS Viewer [external]

You will need to consult the various guides for specific information regarding the installation of your OHMS Viewer (http://www.oralhistoryonline.org/documentation/), however, there are some basic principles that we will outline here: Identify where you will be installing your OHMS Viewer. The OHMS Viewer requires a basic LAMP server environment and works well in either an enterprise or in a third-party, shared hosted environment (such as Godaddy.com or Reclaim Hosting). Download the latest version of the OHMS Viewer (http://www.oralhistoryonline.org/start-using-ohms/) Configure your OHMS Viewer. There are some basic steps for viewer configuration. Most importantly, you will need to tell the OHMS Viewer where you will be placing your OHMS XML files and identifying from which OHMS Repository your XML files originated (Repository Name). Link to the XML file from your Content Management System or website. Some institutions are utilizing iFrames to embed the OHMS Viewer into systems such as CONTENTdm, Omeka, or Wordpress. Place the downloaded XML file in the designated “Cachefiles” directory identified during OHMS Viewer installation.

Construct a hyperlink to the XML file to call up the OHMS viewer. Part 1 of the URL will always remain the same, linking to the location of the OHMS viewer. Part 2 will always be the corresponding filename for the OHMS XML file, placed in the cachefiles subdirectory of the OHMS viewer. Place hyperlink in appropriate location of CMS. When transporting interviews into a content management system like Omeka this is one of the fields that can be automatically imported from the OHMS XML. This link can be generated automatically and placed into the OHMS XML file automatically. This can be useful if your workflow could be constructed to harvest those links from the XML and utilized by the content management system you are using. In order to take advantage of this feature, repository admins can enter a default viewer location. As long as the metadata element “XML Filename” is populated for the particular item you are exporting, OHMS will combine the root location of the OHMS Viewer with the specified “XML filename, forming a functional link that populates the OHMS “XML Location” field in the exported XML file.

Make offline copy of: config.ini file located in the config subdirectory. cachefile subdirectory (or directory configured to house the OHMS xml files). Download the latest version of the OHMS Viewer. Unzip download. Access your viewer on the server (via ftp or web interface). Change the filename of the old viewer. Example: If previous version of OHMS Viewer is called OHMS_Viewer, change to OHMS_Viewer_3.3.1 Create new directory labeled OHMS_Viewer or what your previous viewer was called. Copy your archived config.ini in the new config directory. Copy your archived cachefiles subdirectory into the root of the new viewer directory. Note: the new viewer does not contain a config.ini or a cachefiles directory. You had to set this up upon initial setup. Please back these up regularly, but especially before an update/upgrade to a new version of the viewer.