forked from OPENDAP/olfs
-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathinstall.html
113 lines (104 loc) · 4.34 KB
/
install.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
<!--
~ /////////////////////////////////////////////////////////////////////////////
~ // This file is part of the "Hyrax Data Server" project.
~ //
~ //
~ // Copyright (c) 2015 OPeNDAP, Inc.
~ // Author: Nathan David Potter <ndp@opendap.org>
~ //
~ // This library is free software; you can redistribute it and/or
~ // modify it under the terms of the GNU Lesser General Public
~ // License as published by the Free Software Foundation; either
~ // version 2.1 of the License, or (at your option) any later version.
~ //
~ // This library is distributed in the hope that it will be useful,
~ // but WITHOUT ANY WARRANTY; without even the implied warranty of
~ // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
~ // Lesser General Public License for more details.
~ //
~ // You should have received a copy of the GNU Lesser General Public
~ // License along with this library; if not, write to the Free Software
~ // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301
~ //
~ // You can contact OPeNDAP, Inc. at PO Box 112, Saunderstown, RI. 02874-0112.
~ /////////////////////////////////////////////////////////////////////////////
-->
<html>
<title>Hyrax Installation</title>
<style type="text/css">
<!--
.style1 {font-family: "Courier New", Courier, mono}
-->
</style>
<h1 align="center"><img src="doc/images/logo.png" width="206" height="93" align="absmiddle"></h1>
<h1 align="center">Hyrax Installation</h1>
<p align="center">
Updated for Hyrax version 1.14.x
</p>
<hr>
<p align="left">Note: For more verbose instructions, see <a href="http://docs.opendap.org/index.php/Hyrax">documentation</a>. </p>
<h2 align="left"><strong>First:</strong> </h2>
<blockquote>
<p>
<a href="http://docs.opendap.org/index.php/Hyrax_GitHub_Source_Build">Build and install the bes and it's submodules.</a> <br>
Launch the bes (you can use besctl to do that). <br>
Make sure there s a beslistener process runnning. <br>
</p>
</blockquote>
<h2><strong>Check out the OLFS:</strong> </h2>
<blockquote>
<p class="style1"> git clone https://github/opendap/olfs<br>
</p>
</blockquote>
<h2><strong>Build it:</strong> </h2>
<blockquote>
<p><span class="style1">ant server</span><br>
</p>
</blockquote>
<h2><strong>Install it:</strong> </h2>
<blockquote>
<p class="style1">rm -rf $CATALINA_HOME/webapps/opendap*<br>
cp build/dist/opendap.war $CATALINA_HOME/webapps</p>
</blockquote>
<h2><strong>Launch it:</strong> </h2>
<blockquote>
<p><span class="style1">$CATALINA_HOME/bin/startup.sh</span><br>
</p>
</blockquote>
<h2><strong>Configure it: </strong></h2>
<p>
<b>The OLFS configuration location has changed!</b><br/>
By default the OLFS will utilize it's bundled default configuration in
the directory <em>$CATALINA_HOME/webapps/opendap/WEB-INF/conf</em></p>
<p>
In order to localize your configuration so that your configuration changes are persistent you will need to do
one of the following:
<ul>
<li>For the user that will be running the OLFS (the Tomcat user), set the environment variable <em>OLFS_CONFIG_DIR</em>
to an existing directory to which the Tomcat user has both read and write privileges.</li>
<li>Create the directory <em>/etc/olfs</em> and set it's permissions/ownership so that the Tomcat user has both read and
write permission. </li>
</ul>
If both of these are done then priority is given to the environment variable.
</p>
<p>
Restart Tomcat: <br/>
<blockquote>
<p class="style1">$CATALINA_HOME/bin/shutdown.sh </p>
<p class="style1">$CATALINA_HOME/bin/startup.sh</p>
</blockquote>
When it starts the OLFS will check these locations and then install a copy of its default
configuration into the new spot.
Edit the configuration files as needed.
(If, for example, your beslistener is not running at <span class="style1">localhost:10022</span> then in the <em>olfs.xml</em>
file edit the <span class="style1"><BES></span> element adjust the values for <span class="style1"><host></span>
and <span class="style1"><port></span>)<br>
Once your edits are completed then:
<h2><strong>Relaunch it:</strong> </h2>
<blockquote>
<p class="style1">$CATALINA_HOME/bin/shutdown.sh </p>
<p class="style1">$CATALINA_HOME/bin/startup.sh</p>
</blockquote>
<p> </p>
<h2><em>Go cat. Go. </em></h2>
</html>