https://kb.swivelsecure.com/w/index.php?title=Change_Configuration_Location&feed=atom&action=historyChange Configuration Location - Revision history2024-03-28T19:48:39ZRevision history for this page on the wikiMediaWiki 1.28.0https://kb.swivelsecure.com/w/index.php?title=Change_Configuration_Location&diff=1929&oldid=prevAdmin: 1 revision imported2017-05-11T12:52:08Z<p>1 revision imported</p>
<table class="diff diff-contentalign-left" data-mw="interface">
<tr style='vertical-align: top;' lang='en'>
<td colspan='1' style="background-color: white; color:black; text-align: center;">← Older revision</td>
<td colspan='1' style="background-color: white; color:black; text-align: center;">Revision as of 12:52, 11 May 2017</td>
</tr><tr><td colspan='2' style='text-align: center;' lang='en'><div class="mw-diff-empty">(No difference)</div>
</td></tr></table>Adminhttps://kb.swivelsecure.com/w/index.php?title=Change_Configuration_Location&diff=1928&oldid=prevRWithey: Created page with '{{Template:Default}} {{Template:How}} Category:Pinsafe = Overview = This document describes how to change the location of Swivel configuration files. = Prerequisites = * …'2015-08-18T09:57:52Z<p>Created page with '{{Template:Default}} {{Template:How}} <a href="/w/index.php/Category:Pinsafe" title="Category:Pinsafe">Category:Pinsafe</a> = Overview = This document describes how to change the location of Swivel configuration files. = Prerequisites = * …'</p>
<p><b>New page</b></p><div>{{Template:Default}}<br />
{{Template:How}}<br />
[[Category:Pinsafe]]<br />
<br />
= Overview =<br />
<br />
This document describes how to change the location of Swivel configuration files.<br />
<br />
= Prerequisites =<br />
<br />
* Software-only installation - it is not recommended that you change the location of the configuration files on an appliance.<br />
* Swivel software version 3.9.1 or later<br />
<br />
= How to Guide =<br />
<br />
== Check the Current Location ==<br />
<br />
Before you start moving the configuration, you need to check where Swivel has deployed the configuration initially. We are assuming here that Swivel has been initially deployed using default settings.<br />
<br />
Log into the Administration console and go to the status page (you will probably be shown this initially anyway).<br />
<br />
Look for the entry "Data Storage Root" and make a note of the location shown.<br />
<br />
== Move the Current Configuration ==<br />
<br />
Stop Tomcat.<br />
<br />
Go to the Data Storage Root location you noted earlier. Copy all folders and files from this location to the desired location.<br />
<br />
== Change the Setting for Swivel Home ==<br />
<br />
Go to the Tomcat home folder, then into webapps\pinsafe\WEB-INF<br />
<br />
Edit the file web.xml that you should find there.<br />
<br />
Search for "env-entry". You should find the following:<br />
<br />
<code><br />
<env-entry><br />
<description>If non empty value, will be the root for all the data - takes precedence over default and environment variable</description><br />
<env-entry-name>swivelHome</env-entry-name><br />
<env-entry-type>java.lang.String</env-entry-type><br />
<env-entry-value></env-entry-value><br />
</env-entry><br />
</code><br />
<br />
Insert the new folder containing the configuration files within <env-entry-value>, for example:<br />
<br />
<env-entry-value>E:\Swivel</env-entry-value><br />
<br />
You can now restart Tomcat<br />
<br />
= Testing =<br />
<br />
To demonstrate that this works, simply log into the administration console and check that Data Storage Root is showing your new location.<br />
<br />
= Known Issues =<br />
<br />
We have occasionally seen Swivel fail to start, showing a stack trace which includes a reference to MissingResourceException for "config". This is due to a configuration file not having been copied over correctly - the exact cause for this is not known. However, there is a simple workaround:<br />
<br />
Go to the Data Storage Root folder, and to the conf sub-folder within that. Look for a file called config.properties. It is likely that this file does not exist. In this case, simply create a new, empty text file called "config.properties", then restart Tomcat.<br />
<br />
= Troubleshooting =</div>RWithey