| 1 |
4080
|
daigle
|
<!--
|
| 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: Chad Berkley
|
| 7 |
|
|
*
|
| 8 |
|
|
* '$Author$'
|
| 9 |
|
|
* '$Date$'
|
| 10 |
|
|
* '$Revision$'
|
| 11 |
|
|
*
|
| 12 |
|
|
*
|
| 13 |
|
|
-->
|
| 14 |
|
|
|
| 15 |
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD html 4.0//EN">
|
| 16 |
|
|
<html>
|
| 17 |
|
|
|
| 18 |
|
|
<head>
|
| 19 |
|
|
<title>Metacat Configuration Instructions</title>
|
| 20 |
4558
|
daigle
|
<link rel="stylesheet" type="text/css" href="./common.css">
|
| 21 |
4080
|
daigle
|
<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 Configuration</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 |
4558
|
daigle
|
<div class="header1">Table of Contents</div>
|
| 45 |
|
|
<div class="toc">
|
| 46 |
|
|
<div class="toc1"><a href="#Overview">Overview</a></div>
|
| 47 |
|
|
<div class="toc2"><a href="#MetacatConfiguration">Metacat Configuration</a></div>
|
| 48 |
|
|
<div class="toc2"><a href="#ConfigurationRules">Configuration Rules</a></div>
|
| 49 |
4597
|
daigle
|
<div class="toc1"><a href="#authConfig">Authentication Configuration</a></div>
|
| 50 |
|
|
<div class="toc2"><a href="#AuthOverview">Authentication Overview</a></div>
|
| 51 |
|
|
<div class="toc2"><a href="#GetToAuthConfig">Getting to the Authentication Configuration</a></div>
|
| 52 |
|
|
<div class="toc2"><a href="#ConfigAuthNoAuth">Changing Authentication Configuration Without Authentication</a></div>
|
| 53 |
4558
|
daigle
|
<div class="toc1"><a href="#AdminLogin">Admin Log In</a></div>
|
| 54 |
4565
|
daigle
|
<div class="toc2"><a href="#AdminLoginOverview">Admin Log In</a></div>
|
| 55 |
|
|
<div class="toc2"><a href="#LoggingIn">Logging In</a></div>
|
| 56 |
4558
|
daigle
|
<div class="toc1"><a href="#MainConfig">Main Configuration Page</a></div>
|
| 57 |
4565
|
daigle
|
<div class="toc2"><a href="#MainConfigOverview">Main Configuration Overview</a></div>
|
| 58 |
|
|
<div class="toc1"><a href="#GlobalConfig">Global Properties Configuration</a></div>
|
| 59 |
|
|
<div class="toc2"><a href="#GlobalConfigOverview">Global Properties Overview</a></div>
|
| 60 |
|
|
<div class="toc2"><a href="#AutoDetection">Property Auto-Detection</a></div>
|
| 61 |
|
|
<div class="toc2"><a href="#GlobalConfigBackup">Global Property Backup</a></div>
|
| 62 |
|
|
<div class="toc1"><a href="#SkinsConfig">Skins Configuration</a></div>
|
| 63 |
|
|
<div class="toc2"><a href="#SkinsConfigOverview">Skins Overview</a></div>
|
| 64 |
|
|
<div class="toc2"><a href="#ChoosingDefaultSkin">Choosing a Default Skin</a></div>
|
| 65 |
|
|
<div class="toc2"><a href="#ConfigOnlineRegistry">Configuring Online Registry</a></div>
|
| 66 |
4558
|
daigle
|
<div class="toc1"><a href="#DatabaseConfig">Database Configuration</a></div>
|
| 67 |
4565
|
daigle
|
<div class="toc2"><a href="#DatabaseConfigOverview">Database Configuration Overview</a></div>
|
| 68 |
|
|
<div class="toc2"><a href="#DatabaseNewInstall">New Database Installation</a></div>
|
| 69 |
|
|
<div class="toc2"><a href="#DatabaseUpgrade">Database Upgrade</a></div>
|
| 70 |
4558
|
daigle
|
<div class="toc1"><a href="#GeoserverConfig">Geoserver Configuration</a></div>
|
| 71 |
4565
|
daigle
|
<div class="toc2"><a href="#GeoserverUpdatePassword">Geoserver Password Update</a></div>
|
| 72 |
|
|
<div class="toc2"><a href="#GeoserverManualUpdate">Geoserver Manual Update</a></div>
|
| 73 |
|
|
<div class="toc1"><a href="#CompleteConfig">Complete the Metacat Configuration</a></div>
|
| 74 |
4558
|
daigle
|
</div>
|
| 75 |
4080
|
daigle
|
|
| 76 |
4558
|
daigle
|
<a name="Overview"></a><div class="header1">Overview</div>
|
| 77 |
|
|
<a name="MetacatConfiguration"></a><div class="header2">Metacat Configuration</div>
|
| 78 |
|
|
<p>As of version 1.9.0, Metacat configuration is done internally by the application. When
|
| 79 |
|
|
Metacat (Tomcat) is started, it will check to see if it is configured. If not, you will be
|
| 80 |
|
|
automatically sent to the configuration pages. </p>
|
| 81 |
4080
|
daigle
|
|
| 82 |
4558
|
daigle
|
<p>If the installation is new, or the previous version is before 1.9.0, you will
|
| 83 |
|
|
need to pay close attention to the configuration values. If you have upgraded
|
| 84 |
|
|
Metacat, and the previous version is 1.9.0 or later, Metacat will pull existing
|
| 85 |
|
|
values from a backup location. You should still verify that the values are
|
| 86 |
|
|
correct.</p>
|
| 87 |
|
|
|
| 88 |
|
|
<p>Get to Metacat on your server by entering into the browser:</p>
|
| 89 |
|
|
<div class="code">http://<your_context_url></div>
|
| 90 |
|
|
<p>Where <your_context_url> is the url where Metacat will be served followed
|
| 91 |
|
|
by the name of the war file(application context) that you installed. For instance,
|
| 92 |
|
|
the KNB production Metacat url is:</p>
|
| 93 |
|
|
<div class="code">http://knb.ecoinformatics.org/knb</div>
|
| 94 |
|
|
|
| 95 |
|
|
<p>You can always go to the configuration screen from within Metacat by typing:
|
| 96 |
|
|
<div class="code"><your_context_url>/admin</div>
|
| 97 |
|
|
|
| 98 |
|
|
<a name="ConfigurationRules"></a><div class="header2">Configuration Rules</div>
|
| 99 |
|
|
<p>The system will follow these rules in order to determine the order
|
| 100 |
|
|
that the configuration will occur:</p>
|
| 101 |
|
|
|
| 102 |
4080
|
daigle
|
<ul>
|
| 103 |
|
|
<li>
|
| 104 |
4715
|
daigle
|
Always prompt the user for the backup directories with the
|
| 105 |
|
|
<a HREF="#BackupConfig">Backup Configuration Section</a>.
|
| 106 |
|
|
You will need to have backup directories configured in order
|
| 107 |
|
|
to continue with configuration.
|
| 108 |
|
|
</li>
|
| 109 |
|
|
<li>
|
| 110 |
4597
|
daigle
|
Is Authentication Configured? If not, show
|
| 111 |
4715
|
daigle
|
<a HREF="#AuthConfig">Authentication Configuration Section</a>.
|
| 112 |
4597
|
daigle
|
You will need to have authorizaiton configured in order to define administrative accounts
|
| 113 |
|
|
and authenticate as one of these users.
|
| 114 |
4080
|
daigle
|
</li>
|
| 115 |
|
|
<li>
|
| 116 |
|
|
Are you logged in as an administrative user? If not, show
|
| 117 |
4715
|
daigle
|
<a HREF="#AdminLogin">Administrator Login Page</a>.
|
| 118 |
4080
|
daigle
|
You can only configure Metacat as an administrator.
|
| 119 |
|
|
</li>
|
| 120 |
|
|
<li>
|
| 121 |
4558
|
daigle
|
Are main properties, skins or database unconfigured? If so, show
|
| 122 |
4715
|
daigle
|
<a HREF="#MainConfig">Main Configuration Page</a>
|
| 123 |
4558
|
daigle
|
Note that you will not be able to select the database configuration utility
|
| 124 |
|
|
until main properties have been configured.
|
| 125 |
|
|
</li>
|
| 126 |
4080
|
daigle
|
<li>
|
| 127 |
4558
|
daigle
|
Are all sections configured? If so, show
|
| 128 |
4715
|
daigle
|
<a HREF="#MainConfig">Main Configuration Page</a> which
|
| 129 |
4558
|
daigle
|
include instructions for going to Metacat server (or restarting Metacat if you
|
| 130 |
|
|
are reconfiguring a running server).
|
| 131 |
4080
|
daigle
|
</li>
|
| 132 |
|
|
</ul>
|
| 133 |
|
|
|
| 134 |
4565
|
daigle
|
<p> See the following sections for descriptions of how each of these work. For more
|
| 135 |
|
|
information on each field, click on the blue question mark icon to the right.</p>
|
| 136 |
4080
|
daigle
|
|
| 137 |
4715
|
daigle
|
<a name="BackupConfig"></a><div class="header1">Backup Configuration</div>
|
| 138 |
|
|
<a name="BackupOverview"></a><div class="header2">Backup Overview</div>
|
| 139 |
|
|
<p>Metacat backs up all configured values to a directory outside the application
|
| 140 |
|
|
installation directories. This is so that we can preserve the configuration even
|
| 141 |
|
|
after you upgrade Metacat (and the application directories get removed).</p>
|
| 142 |
|
|
|
| 143 |
|
|
<p>Since a new installation/upgrade won't know where this external directory is, it will
|
| 144 |
|
|
go through a discovery algorithm to give a best guess and pre-populate this value on the
|
| 145 |
|
|
Backup Directory Configuration screen (see fig 1). The algorithm is:
|
| 146 |
|
|
|
| 147 |
|
|
<ul>
|
| 148 |
|
|
<li>Look for a saved backup location file in the user home dir - Is there a file named
|
| 149 |
|
|
<user_home>/.metacat/backup-location for the user that started tomcat? if so, does
|
| 150 |
|
|
it contain a single line which is a readable directory? This directory was the backup
|
| 151 |
|
|
directory used during a previous install. Return that directory.</li>
|
| 152 |
|
|
<li>Look for an existing hidden (.metacat) directory in a default system directory. Get
|
| 153 |
|
|
the default base directory for the OS. (See application.windowsBackupBaseDir and
|
| 154 |
|
|
application.linuxBackupBaseDir in metacat.properties.) If a directory called
|
| 155 |
|
|
<base_dir>/metacat/.metacat exists, return <base_dir>/metacat.</li>
|
| 156 |
|
|
<li> Look for an existing hidden (.metacat) directory in the user directory. If a directory
|
| 157 |
|
|
called <user_home>/.metacat exists for the user that started tomcat, return <user_home>.</li>
|
| 158 |
|
|
<li> Is the <base_dir> writable by the user that started tomcat? If so, return <base_dir></li>
|
| 159 |
|
|
<li> Does the <user_home> exist? If so, return <user_home></li>
|
| 160 |
|
|
<li> Otherwise, return null </li>
|
| 161 |
|
|
</ul>
|
| 162 |
|
|
<img class="screenshot" src="./images/backup-config.png"/>
|
| 163 |
|
|
<div class="fig-text"> fig 1 </div>
|
| 164 |
|
|
|
| 165 |
|
|
<a name="ConfigBackup"></a><div class="header2">Configure Backup</div>
|
| 166 |
|
|
<p>If the pre-populated value is incorrect, you should change it to the correct
|
| 167 |
|
|
directory</p>
|
| 168 |
|
|
|
| 169 |
4597
|
daigle
|
<a name="AuthConfig"></a><div class="header1">Authentication Configuration</div>
|
| 170 |
4715
|
daigle
|
<a name="AuthOverview"></a><div class="header2">Authentication Overview</div>
|
| 171 |
4597
|
daigle
|
<p>Metacat uses LDAP as it's primary authentication mechanism, but you can define
|
| 172 |
|
|
your own mechanism by creating a java class that implements
|
| 173 |
|
|
AuthInterface. The configuration values needed are Authentication Class, Authentication URL,
|
| 174 |
|
|
Authentication Secure URL and Metacat Administrators. You need
|
| 175 |
4715
|
daigle
|
to verify that the the Authentication URL and Authentication Secure URL are correct (fig 2).
|
| 176 |
4597
|
daigle
|
<span class="emphasis">You need to make sure that your user
|
| 177 |
|
|
account is entered into the Metacat Administrators field. You will not be allowed
|
| 178 |
4558
|
daigle
|
to continue with configuration if this is missing.</span>
|
| 179 |
|
|
|
| 180 |
4597
|
daigle
|
<img class="screenshot" src="./images/auth-config.png"/>
|
| 181 |
4715
|
daigle
|
<div class="fig-text"> fig 2 </div>
|
| 182 |
4558
|
daigle
|
|
| 183 |
4597
|
daigle
|
<a name="GetToAdminConfig"></a><div class="header2">Getting to the Authentication Configuration</div>
|
| 184 |
|
|
<p>You will automatically be sent to the Authentication Configuration page if this is a new
|
| 185 |
4558
|
daigle
|
installation or upgrade.</p>
|
| 186 |
|
|
|
| 187 |
4597
|
daigle
|
<p>You can also get to the Administrative configuration from a running Metacat by typing:</p>
|
| 188 |
4558
|
daigle
|
<div class="code"><your_context_url>/admin</div>
|
| 189 |
|
|
<p>You will be required to log in as an administrator and restart Metacat once you
|
| 190 |
|
|
make changes.</p>
|
| 191 |
|
|
|
| 192 |
4597
|
daigle
|
<a name="ConfigAuthNoAuth"></a><div class="header2">Changing Authentication Configuration Without Authentication</div>
|
| 193 |
4558
|
daigle
|
<p>There is one exception to the log in rule. That is when you need to change or add
|
| 194 |
4597
|
daigle
|
authentication information, but you can't authenticate using the existing setup. For example:</p>
|
| 195 |
4558
|
daigle
|
|
| 196 |
|
|
<ul>
|
| 197 |
|
|
<li>The existing Metacat administrator is no longer available</li>
|
| 198 |
|
|
<li>You forgot the administrator password.</li>
|
| 199 |
4597
|
daigle
|
<li>The configured authentication urls are unavailable and you need to configure new ones.</li>
|
| 200 |
4558
|
daigle
|
</ul>
|
| 201 |
|
|
|
| 202 |
|
|
<p>In this case, you will need to edit the Metacat configuration file by hand and
|
| 203 |
|
|
make the changes. This insures that only a person who has access to the Metacat
|
| 204 |
|
|
server and the configuration files on that server will be able to change the
|
| 205 |
|
|
administrator accounts</p>
|
| 206 |
|
|
|
| 207 |
|
|
<p>Stop Tomcat and edit the Metacat properties file at:</p>
|
| 208 |
|
|
<div class="code"><webapp_dir>/<context_dir>/WEB-INF/metacat.properties</div>
|
| 209 |
|
|
<p>where <webapp_dir> is the place that Tomcat looks for applications and
|
| 210 |
|
|
<context_dir> is the name of the Metacat application (usually knb). Change the
|
| 211 |
|
|
following properties appropriately:</p>
|
| 212 |
|
|
|
| 213 |
|
|
<ul>
|
| 214 |
4579
|
daigle
|
<li>auth.administrators - a colon separated list of administrators</li>
|
| 215 |
|
|
<li>auth.url - the authenication server url</li>
|
| 216 |
|
|
<li>auth.surl - the authentication secure server url</li>
|
| 217 |
4558
|
daigle
|
</ul>
|
| 218 |
|
|
|
| 219 |
|
|
<p>Save the metacat.properties file and start Tomcat.</p>
|
| 220 |
|
|
|
| 221 |
4565
|
daigle
|
<a name="AdminLogin"></a><div class="header1">Admin Log In</div>
|
| 222 |
|
|
<a name="AdminLoginOverview"></a><div class="header2">Admin Log In Overview</div>
|
| 223 |
4597
|
daigle
|
<p>Once authentication has been configured, you will be required to login as an
|
| 224 |
4565
|
daigle
|
administrative user if you haven't already. You will be taken to
|
| 225 |
|
|
the administrator login screen (fig 2). You can also get to the login
|
| 226 |
|
|
screen by choosing the "log in as different user" link at the bottom of
|
| 227 |
|
|
any configuration screen.</p>
|
| 228 |
|
|
|
| 229 |
|
|
<img class="screenshot" src="./images/admin-login.png"/>
|
| 230 |
4715
|
daigle
|
<div class="fig-text"> fig 3 </div>
|
| 231 |
4565
|
daigle
|
|
| 232 |
|
|
<a name="LoggingIn"></a><div class="header2">Logging In</div>
|
| 233 |
|
|
<p>You need to log in with an account that was configured as an administrative
|
| 234 |
4597
|
daigle
|
user in the authentication configuration section. If you did not set up the correct user
|
| 235 |
4565
|
daigle
|
there, you will need to go through the
|
| 236 |
4597
|
daigle
|
<a href="#ConfigAuthNoAuth">Changing Authentication Configuration Without Authentication</a>
|
| 237 |
4565
|
daigle
|
instructions to set up the user.</p>
|
| 238 |
|
|
|
| 239 |
4597
|
daigle
|
<p>Enter your user name. This is one of the Metacat administrators that you
|
| 240 |
|
|
entered in authenticationuthentication configuration. Enter your password and
|
| 241 |
|
|
hit the "Login" button. You should successfully log in.</p>
|
| 242 |
4565
|
daigle
|
|
| 243 |
|
|
<a name="MainConfig"></a><div class="header1">Main Configuration Page</div>
|
| 244 |
|
|
<a name="MainConfigOverview"></a><div class="header2">Main Configuration Overview</div>
|
| 245 |
|
|
<p>The main configuration screen acts as a gateway into individual configuration
|
| 246 |
4715
|
daigle
|
sections (fig 4). You should see that the authentication is already configured.</p>
|
| 247 |
4565
|
daigle
|
|
| 248 |
|
|
<p>Each section is listed with a status to the left which can be one of:</p>
|
| 249 |
|
|
<ul>
|
| 250 |
|
|
<li><font color="red">[unconfigured]</font> - the section has yet to be configured</li>
|
| 251 |
|
|
<li><font color="green">[configured]</font> - the section has been configured</li>
|
| 252 |
|
|
<li>
|
| 253 |
|
|
<font color="green">[bypassed]</font> - this is currently only used for Geoserver
|
| 254 |
|
|
configuration. The administrator can choose not to configure the Geoserver user/password.
|
| 255 |
|
|
In essence, the bypass status acts like the configured status.
|
| 256 |
|
|
</li>
|
| 257 |
|
|
</ul>
|
| 258 |
|
|
|
| 259 |
|
|
<p>To the right of each section is an option which can be one of:
|
| 260 |
|
|
<ul>
|
| 261 |
|
|
<li>Configure Now - click on this link to configure that section</li>
|
| 262 |
|
|
<li>Reconfigure Now - the section was already configured, but you can choose to reconfigure it.</li>
|
| 263 |
|
|
<li>
|
| 264 |
|
|
Configure Global Properties First - this section has a dependency on the global
|
| 265 |
|
|
properties section. Once global properties is configured, the option to configure
|
| 266 |
|
|
this section should become available.
|
| 267 |
|
|
</li>
|
| 268 |
|
|
<li>Version: X.X.X - this is used for the Database Installation/Upgrade section. The system
|
| 269 |
|
|
detects the database schema version. If that version is the same as the application version,
|
| 270 |
|
|
that version will be displayed (i.e. 1.9.0) and no further database configuration is
|
| 271 |
|
|
required.
|
| 272 |
|
|
</li>
|
| 273 |
|
|
</ul>
|
| 274 |
|
|
|
| 275 |
|
|
<p>All sections must be in a configured or bypassed state in order to run Metacat.</p>
|
| 276 |
|
|
|
| 277 |
|
|
<img class="screenshot" src="./images/main-config.png"/>
|
| 278 |
4715
|
daigle
|
<div class="fig-text"> fig 4 </div>
|
| 279 |
4565
|
daigle
|
|
| 280 |
|
|
<a name="GlobalConfig"></a><div class="header1">Global Properties Configuration</div>
|
| 281 |
|
|
<a name="GlobalConfigOverview"></a><div class="header2">Global Properties Overview</div>
|
| 282 |
|
|
<p>Metacat global properties are the bulk of the core properties needed to run Metacat
|
| 283 |
4715
|
daigle
|
(fig 5). For detailed instructions on setting these properties, refer to the blue
|
| 284 |
4565
|
daigle
|
question mark icon to the right of each property. Be sure that each of these are set
|
| 285 |
|
|
appropriately.</p>
|
| 286 |
|
|
|
| 287 |
|
|
<img class="screenshot" src="./images/global-config.png"/>
|
| 288 |
4715
|
daigle
|
<div class="fig-text"> fig 5 </div>
|
| 289 |
4565
|
daigle
|
|
| 290 |
|
|
<a name="AutoDetection"></a><div class="header2">Property Auto-Detection</div>
|
| 291 |
|
|
<p>The first time you install Metacat, the system will attempt to auto-detect
|
| 292 |
|
|
some values. These are:</p>
|
| 293 |
|
|
|
| 294 |
|
|
<ul>
|
| 295 |
|
|
<li>Metacat Context - Name of the context under which Metacat will run. This is the name
|
| 296 |
|
|
of the Metacat war file that was deployed (minus the .war extension).</li>
|
| 297 |
|
|
<li>Server Name - The DNS name of the server where Metacat will be available, not including
|
| 298 |
|
|
port numbers or the http:// header.</li>
|
| 299 |
|
|
<li>HTTP Port - The non-secure port where Metacat will be available. </li>
|
| 300 |
|
|
<li>HTTP SSL Port - The secure port where Metacat will be available.</li>
|
| 301 |
|
|
<li>Deploy Location - The directory where the application is deployed.</li>
|
| 302 |
|
|
</ul>
|
| 303 |
|
|
|
| 304 |
|
|
<p>You should be extra careful that these were detected correctly.</p>
|
| 305 |
|
|
|
| 306 |
|
|
<a name="GlobalConfigBackup"></a><div class="header2">Global Property Backup</div>
|
| 307 |
|
|
<p>When you save global properties, they are saved in a backup file that is
|
| 308 |
4660
|
daigle
|
located in the following directory on linux:</p>
|
| 309 |
4565
|
daigle
|
<div class="code">/var/metacat/.metacat</div>
|
| 310 |
4660
|
daigle
|
and on windows:
|
| 311 |
|
|
<div class="code">C:\Program Files\metacat\.metacat</div>
|
| 312 |
4565
|
daigle
|
<p>When you update Metacat, the system will look for these backed up properties
|
| 313 |
|
|
so you won't have to re-enter all the information from previous installs.</p>
|
| 314 |
|
|
|
| 315 |
|
|
<a name="SkinsConfig"></a><div class="header1">Skins Configuration</div>
|
| 316 |
|
|
<a name="SkinsConfigOverview"></a><div class="header2">Skins Overview</div>
|
| 317 |
|
|
<p>Metacat allows for a customized look and feel for the Metacat front end and for the
|
| 318 |
|
|
online data registry services. There are two major functions provided by the
|
| 319 |
|
|
skins configuration. The first is to choose which skin will be the default. The
|
| 320 |
|
|
second will be to configure the look and feel of the online data registry pages. For
|
| 321 |
|
|
more information on the online data registry option, refer to the
|
| 322 |
|
|
<a href="./registry_installation.html">Metacat Registry Installation</a> documentation.</p>
|
| 323 |
|
|
|
| 324 |
|
|
<p>Note that if you are not using the online registry, and you don't have a custom skin,
|
| 325 |
|
|
you can just save the default skins configuration and move on to the next configuration
|
| 326 |
|
|
section.</p>
|
| 327 |
|
|
|
| 328 |
|
|
<a name="ChoosingDefaultSkin"></a><div class="header2">Choosing a Default Skin</div>
|
| 329 |
4715
|
daigle
|
<p>There are several skins available to choose from in Metacat (fig 6). If you have a
|
| 330 |
4565
|
daigle
|
skin that has been developed specifically for your instance of Metacat, you should
|
| 331 |
|
|
select the checkbox next to that skin. When you do, the form will open up with
|
| 332 |
|
|
several options for that skin (fig 6). choose the 'Make "skin_name" default" radio selection.
|
| 333 |
|
|
You should see "(default)" appear next to that skin name. Save the configuration
|
| 334 |
|
|
and that skin will be the one that appears when users visit your Metacat site. Note
|
| 335 |
|
|
that if you do not have a custom skin, you should leave your skin as the "default" skin.</p>
|
| 336 |
|
|
|
| 337 |
|
|
<img class="screenshot" src="./images/skins-config.png"/>
|
| 338 |
4715
|
daigle
|
<div class="fig-text"> fig 6 </div>
|
| 339 |
4565
|
daigle
|
|
| 340 |
|
|
<a name="ConfigOnlineRegistry"></a><div class="header2">Configuring Online Registry</div>
|
| 341 |
|
|
<p>The online registry code provides a web interface for entering data into Metacat. The
|
| 342 |
|
|
screens are somewhat configurable as far as which fields show up and which are required.
|
| 343 |
|
|
You should select each for which you want to activate the registry and then select the
|
| 344 |
|
|
appropriate fields for that skin.</p>
|
| 345 |
|
|
|
| 346 |
|
|
<img class="screenshot" src="./images/skins-config-2.png"/>
|
| 347 |
4715
|
daigle
|
<div class="fig-text"> fig 7 </div>
|
| 348 |
4565
|
daigle
|
|
| 349 |
|
|
<a name="DatabaseConfig"></a><div class="header1">Database Configuration</div>
|
| 350 |
4570
|
daigle
|
<a name="DatabaseConfigOverview"></a><div class="header2">Database Configuration Overview</div>
|
| 351 |
4565
|
daigle
|
<p>Metacat will detect the schema version of your database, and upgrade it if necessary. Once the
|
| 352 |
|
|
global Metacat properties have been configured, the Database Installation/Upgrade link
|
| 353 |
4715
|
daigle
|
will become active on the main Metacat configuration page (see fig 4).</p>
|
| 354 |
4565
|
daigle
|
|
| 355 |
|
|
<a name="DatabaseNewInstall"></a><div class="header2">New Database Installation</div>
|
| 356 |
|
|
<p>If this is a installation of Metacat, the database install/upgrade utility will
|
| 357 |
4715
|
daigle
|
inform you of this (fig 8). It will list the sql scripts that will get run in order
|
| 358 |
4565
|
daigle
|
to create a database schema for the version of Metacat that you are installing. If
|
| 359 |
|
|
there is any question as to whether the database is new, you should choose to cancel.
|
| 360 |
|
|
When you choose to continue, the server will run the scripts you saw earlier.</p>
|
| 361 |
|
|
<img class="screenshot" src="./images/database-config.png"/>
|
| 362 |
4715
|
daigle
|
<div class="fig-text"> fig 8 </div>
|
| 363 |
4565
|
daigle
|
|
| 364 |
|
|
<a name="DatabaseUpgrade"></a><div class="header2">Database Upgrade</div>
|
| 365 |
|
|
<p>If this is an upgrade of Metacat, the database install/upgrade utility will
|
| 366 |
4715
|
daigle
|
inform you of the current version of the database (fig 9). It will list the sql scripts
|
| 367 |
4565
|
daigle
|
that will get run in order to update the database schema to the upgraded version of
|
| 368 |
|
|
Metacat. If there is any question as to whether the detected database schema version is
|
| 369 |
|
|
correct, you should choose to cancel. When you choose to continue, the server will run
|
| 370 |
|
|
the scripts you saw earlier.</p>
|
| 371 |
|
|
<img class="screenshot" src="./images/database-config-2.png"/>
|
| 372 |
4715
|
daigle
|
<div class="fig-text"> fig 9 </div>
|
| 373 |
4565
|
daigle
|
|
| 374 |
|
|
<a name="GeoserverConfig"></a><div class="header1">Geoserver Configuration</div>
|
| 375 |
|
|
<a name="GeoserverOverview"></a><div class="header2">Geoserver Configuration Overview</div>
|
| 376 |
|
|
<p>Metacat comes bundled with a Web Mapping Service called Geoserver which
|
| 377 |
|
|
converts spatial data into web-deliverable map images. For more information, see the
|
| 378 |
|
|
<a href="./spatial_option.html">Metacat Spatial Option documentation</a>. Geoserver
|
| 379 |
|
|
installs with a default admin username and password. You should change these so that
|
| 380 |
|
|
only local administrators can make changes to Geoserver.</p>
|
| 381 |
|
|
<a name="GeoserverUpdatePassword"></a><div class="header2">Geoserver Password Update</div>
|
| 382 |
|
|
<p>When you choose the Geoserver Configuration link on the main configuratio page, you
|
| 383 |
4715
|
daigle
|
will go to a page that will prompt you for a user name and password (fig 10). When you
|
| 384 |
4565
|
daigle
|
enter a user name and password, the metacat server will contact the embedded Geoserver
|
| 385 |
|
|
server and change the login credentails.</p>
|
| 386 |
|
|
<p>You also have the option of choosing "bypass". This will leave Geoserver configured
|
| 387 |
|
|
with the default user name and password. The main configuration screen will show the
|
| 388 |
|
|
bypassed status. The system will interpret the bypassed status the same as the configured
|
| 389 |
|
|
status.</p>
|
| 390 |
4715
|
daigle
|
|
| 391 |
4565
|
daigle
|
<img class="screenshot" src="./images/geoserver-config.png"/>
|
| 392 |
4715
|
daigle
|
<div class="fig-text"> fig 10 </div>
|
| 393 |
|
|
|
| 394 |
4565
|
daigle
|
<a name="GeoserverManualUpdate"></a><div class="header2">Geoserver Manual Update</div>
|
| 395 |
|
|
<p>You also have the option of changeing the Geoserver username and password by logging
|
| 396 |
|
|
in directly to the Geoserver. For more information on changing the credentials directly,
|
| 397 |
|
|
refer to the <a href="./geoserver-manual-configure.html">Geoserver Password Change documentation</a>.
|
| 398 |
|
|
Note that once you change the credentails manually, you will not be able to use the
|
| 399 |
|
|
Metacat admin tool to change it again (until a new Metacat Upgrade or installation).
|
| 400 |
|
|
<a name="CompleteConfig"></a><div class="header1">Complete the Metacat Configuration</div>
|
| 401 |
|
|
At this point, all the sections of the main configuration should be in a configured or
|
| 402 |
4715
|
daigle
|
bypassed state (fig 11). If you are configuring because of a Metacat install or upgrade,
|
| 403 |
4565
|
daigle
|
you will have the option to click on the "go to metacat" link and you should get taken
|
| 404 |
|
|
directly to the running version of Metacat. Note that this may take some time depending
|
| 405 |
|
|
on the amount of data in your database, since Metacat goes through an indexing process
|
| 406 |
|
|
at start-up time.</p>
|
| 407 |
|
|
|
| 408 |
|
|
<p>If you are reconfiguring an already running version of Metacat, you will not have the
|
| 409 |
|
|
option to go directly back to Metacat. You will need to restart the server (Tomcat).</p>
|
| 410 |
|
|
<img class="screenshot" src="./images/main-config-2.png"/>
|
| 411 |
4715
|
daigle
|
<div class="fig-text"> fig 11 </div>
|