Customising PURLZ Server home page and logo

[John P]

I've installed PURLZ Server and I am now trying to customise the
default home page displayed at:
http://<PURL server>/docs/index.html

This seems to be stored at:
<PURL server installation directory>/src/purl/mod-purl-documentation/
modules/mod-purl-documentation/resources/index.html

However, editing this page does not seem to change the live home page.
Is this the correct page to edit, or is it being cached somewhere
(i.e. by Netkernel)? Also similarly, I am trying to change the default
icon - /docs/images/purl-128.jpg and add a favicon.ico file, but this
does not seem to change the live content either. I've noticed some
other PURL resolvers have been customised - such as those of the
Federal Depository Library Program and The Florida Center for Library
Automation. I'd be grateful if anyone can share their experience of
customising PURLZ Server and how they were able to edit the files.

Thanks,
John

[Gary Phillips]

Hello,

(Apologies to the list if this has been already answered, I just received this email from the list yesterday).

John,

The files you are looking to modify are in a jar file in the modules directory.  For our current version the file is called

mod-purl-documentation-1.6.3.jar

You have to unpack the jar file, change the files, repack and replace the existing version, then restart PURL to see the changes.

Here's the snippet from our docs, starting at the PURL top directory (replace x with your current version:

    cd modules
    mkdir temp
    cp mod-purl-documentation-1.x.jar temp
    cd temp
    jar xvf mod-purl-documentation-1.x.jar
    (make changes in sub directory resources, return to temp)
    (rm old jar file)
    jar cvf mod-purl-documentation-1.x.jar *
    cd ..
    cp temp/mod-purl-documentation-1.x.jar . (you probably want to back up the current file first)
    (restart purl to see changes)

Hope this helps!  IIRC image files will be in the unpacked jar file under resources/images.

Gary Phillips

Florida Center for Library Automation