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

• Build, Install and Publish a Metacat 1.9.0 Release
• Build, Install and Publish a Metacat 1.9.2 Release

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

• Update KNB Web Service

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

• Build and Install Registry Web Application

The Installation of the KNB Metacat

• 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.

• The url for metacat is http://dataknp.sanparks.org/sanparks
• to access the metacat machine, ssh to judithk@dataknp.sanparks.org (see secure password repository for password)

• 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)

• The url is http://datapha.saeon.ac.za/knb/
• 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.

• The url is http://saeonocean.co.za/knb/
• 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

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>

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>

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

• Set Up JMX and JConsole