Project

General

Profile

« Previous | Next » 

Revision 4667

Added by daigle almost 16 years ago

Update with windows install documentation

View differences:

docs/dev/building-metacat.html
48 48 
  but a few convenience options have been added to help the developer. </p>
49 49
50 50 
  <p>These instructions are meant to augment the Install Metacat War section of the
51 
  <a href="../user/metacat-install.html">Metacat Installation Guide</a>.</p>
51 
  following guides
52 
  <ul>
53 
  <li><a href="../user/metacat-linux-install.html">Metacat Linux Installation Guide</a>.</li>
54 
  <li><a href="../user/metacat-windows-install.html">Metacat Windows Installation Guide</a>.</li>
55 
  </ul>
52 56
53 57 
  <p>Metacat is built using the Ant build utility.  You will need to have Ant
54 58 
  installed on your development system to build Metacat</p>
docs/user/replication.html
313 313 

  		




  314
  314
  
    
<a name="ControlPanel"></a><div class="header1">The Replication Control Panel:</div>      


  		




  315
  315
  
    
  There is an html control panel for controling replication.  After


  		




  316
  
  
    
  <a href="./Metacat-install.html">installing</a> Metacat, you can access


  		




  
  316
  
    
  installing Metacat, you can access


  		




  317
  317
  
    
  it by going through the Metacat servlet context you have setup and calling up


  		




  318
  318
  
    
  replControl.html.  For instance, if you setup a Metacat servlet instance 


  		




  319
  319
  
    
  called 'knb' you would probably type 


  		












  

    
      docs/user/metacat-source-build.html
    
  





  152
  152
  
    
    


  		




  153
  153
  
    
    <p>You should see a new file named:</p>


  		




  154
  154
  
    
      <div class="code">&lt;metacat_src_dir&gt;/dist/knb.war</div>


  		




  155
  
  
    
    <p>This file will be used during the


  		




  156
  
  
    
      <a href="./metacat-install.html#InstallingMetacat">Metacat Installation</a>.</p>


  		




  157
  155
  
    
      


  		




  158
  156
  
    
  <br>


  		




  159
  157
  
    
    


  		












  

    
      docs/user/metacat-windows-install.html
    
  





  
  1
  
    
<!-- 


  		




  
  2
  
    
  *   '$RCSfile$'


  		




  
  3
  
    
  *     Purpose: web page describing the installation of Metacat


  		




  
  4
  
    
  *   Copyright: 2008 Regents of the University of California and the


  		




  
  5
  
    
  *               National Center for Ecological Analysis and Synthesis


  		




  
  6
  
    
  *     Authors: Michael Daigle


  		




  
  7
  
    
  *


  		




  
  8
  
    
  *    '$Author: daigle $'


  		




  
  9
  
    
  *    '$Date: 2008-12-03 08:56:36 -0800 (Wed, 03 Dec 2008) $'


  		




  
  10
  
    
  *    '$Revision: 4646 $'


  		




  
  11
  
    
  *


  		




  
  12
  
    
  *


  		




  
  13
  
    
  -->


  		




  
  14
  
    
  


  		




  
  15
  
    
<!DOCTYPE html PUBLIC "-//W3C//DTD html 4.0//EN">


  		




  
  16
  
    
<html>


  		




  
  17
  
    

  		




  
  18
  
    
<head>


  		




  
  19
  
    
  <title>Metacat Windows Installation Instructions</title>


  		




  
  20
  
    
  <link rel="stylesheet" type="text/css" href="./common.css">


  		




  
  21
  
    
  <link rel="stylesheet" type="text/css" href="./default.css">


  		




  
  22
  
    
</head>


  		




  
  23
  
    

  		




  
  24
  
    
<body>


  		




  
  25
  
    

  		




  
  26
  
    
<table class="tabledefault" width="100%">


  		




  
  27
  
    
<tr><td rowspan="2"><img src="./images/KNBLogo.gif"></td>


  		




  
  28
  
    
<td colspan="7">


  		




  
  29
  
    
<div class="title">Metacat Windows Installation Instructions</div>


  		




  
  30
  
    
</td>


  		




  
  31
  
    
</tr>


  		




  
  32
  
    
<tr>


  		




  
  33
  
    
  <td><a href="/" class="toollink"> KNB Home </a></td>


  		




  
  34
  
    
  <td><a href="/data.html" class="toollink"> Data </a></td>


  		




  
  35
  
    
  <td><a href="/people.html" class="toollink"> People </a></td>


  		




  
  36
  
    
  <td><a href="/informatics" class="toollink"> Informatics </a></td>


  		




  
  37
  
    
  <td><a href="/biodiversity" class="toollink"> Biocomplexity </a></td>


  		




  
  38
  
    
  <td><a href="/education" class="toollink"> Education </a></td>


  		




  
  39
  
    
  <td><a href="/software" class="toollink"> Software </a></td>


  		




  
  40
  
    
</tr>


  		




  
  41
  
    
</table>


  		




  
  42
  
    
<hr>


  		




  
  43
  
    

  		




  
  44
  
    
<div class="header1">Table of Contents</div>


  		




  
  45
  
    
  <div class="toc">


  		




  
  46
  
    
    <div class="toc1"><a href="#QuickInstallation">Quick Installation</a></div> 


  		




  
  47
  
    
      <div class="toc2"><a href="#DownloadMetacatInstall">Download Metacat Package</a></div> 


  		




  
  48
  
    
      <div class="toc2"><a href="#CreateDirs">Create Metacat Directories</a></div> 


  		




  
  49
  
    
      <div class="toc2"><a href="#InstallJava">Install Java</a></div> 


  		




  
  50
  
    
      <div class="toc2"><a href="#InstallTomcat">Install Tomcat</a></div> 


  		




  
  51
  
    
      <div class="toc2"><a href="#InstallPostgres">Install PostgreSQL Database</a></div> 


  		




  
  52
  
    
      <div class="toc2"><a href="#QuickInstallMetacatWar">Install Metacat War</a></div> 


  		




  
  53
  
    
      <div class="toc2"><a href="#ConfigureMetacatInstall">Configure Metacat</a></div> 


  		




  
  54
  
    
    <div class="toc1"><a href="#QuickUpdate">Quick Update</a></div>


  		




  
  55
  
    
      <div class="toc2"><a href="#DownloadMetacatUpdate">Download Metacat Package</a></div> 


  		




  
  56
  
    
      <div class="toc2"><a href="#BackupApplication">Backup Existing Metacat Installation</a></div> 


  		




  
  57
  
    
      <div class="toc2"><a href="#QuickUpdateMetacatWar">Update Metacat War</a></div> 


  		




  
  58
  
    
      <div class="toc2"><a href="#ConfigureMetacatUpdate">Configure Metacat</a></div> 


  		




  
  59
  
    
   </div> 


  		




  
  60
  
    

  		




  
  61
  
    
<a name="QuickInstallation"></a><div class="header1">Quick Installation</div> 


  		




  
  62
  
    
  <p>These are the installation instructions for a system that has Windows installed


  		




  
  63
  
    
  and has never had Metacat installed on it:</p>


  		




  
  64
  
    
 


  		




  
  65
  
    
  <a name="DownloadMetacatInstall"></a><div class="header2">Download Metacat Package</div>


  		




  
  66
  
    
  <ul>


  		




  
  67
  
    
  <li>Browse to the 


  		




  
  68
  
    
    <a href="http://knb.ecoinformatics.org/software/download.html">KNB Software Download Page</a>.


  		




  
  69
  
    
    In the Metacat section, select the link that looks like:


  		




  
  70
  
    
      <div class="code">metacat-bin-X.X.X.zip</div></li>


  		




  
  71
  
    
  <li>where X.X.X is the latest version of Metacat.  Choose to save the file locally.</li>


  		




  
  72
  
    
  <li>Extract the Metacat package files using your windows zip utility.</li>


  		




  
  73
  
    
  <li>You should see a war file and several supporting files (we will only use the war).  


  		




  
  74
  
    
  The location where these files were extracted will be refered to as the the 


  		




  
  75
  
    
  &lt;metacat_package_dir&gt; for the remainder of this documentation.</li>


  		




  
  76
  
    
 </ul>


  		




  
  77
  
    
  


  		




  
  78
  
    
  <a name="CreateDirs"></a><div class="header2">Create Metacat Directories</div>


  		




  
  79
  
    
  <ul>


  		




  
  80
  
    
  <li>Create the metacat utility base directory at:


  		




  
  81
  
    
    <div class="code">C:/Program Files/metacat</div></li>


  		




  
  82
  
    
  </ul>


  		




  
  83
  
    

  		




  
  84
  
    
  <a name="InstallJava"></a><div class="header2">Install Java</div>


  		




  
  85
  
    
  <ul>


  		




  
  86
  
    
  <li> Browse to:


  		




  
  87
  
    
    <div class="code">http://java.sun.com/javase/downloads/index_jdk5.jsp</div></li>


  		




  
  88
  
    
  <li>Follow instructions to download JDK 5.0 Update 17</li>


  		




  
  89
  
    
  <li>Run the installer executable that you downloaded</li>


  		




  
  90
  
    
  <li>Set the JAVA_HOME environment variable:</li>


  		




  
  91
  
    
	<ul>


  		




  
  92
  
    
	<li>In "My Computer" properties, go to: advanced settings -> environment variables</li>


  		




  
  93
  
    
	<li>Add System Variable: JAVA_HOME C:\Program Files\Java\jdk1.5.0_17</li>


  		




  
  94
  
    
	</ul>


  		




  
  95
  
    
  </ul>


  		




  
  96
  
    
  


  		




  
  97
  
    
  <!--div class=indent>


  		




  
  98
  
    
   <a name="InstallApache"></a><div class="header2">Install Apache</div>


  		




  
  99
  
    
	<p>Install Apache and and Mod JK packages by typing:</p>	


  		




  
  100
  
    
      <div class="code">sudo apt-get install apache2 libapache2-mod-jk</div>


  		




  
  101
  
    
    <p>Set up Mod JK apache configuration by typing:</p>


  		




  
  102
  
    
      <div class="code">sudo cp &lt;metacat_package_dir&gt;/jk.conf /etc/apache2/mods-available</div>


  		




  
  103
  
    
      <div class="code">sudo cp &lt;metacat_package_dir&gt;/workers.properties /etc/apache2</div>


  		




  
  104
  
    
    <p>Enable Apache Mod JK by typing:</p>


  		




  
  105
  
    
      <div class="code">sudo a2dismod jk</div>


  		




  
  106
  
    
      <div class="code">sudo a2enmod jk</div>


  		




  
  107
  
    
    <p>Set up and enable knb (Metacat) site configurations by typing:</p>


  		




  
  108
  
    
      <div class="code">sudo cp &lt;metacat_package_dir&gt;/knb /etc/apache2/sites-available</div>


  		




  
  109
  
    
      <div class="code">sudo a2ensite knb</div>


  		




  
  110
  
    
    <p>If you want to run an LSID server along with the Metacat server, set up and enable the authority service site 


  		




  
  111
  
    
      configurations by typing:</p>


  		




  
  112
  
    
      <div class="code">sudo cp &lt;metacat_package_dir&gt;/authority /etc/apache2/sites-available</div>


  		




  
  113
  
    
      <div class="code">sudo a2ensite authority</div>


  		




  
  114
  
    
    <p>Restart apache to bring in changes by typing:</p>


  		




  
  115
  
    
      <div class="code">sudo /etc/init.d/apache2 force-reload</div>


  		




  
  116
  
    
  </div -->


  		




  
  117
  
    
     


  		




  
  118
  
    
  <a name="InstallTomcat"></a><div class="header2">Install Tomcat</div>


  		




  
  119
  
    
  <ul>


  		




  
  120
  
    
  <li>Browse to: http://tomcat.apache.org/download-55.cgi</li>


  		




  
  121
  
    
  <li>Download tomcat core zip file</li>


  		




  
  122
  
    
  <li>Extract tomcat files to 


  		




  
  123
  
    
	<div class="code">C:\Program Files\tomcat</div>


  		




  
  124
  
    
  using the windows zip utility.</li>


  		




  
  125
  
    
  </ul>


  		




  
  126
  
    

  		




  
  127
  
    
  <a name="InstallPostgres"></a><div class="header2">Install PostgreSQL Database</div> 


  		




  
  128
  
    
  <ul>


  		




  
  129
  
    
  <li>Browse to http://www.postgresql.org/download/windows</li>


  		




  
  130
  
    
  <li>Download the one-click installer</li>


  		




  
  131
  
    
  <li>run the installer executable</li>


  		




  
  132
  
    
  <li>Edit C:\Program Files\PostgreSQL\8.3\data and add:


  		




  
  133
  
    
	<div class="code">host metacat metacat 127.0.0.1 255.255.255.255 password</div></li>


  		




  
  134
  
    
  <li>Create user. At command line, go to 


  		




  
  135
  
    
	<div class="code">C:\Program Files\PostgreSQL\8.3\bin</div>


  		




  
  136
  
    
  and run:


  		




  
  137
  
    
	<div class="code">createdb -U postgres metacat (enter super user password)</div></li>


  		




  
  138
  
    
  <li>Create metacat user.  First log into postgres:


  		




  
  139
  
    
	<div class="code">psql -U postgres metacat (enter super user password)</div>


  		




  
  140
  
    
    and create user by running:


  		




  
  141
  
    
    <div class="code">CREATE USER metacat WITH UNENCRYPTED PASSWORD 'your_password'</div>


  		




  
  142
  
    
	<div class="code">type: \q to exit</div></li>


  		




  
  143
  
    
  <li>Restart postgres from the start menu by selecting:


  		




  
  144
  
    
	<div class="code">run start/All Programs/PostgreSQL 8.3/Stop Server</div>


  		




  
  145
  
    
	<div class="code">run start/All Programs/PostgreSQL 8.3/Start Server</div></li>


  		




  
  146
  
    
  <li>Test the installation by logging in as metacat user: 


  		




  
  147
  
    
	<div class="code">psql -U metacat -W -h localhost metacat</div>


  		




  
  148
  
    
    <div class="code">type: \q to exit</div></li>


  		




  
  149
  
    
  </ul>    


  		




  
  150
  
    

  		




  
  151
  
    
  <a name="QuickInstallMetacatWar"></a><div class="header2">Install Metacat War</div> 


  		




  
  152
  
    
  <ul>


  		




  
  153
  
    
  <li>Copy the war file to Tomcat:


  		




  
  154
  
    
	<div class="code">copy &lt;metacat_package_dir&gt;\knb.war C:\Program Files\tomcat\webapps</div></li>


  		




  
  155
  
    
  <li>Restart Tomcat: 


  		




  
  156
  
    
	<div class="code">sudo /etc/init.d/tomcat5.5 restart</div></li>


  		




  
  157
  
    
	</ul>


  		




  
  158
  
    
	


  		




  
  159
  
    
  <a name="ConfigureMetacatInstall"></a><div class="header2">Configure Metacat</div> 


  		




  
  160
  
    
  <p>Refer to the documentation on <a href="./metacatconfigure.html">Metacat Confguration</a>


  		




  
  161
  
    
  to complete your installation of Metacat.</p>


  		




  
  162
  
    
    


  		




  
  163
  
    
  <a name="QuickUpdate"></a><div class="header1">Quick Update</div>


  		




  
  164
  
    
  <p>These are the instructions for a Windows system that already has Metacat installed on it, 


  		




  
  165
  
    
  but needs a Metacat upgrade:</p>


  		




  
  166
  
    
  


  		




  
  167
  
    
  <a name="DownloadMetacatUpdate"></a><div class="header2">Download Metacat Package</div>


  		




  
  168
  
    
  <ul>


  		




  
  169
  
    
  <li>Browse to the 


  		




  
  170
  
    
    <a href="http://knb.ecoinformatics.org/software/download.html">KNB Software Download Page</a>.


  		




  
  171
  
    
    In the Metacat section, select the link that looks like:


  		




  
  172
  
    
	  <div class="code">metacat-bin-X.X.X.zip</div></li>


  		




  
  173
  
    
  <li>where X.X.X is the latest version of Metacat.  Choose to save the file locally.</li>


  		




  
  174
  
    
  <li>Extract the Metacat package files using your windows zip utility.</li>


  		




  
  175
  
    
  <li>You should see a war file and several supporting files (we will only use the war).  


  		




  
  176
  
    
  The location where these files were extracted will be refered to as the the 


  		




  
  177
  
    
  &lt;metacat_package_dir&gt; for the remainder of this documentation.</li>


  		




  
  178
  
    
  </ul>


  		




  
  179
  
    
  


  		




  
  180
  
    
  <a name="BackupApplication"></a><div class="header2">Backup Existing Metacat Installation</div>


  		




  
  181
  
    
  <ul>


  		




  
  182
  
    
  <li>To be safe, it is best to backup the existing Metacat installation.  Do so by copying: 


  		




  
  183
  
    
	<div class="code">&lt;web_app_dir&gt;/knb to &lt;web_app_dir&gt;/knb.&lt;yyyymmdd&gt;</div>


  		




  
  184
  
    
	<div class="code">&lt;web_app_dir&gt;/knb.war to &lt;web_app_dir&gt;/knb.war.&lt;yyyymmdd&gt;</div></li>


  		




  
  185
  
    
  <li>Of course, you can use any backup strategy you like (or none at all).</li>


  		




  
  186
  
    
  </ul>


  		




  
  187
  
    
  	


  		




  
  188
  
    
  <a name="QuickUpdateMetacatWar"></a><div class="header2">Update Metacat War</div> 


  		




  
  189
  
    
    <ul>


  		




  
  190
  
    
    <li>Copy the war file to Tomcat:


  		




  
  191
  
    
	  <div class="code">sudo cp knb.war to C:\Program Files\tomcat\webapps</div></li>


  		




  
  192
  
    
	<li>Restart Tomcat: 


  		




  
  193
  
    
	  <div class="code">C:\Program Files\tomcat\shutdown.bat</div>


  		




  
  194
  
    
	  <div class="code">C:\Program Files\tomcat\startup.bat</div></li>


  		




  
  195
  
    
    </ul>


  		




  
  196
  
    
	


  		




  
  197
  
    
  <a name="ConfigureMetacatUpdate"></a><div class="header2">Configure Metacat</div> 


  		




  
  198
  
    
    <p>Refer to the documentation on <a href="./metacatconfigure.html">Metacat Confguration</a>


  		




  
  199
  
    
    to complete your installation of Metacat.</p>


  		




  
  200
  
    

  		




  
  201
  
    
  <br>


  		




  
  202
  
    
</body>


  		




  
  203
  
    
</html>


  		




  0
  204
  
    

  		












  

    
      docs/user/index.html
    
  





  34
  34
  
    
<tr>


  		




  35
  35
  
    
  <td>


  		




  36
  36
  
    
  <p><a href="/software/download.html">Download Metacat</a></p>


  		




  37
  
  
    
  <p><a href="./metacat-install.html">Metacat Installation Instructions</a></p>


  		




  
  37
  
    
  <h3>Installation Instructions</h3>


  		




  
  38
  
    
  <ul>


  		




  
  39
  
    
    <li><a href="./metacat-linux-install.html">Linux Installation Instructions</a></li>


  		




  
  40
  
    
    <li><a href="./metacat-windows-install.html">Windows Installation Instructions</a></li>


  		




  
  41
  
    
  </ul>


  		




  
  42
  
    
  


  		




  38
  43
  
    
  <p>Metacat is a flexible metadata database. It utilizes 


  		




  39
  44
  
    
     <a href="http://www.w3.org/TR/REC-xml" target="offline">XML</a> as a 


  		




  40
  45
  
    
     common syntax for representing the large number of metadata content


  		












Also available in:  Unified diff