<p> Are you interested in translating the installation guide to your own language? The best way to proceed is to ask us on the <ahref="http://www.dokeos.com/forum/">Dokeos forum</a>
for the latest version – there may be updates to the guide since
this version was released – and send new translations off to the <ahref="mailto:translation@dokeos.com">translation@dokeos.com</a> email address. </p>
<h1>License</h1>
<ahref="license.html">Gnu General Public License</a>
Before upgrading we heavily recommend you do a full backup of the previous
<hr><h2><aname="3._Upgrade_from_a_previous_version_of"></a>3. Upgrade from a previous version of Dokeos</h2>Before upgrading we <b>heavily</b> recommend you do a full backup of the previous
Dokeos directories and databases. If you are unsure how to achieve this
please ask your hosting provider for advice.</p>
<p>Then proceed like installation up to the point of entering web
installation page. There, select the Upgrade from Dokeos 1.6.x to 1.8.3
button
<em></em></p>
<p><em></em><br>
<em>If you upgrade from a lower version of Dokeos (1.5.x)</em>,
you'll have to use the built-in upgrade facility, as described below.
</p>
<p>
3.1. Download the Dokeos 1.6.3 install package (.zip for Windows users or .tar.gz for all others) from the <ahref="http://www.dokeos.com/download.php">Dokeos download page</a>.
please ask your hosting provider for advice.<br><p>
</p>
<h3>3.1 Upgrading from Dokeos 1.8.x</h3>
<em>If you upgrade from Dokeos 1.8.x</em> :
<ul><li> check that you haven't left any customised stylesheet or image*</li><li> download the Dokeos 1.8.4 install package from the <ahref="http://www.dokeos.com/download.php">Dokeos download page</a></li><li> unzip the new files of Dokeos 1.8.4 over the files of the older version</li><li> point your browser on your portal URL + main/install/</li><li> choose your language and click <spanstyle="font-style: italic;">Upgrade from 1.8.x</span></li></ul>
<br>
<fontsize="-1">* Styles and images are located in the main/css or main/img
directories. You can still recover them from your backup if you have made it.
Any modified style or image that uses the default style/image name will be
overwritten by the next step. To avoid loosing your customisations, always
ensure you copy the styles/images under a new name and use and modify the
copy, not the original. The original will always be overwritten by newer
versions.</font>
<p>
3.2. Unzip or untar the downloaded install package.
Most current operating systems
can do this with a built-in graphical application, if this doesn't work
you can open a commandline, go to the download directory and type
tar -zxvf dokeos-1.6.3.tar.gz
</p>
<br>
<p>
3.3. Move the Dokeos directory to a different path from the previous version
</p>
</p><h3>3.2 Upgrading from Dokeos 1.6.x</h3>
<em>If you upgrade from a lower version of Dokeos (1.6.x)</em>, the first
and most important thing to do is to *move* your current directory to another
place.<br> An easy way to do that is to create a subdirectory called
"old_version" in your current Dokeos directory and move everything in
there using a simple copy command (i.e. under Linux: mkdir old_version;
mv * old_verion/)<br><br>The complete process is as follow:
<ul><li> move the current Dokeos directory contents to a subdirectory called
<em>old_version</em></li><li> download the Dokeos 1.8.4 install package from the
<ahref="http://www.dokeos.com/download.php">Dokeos download page</a></li><li> unzip the new files of Dokeos 1.8.4 in the main Dokeos directory. The
new directory <em>main</em> should be located directly inside your
Dokeos root folder</li><li> point your browser on your portal URL</li><li> choose your language and click <spanstyle="font-style: italic;">Upgrade from 1.6.x</span> and confirm the
current directory of the old version</li></ul>
<br>
<em> NOTE: </em> The upgrade from 1.6.x to 1.8.x implies a revision of
the customised graphics and styles. The new version uses a complete new
set of icons and styles, which means the ones from version 1.6 cannot be
simply reused. The good news is the version 1.8.x allows you to create
your own style in a separate css folder, that you can then reuse through
all the 1.8.x versions
<br>
<p></p>
<p>
<b>WARNING:</b><br>
Do not delete the previous Dokeos installation directory before installing
the new one. When the update is successfully finished, you can remove
the old path.
</p>
<p>
<b>TIP:</b><br>
If you want Dokeos 1.6.3 to be installed in the same directory as
the previous version :
</p>
<ul>
<li>move the old directory to a new location (e.g. move dokeos/ to dokeos_old/)</li>
<li>uncompress Dokeos 1.6.3 to the old version directory (e.g. uncompress Dokeos 1.6.3 to dokeos/)</li>
<li>go to next step</li>
</ul>
<p></p>
<p>
3.4. The following files need to be readable and writeable for everyone:
Windows locally, with e.g easyphp or another combination package, open:
http://localhost/dokeos/index.php
</p>
<p>
3.7. Click on the install button, then click on "Update from Dokeos 1.5 | 1.5.4 | 1.5.5" and follow the instructions.
</p>
<p>
3.8. <i>This part is optional!</i><br>
Since after version 1.5.5, the following tables in the dokeos_main database
can be removed when upgrading from a 1.5.5 version or lower, provided that
you don't use them for a customisation of your Dokeos system:
</p>
<ul>
<li>`todo`</li>
<li>`pma_bookmark`</li>
<li>`pma_column_comments`</li>
<li>`pma_pdf_pages`</li>
<li>`pma_relation`</li>
<li>`pma_table_coords`</li>
<li>`pma_table_info`</li>
</ul>
These tables can be removed by connecting to the database as the Dokeos user
and executing this query:
DROP TABLE dokeos_main.my_table;
where dokeos_main is the main dokeos database name and
my_table is each of the preceding tables (repeat query for each)
<br>
</p><h3>3.4 Quick-upgrade from 1.6.x guide for Linux</h3>
The following quick-upgrade guide assumes that:
<ul><li>the Dokeos database username (for MySQL) is "dokeos_db_user" and your login is "dokeos_user"</li><li>the Dokeos installation is currently in /var/www/dokeos/ and it has 777 permissions</li><li>your portal's URL is http://www.portalurl.com/</li></ul>
<br>
A clean-up of the useless fields has also influenced some code:
The main_db.cours.cours_id has been removed, as all references to
that field throughout the official Dokeos code. The course code
(literal) is used instead. Please update your custom code if any.
Under the same circumstances as tables removal, the following fields
can be removed if not used by your code, using a query similar to:
ALTER TABLE database.table drop column abc
where database is the database name (dokeos_main? or code of a course)
table is the table name (cours?)
abc is the name of the field to drop
You can thus drop the following fields:
<ul>
<li>`_dokeos_main_`.`cours`.`versionDb`</li>
<li>`_dokeos_main_`.`cours`.`versionClaro`</li>
<li>`_dokeos_main_`.`cours`.`cahier_charges`</li>
<li>`_dokeos_main_`.`faculte`.`bc`
<br>
<i># the table `faculte` has been renamed to `course_category` since 1.6</i></li>
<li>`_cours_`.`announcement`.`code_cours`</li>
<li>`_cours_`.`course_description`.`upDate`</li>
</ul>
<p></p>
Then:
<ul><li>Direct your browser to http://www.portalurl.com/main/install/</li><li>Proceed with the installation</li><li>Review the directories permissions</li></ul>
Oogie converts your presentations coming from Ms-Office and OpenOffice into SCORM standardized e-courses or <spanstyle="font-style: italic;">learning paths</span>.
This feature needs OpenOffice to convert the slides and RED5 (optional)
@ -932,7 +745,7 @@ audio-recorder.<br>
<br>
<h3>8.1. PowerPoint / Impress conversion </h3>
<h3>7.1. PowerPoint / Impress conversion </h3>
<ul>
@ -1078,11 +891,11 @@ then OpenOffice is listening to Dokeos. </li>
<spanstyle="font-weight: bold;">NOTE</span> : during the conversion,
you should see a progress bar with a percentage. If you only see a
default animated GIF progress bar without percentage, you may want to
install the PECL library for PHP. <br>
install the PECL library for PHP. <br><br><spanstyle="font-weight: bold;">NOTE</span> : On Linux servers, you may want to do a <spanstyle="font-weight: bold;">$ sudo apt-get install msttcorefonts</span> so as to install Microsoft fonts. This will give PowerPoint conversion a better rendering. <br>
<br>
<h3>8.2. Audio recorder</h3>
<spanstyle="font-weight: bold;"><br></span><h3>7.2. Audio-recorder</h3>See below : Videoconferencing<br><br><hrstyle="width: 100%; height: 2px;"><h2><aname="8._Videoconferencing_and_audio-recorder"></a>8. Videoconferencing and audio-recorder</h2>We will now install and configure RED5 Open Source Flash server § the Dokeos RED5 webapplication. These will provide both <br><ul><li>Videoconferencing and</li><li>Audio recorder for Oogie</li></ul>
Oogie allows you to convert slides but also <br>
@ -1094,11 +907,12 @@ Oogie allows you to convert slides but also <br>
<li>add audio on top of the slides thanks to the online audio recorder</li>
<li>Unzip it and copy it into the <spanstyle="font-style: italic;">webapps</span> directory of your RED5 installation. Windows : you can use <ahref="http://www.7-zip.org/">7-ZIP</a>
to untar. Target directory can be C:/Program Files/Red5/webapps/ .
Linux with Nautilus or through a shell : cp dokeos-red5APP-1.8/*
/usr/lib/red5/webapps</li>
<li>Edit the RED5 settings to fit with your firewall requirements in terms of open ports if there is a limitation. </li><li>Configure Red5.</li><ul><li>Edit /usr/lib/red5/conf/red5.properties</li><li>Edit /usr/lib/red5/conf/realm.properties and change the default administrator password.</li></ul></ul><h4>More informations on RED5</h4>Please take a look on this page : <ahref="http://www.dokeos.com/wiki/index.php/Installing_videoconference">http://www.dokeos.com/wiki/index.php/Installing_videoconference</a><br><br><h4>Configuration of your dokeos Videoconference plugin</h4>The
configuration of the VideoServing is done via the admin pages of Dokeos
configuration in Dokeos platform admin, Configure the services,
Configure Visio-conference<br>This contains the URL to the video
conferencing application. You probably need to add something before
these paths if Dokeos is not installed into the root of your webserver.<br>url:/main/webrooms/videoconference.html and <br> /main/webrooms/videoconference2.html<br><br><h4>Connect your Dokeos installation to RED5</h4>You
should tell Dokeos the configuration of you red5 server. This is done
using the administration page of Dokeos. In the first field below the
two url, set the public ip of your red5 server. The second field <br>will
contain the value of « rtmp.port » from you red5
configuration and the last field will contains « rtmpt.port »
Eric Marguin
17 years ago