blob: 27f11cc54fc8ce4aea032380d87732fb1397c55a [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!--
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<properties>
<title>MSSQL Configuration</title>
<author email="solomax@apache.org">
Apache OpenMeetings Documentation Team
</author>
</properties>
<body>
<section name="MSSQL Configuration">
<subsection name="Before you start">
<ul>
<li>You need Openmeetings 2.2 or later to use MSSQL integration</li>
<li>Make sure that you have set utf8 as collation for the openmeetings database
before you start the installation process of OpenMeetings!
</li>
<li>
make sure MSSQL is listening on TCP/IP connections! and username/password
authentication is enabled for it
<br />
To verify if MSSQL connection is working: OpenMeetings will
automatically create all tables in the database and all tables
should have utf8 as encoding/collation!
</li>
<li>If you encounter issues, you can drop the db again and delete
the file $red5/webapps/openmeetings/conf/install.xml and then run
the web based installer again
</li>
</ul>
</subsection>
<subsection name="Steps todo">
<ul>
<li>
You need to download the JDBC driver from Microsoft
<a href="http://www.microsoft.com/en-us/download/details.aspx?displaylang=en&amp;id=11774" target="_BLANK"
rel="nofollow">http://www.microsoft.com/en-us/download/details.aspx?displaylang=en&amp;id=11774</a>
Unarchive appropriate file from it (sqljdbc.jar or sqljdbc4.jar) and place it into:
<tt>$red5/webapps/openmeetings/WEB-INF/lib/</tt>
</li>
<li>
Rename:
<br />
$red5/webapps/openmeetings/WEB-INF/classes/META-INF/mssql_persistence.xml
<br />
to
<br />
$red5/webapps/openmeetings/WEB-INF/classes/META-INF/persistence.xml
</li>
<li>
Prepare Database Settings - go to
openmeetings_version_no_xx/webapps/openmeetings/WEB-INF/classes/META-INF/persistence.xml
<br />
Alter config values in persistence.xml DB_HOST USER_NAME USER_PASS
with your values
</li>
<li>
Run red5-service and goto the web-based installer:
http://localhost:5080/openmeetings/install
</li>
</ul>
</subsection>
<subsection name="MSSQL Sample Configuration">
<p>
There is a sample configuration for MySQL that ships with
every release in:
<br />
/webapps/openmeetings/WEB-INF/classes/META-INF/mssql_persistence.xml
</p>
</subsection>
</section>
</body>
</document>