User Tools

Site Tools


metacat_and_knb_web_maintenance

Computing Staff Information → Metacat and KNB Web Maintenance

Building, Installing and Publishing Metacat Release Distribution

Metacat release candidates are built on the nceas dev server to ensure safe, repeatable builds. See the following instructions for building your desired version

Update KNB Web Service

The KNB web service is the web interface that provides basic KNB services. To upgrade KNB web pages or individual product documentation, see:

Build and Install Registry Web Application

The registry web application provides an API to metacat. To build and install it, go to:

Site Specific Notes

KNB

ESA

  • The url for metacat is http://data.esa.org
  • Copy /var/www/cgi-esa/12102007backup/ldapweb.cfg to overwrite /var/www/cgi-esa/ldapweb.cfg as root.

SANParks (Skukuza)

SAEON (Pretoria)

  • The url for metacat is http://metacat.saeon.ac.za/saeon
  • The saeon node in Pretoria sits behind a windows proxy server. The proxy server runs apache. HTTP and HTTPS commands are redirected from the proxy server to the metacat machine.
  • The following lines were added to /etc/apache2/sites-available/saeon since apache tries to redirect requests to /saeon to /saeon/, but it uses the local IP for the address in the redirect. This directive rewrites instead of redirects:
  <tt> RewriteEngine on </tt>
  <tt> RewriteRule ^/saeon$    http://metacat.saeon.ac.za/saeon/ </tt>
  • Also, the following command was run to enable the rewrite module:
  <tt> sudo a2enmod rewrite </tt>
  • To access the metacat machine, you will need to go through the proxy server. The steps are:
    • ssh to proxy server at saeon@196.25.64.210 (see secure password repository for password)
    • from within proxy server, ssh to metacat server at saeon@10.50.130.90 (see secure password repository for password)

SAEON (Phalaborwa)

  • The installation and running user is webuser.
  • The database user is metacat and database name is metacat as well.
  • It replicates data and metacat to dataknp.sanparks.org (one way).
  • Apache and postgresql come from Ubuntu
  • JDK comes from java.sun and Tomcat comes from apache site.

SAEON (Cape Town)

  • The server is running Windows 2003.
  • It will replicate data and metacat to dataknp.sanparks.org (one way).
  • Tomcat is running as a service and using port 80 for HTTP and 443 for HTTPS
  • The server is behind a Microsoft ISA firewall server with a self-signed certificate that allows HTTPS traffic to saeonocean machine.
  • JDK is 1.6, Postgres is 8.3, Tomcat is 6
  • the Perl registry is not installed

Testing Installation

This is not completed test, but will cover most cases. I usually don't test insert and update since I don't want to put some garbage into production server.

For knb metacat at knb machine:<br> 1. Login and logout in knb web site.<br> 2. Some search in knb web site.<br> 3. Read eml document in knb web site.<br> 4. Login and logout in nceas skin.<br> 5. Some search in nceas skin.<br> 6. Read eml document in nceas skin.<br> 7. Login, logout, search and read in obfs and nrs skin.<br> 8. Check http://knb.ecoinformatics.org/knb/services to see if it has AuthenticatedQueryService, IdentifierService, PutService, QueryService,AuthenticationService and wsdl files work well.<br> 9. In kepler, search data and download data.<br>

For kepler metacat at knb machine:<br> 1. Check http://library.kepler-project.org/kepler/services to see if it has AuthenticatedQueryService, IdentifierService, PutService, QueryService,AuthenticationService and wsdl files work well.<br> 2. In kepler, search remote actor repository.<br> 3. In kepler, search ecogrid service provider.<br>

For esa machine:<br> 1. Check http://data.esa.org/esa/services to see if it has AuthenticatedQueryService, IdentifierService, PutService, QueryService,AuthenticationService and wsdl files work well.<br> 2. Login, logout, search and read eml document as regular user.<br> 3. Login, logout, search and read eml document as moderator user.<br>

Common problems and issues

1. No IdentifierService at page http://knb.ecoinformatics.org/knb/services: forget run “ant deploy-ecogrid”. <br> 2. Get error “no such host….” when you run “ant deploy-ecogrid”: forget to modify build.xml - change hostname from “localhost” to domain name.<br> 3. Couldn't open NCEAS registry form: forget to put correct password at nceas.cfg.<br> 4. There is no attaching data file option at NCEAS registry form: the /tmp/knb directory is gone and we need to create one.<br> 5. User couldn't add new ldap user or modify ldap user password: forget to replace ldap.cfg from the backup one.<br>

Set up JMX and run JConsole

Java Management Extensions (JMX) and JConsole allow for monitoring and managing the jvm and applications. To set these up, see:

metacat_and_knb_web_maintenance.txt · Last modified: 2012/02/07 11:32 (external edit)