forked from OPENDAP/olfs
-
Notifications
You must be signed in to change notification settings - Fork 0
/
install.html
121 lines (111 loc) · 4.93 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
114
115
116
117
118
119
120
121
<!--
~ /////////////////////////////////////////////////////////////////////////////
~ // 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>
<head><title>Hyrax Installation</title></head>
<body>
<style type="text/css" scoped="">
<!--
.style1 {font-family: "Courier New", Courier, mono}
-->
</style>
<img src="doc/images/logo.png" width="206" height="93" align="absmiddle" />
<h1>Hyrax Installation</h1>
<p>
Updated for Hyrax version 1.16.x
</p>
<hr>
<p align="left">Note: For more verbose instructions, see <a href="https://opendap.github.io/hyrax_guide/Master_Hyrax_Guide.html">The Hyrax Installation and Configuration Guide</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>
<li>Create the directory <em>/usr/share/olfs</em> and set it's permissions/ownership so that the Tomcat user has both read and
write permission.* </li>
</ul>
These will be prioritized in the order they appear here.
So if more than one of these has been done then the priority is given to the firest one found, searched in the above order.
<b>Note:</b><e>When running under SELinux (CentOS-7 for example) you will need to do some things to allow Tomcat to write to those directories.
Read about it in <a href="https://opendap.github.io/hyrax_guide/Master_Hyrax_Guide.html#OLFS-config">Section 2.7.1 of the Hyrax user Guide</a></e>
</p>
<p>
Now, 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>
</body>
</html>