Project

General

Profile

metacat / docs / user / metacat-windows-install.html @ 4667

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>