Eric Marguin
18 years ago
parent
9752335395
commit
4df27a6a01
@ -1,470 +0,0 @@ |
||||
<html> |
||||
<head> |
||||
<title>Dokeos 1.8 installation guide</title> |
||||
<link rel="stylesheet" href="../main/css/default/default.css" type="text/css" media="screen,projection" /> |
||||
<link rel="shortcut icon" href="../favicon.ico" type="image/x-icon" /> |
||||
</head> |
||||
<body> |
||||
<div id="header1"> |
||||
<h1>Dokeos 1.8 installation guide</h1> |
||||
</div> |
||||
<a href="index.html">Documentation</a> > English installation guide |
||||
<div id="outerframe"> |
||||
<div id="main"> |
||||
<p> Thank you for downloading Dokeos! |
||||
This text will guide you through the basics of installing Dokeos 1.8. |
||||
Please read this fully before proceeding with the installation. </p> |
||||
<p> The installation guide is also available in other languages, please see <a href="documentation/index.html">this overview page</a> for a list. The Dokeos website will notify when new translations are available. </p> |
||||
<p> This is only a short installation guide. We are writing a manual with more info on installation, but this was not ready at the time of writing. When ready, this manual will be accessible through the <a href="http://www.dokeos.com/documentation.php">Dokeos documentation page</a>. You can read the work in progress manual on our <a href="http://www.dokeos.com/wiki/index.php/Manual">web writing area</a>. We also maintain a list of <a href="http://www.dokeos.com/wiki/index.php/FAQ">Frequently Asked Questions (FAQ)</a>. </p> |
||||
<p> <b>Contents</b> |
||||
<ol> |
||||
<li><a href="#requirements">Requirements</a></li> |
||||
<li><a href="#install_new_version">Installing a new version of Dokeos</a></li> |
||||
<li><a href="#upgrade_previous_version">Upgrading from a previous version of Dokeos</a></li> |
||||
<li><a href="#troubleshooting">Troubleshooting</a></li> |
||||
<li><a href="#admin_section">Administration section</a></li> |
||||
<li><a href="#ldap">Ldap (optional)</a></li> |
||||
</ol> |
||||
</p> |
||||
<h2><a name="requirements">1. Requirements</a></h2> |
||||
<p>As from Dokeos 1.8 additional plugins can be enabled. Two of these plug-ins needs a set of prerequirements and additional installation of |
||||
software modules. The basic requirements have to be met by the core or basic Dokeos modules. Both additional plugins do need a jdk (java development |
||||
environment). The additional packages may be installed on an other computer as the DokeosServer.</p> |
||||
<ul> |
||||
<li><a href="#Basicreq">Basic requirements</a></li> |
||||
<li><a href="#Javareq">Java requirements (only needed when adding convertions or videoconferencing</a></li> |
||||
<li><a href="#OOConversion">Powerpoint and Presenter convertions to Learnpath</a></li> |
||||
<li><a href="#Videoconferencing">Videoconferencing</a></li> |
||||
</ul> |
||||
<h3><a name="Basicreq">1.1 Basic Requirements</a></h3> |
||||
<p>Dokeos is a web application which requires some other software to function:</p> |
||||
<ul> |
||||
<li>A web server - we recommend <strong>Apache</strong></li> |
||||
<li><strong>PHP</strong></li> |
||||
<li>The <strong>MySQL</strong> database server</li> |
||||
</ul> |
||||
<p> These software packages have to be installed on the computer where you will install Dokeos. <br/> |
||||
You can install all these software packages separately, which often gives the best results. However, beginning users who want to test Dokeos can use a <i>combination package</i> that installs all these software packages in one simple install. If you want to use a combination package, we recommend Wamp (Download at <a href="http://www.wampserver.com/en/index.php">the WAMP5 website</a>, you also need the <a href="http://www.wampserver.com/en/add-ons.php">PHP4 add-on</a>) or <a href="http://www.apachefriends.org/en/index.html">XAMP</a>. </p> |
||||
<h4>1.1.1. A web server</h4> |
||||
<p> The Apache web server is recommended, and Dokeos is configured to use some Apache security enhancements if possible. However, other web servers will work too. For best security results, you need to have the Apache module mod_rewrite activated. The mod_rewrite rules for Dokeos are read from a .htaccess file in the courses folder, so Apache needs to allow this (AllowOverride FileInfo in httpd.conf). <br/> |
||||
<br/> |
||||
<a href="http://httpd.apache.org/download.cgi">Download Apache web server</a><br/> |
||||
<a href="http://httpd.apache.org/docs-project/">Apache web server manual</a> </p> |
||||
<h4>1.1.2. PHP</h4> |
||||
<p> You need PHP version 5.2.x or later (5.x versions), configured with the following modules : mysql, zlib, preg, xml. PHP versions 5 or later are not supported by Dokes yet. |
||||
You need the ldap module too if you want to use ldap with Dokeos. |
||||
Most of the PHP5 compiled distributions are provided with these modules. |
||||
Anyway, their presence is checked by the Dokeos install script. <br/> |
||||
<br/> |
||||
<a href="http://www.php.net/downloads.php">Download PHP</a><br/> |
||||
<a href="http://www.php.net/docs.php">PHP manual</a> </p> |
||||
<p> Some users could meet problems if their PHP setting doesn't fit |
||||
these ones:</p> |
||||
<ul> |
||||
<li>short_open_tag = On</li> |
||||
<li>safe_mode = Off</li> |
||||
<li>magic_quotes_gpc = On</li> |
||||
<li>magic_quotes_runtime = Off</li> |
||||
</ul> |
||||
<p> Past Dokeos versions required register_globals to be set to On. This is |
||||
no longer necessary, this can be set to Off and Dokeos will work fine. </p> |
||||
<p><strong>BSD users:</strong> these php libraries have to be included during php installation:</p> |
||||
<ul> |
||||
<li>php-mysql The mysql shared extension for php</li> |
||||
<li>php-pcre The pcre shared extension for php</li> |
||||
<li>php-session The session shared extension for php</li> |
||||
<li>php-zlib The zlib shared extension for php</li> |
||||
<li>php-xml</li> |
||||
<li>(optional) php-ldap if you want to be able to use LDAP authentication</li> |
||||
</ul> |
||||
<h4>1.1.3. The MySQL database server</h4> |
||||
<p> You will need a login and password allowing to administrate |
||||
and create at least one database. By default, Dokeos will create a new |
||||
database for each course created. It means your host should allow you to |
||||
create and administrate several databases. You can also install DOkeos using only one database, in that case you have to select this option during the |
||||
installation. <br/> |
||||
<br/> |
||||
<a href="http://dev.mysql.com/downloads/">Download MySQL server</a><br/> |
||||
<a href="http://dev.mysql.com/doc/mysql/en/index.html">MySQL server manual</a> </p> |
||||
<p> <b>Note:</b><br/> |
||||
It seems the backticks characters (`) inserted inside most of |
||||
the Dokeos SQL queries since version 1.3 don't work with MySQL |
||||
versions before 3.23.6. </p> |
||||
<h4>1.1.4. Permissions</h4> |
||||
<p> Furthermore, Dokeos needs to have write access to specific directories. The best way to deal with these permission is to give the webserver user |
||||
read/ write access on the specified directories. The other directories can work with read access. The specific directories are <a href="#protections">listed in the installation section.</a> |
||||
or unzipped to. On a Windows machine locally, this |
||||
is not a problem. Remotely, you need to be allowed to CHMOD |
||||
through FTP, telnet or any means. </p> |
||||
|
||||
|
||||
<h3><a name="Javareq">1.2 Java Requirements</a></h3> |
||||
<p>Install a java jdk on the system where you will install the conversiontool and the videoconferencing modules. Depending on the system this |
||||
environment have to be installed</p> |
||||
<a href="http://www.java.com/getjava/">Download Java runtime environment and install</a></br> |
||||
|
||||
<h3><a name="OOConversion">1.3 Requirements for Powerpoint and Presenter imports</a></h3> |
||||
<p>For the basic conversion of a presentation to Dokeos on neede the installation of openoffice.org.<br/> |
||||
<br/> |
||||
<a href="http://download.openoffice.org/">Download openoffice.org and install</a></br> |
||||
</p> |
||||
<p>Once the latest version of OpenOffice.org is installed, edit the configuration file (Setup.xcu) and add the following property : |
||||
|
||||
<pre><prop oor:name="ooSetupConnectionURL"> |
||||
<value> |
||||
socket,host=localhost,port=2002;urp;StarOffice.ServiceManager |
||||
</value> |
||||
</prop> |
||||
</pre> |
||||
(ex on Debian /usr/lib/openoffice/share/registry/data/org/openoffice/Setup.xcu) |
||||
</p> |
||||
<p>For the basic convertion of a presentation to Dokeos one need to run the openoffice server in headless mode. On linux systems this is |
||||
done via the X framebuffer (xvfb package). When your server does not contain an x-window system, additional fonts and basic x-window libraries have to be installed for |
||||
not running into problems.</p> |
||||
<p> |
||||
If during the conversion sets one need additional recording of sound, then the installation of the |
||||
<a href="#Openlaszlo">Openlaszlo and tomcat modules</a>are needed. |
||||
</p> |
||||
<p> |
||||
The startup from the Openoffice server at startup from the computer van be done via the file oooserver.init. Additional description is found |
||||
on the Dokeos wiki<a href="http://www.dokeos.com/wiki/index.php/MakeOOOListening">http://www.dokeos.com/wiki/index.php/MakeOOOListening</a> |
||||
</p> |
||||
<p> |
||||
Configuration in dokeos platform admin, Configure the services, Configure PowerPoint2LearningPath |
||||
<ul> |
||||
<li>host:<b>localhost</b></li> |
||||
<li>Username:</li> |
||||
<li>Ftp password:</li> |
||||
<li>Path to LZX Files:</li> |
||||
When the openofficeserver runs on the same server as Dokeos. Host is localhost. Otherwise the remote parameters have to be entered. |
||||
When a recording of audio is needed then the path to the lzx files is needed. When the openlaszlo server is installed on an other |
||||
server the host has to be added otherwise.<b>/lps-latest/dokeos/videoconference/ppt2lprecorder.lzx</b> |
||||
</ul> |
||||
</p> |
||||
<h3><a name="VideoConferencing">1.4 Requirements for VideoConferencing</a></h3> |
||||
<p>The set-up and usage of the videoconferencing and recording functionality in Dokeos is provided by patched external |
||||
packages. These patches are at this moment not yet available in the latest stable release of the packages. The following |
||||
4 packages are used. Openlaszlo comes in a packages with the tomcat server 5.0.24. The red5 streaming servers is packaged with the |
||||
jetty servlet engine. In order to be able to correctly identify the usercontext from Dokeos into Openlaszlo and Red5 the |
||||
connection between the apache webserver and the tomcat servlet engine is needed. |
||||
<ul> |
||||
<li>OpenLaszlo: <a href="http://www.openlaszlo.org/">http://www.openlaszlo.org/</a></li> |
||||
<li>Apache Tomcat: <a href="http://tomcat.apache.org/">http://tomcat.apache.org/</a></li> |
||||
<li>Red5: <a href="http://osflash.org/red5">http://osflash.org/red5</a></li> |
||||
<li>Jetty: <a href="http://www.mortbay.org/">http://www.mortbay.org/</a></li> |
||||
|
||||
</ul> |
||||
Download of the additional packages from the Dokeos site. |
||||
<ul> |
||||
<li>The packages Openlaszlo and tomcat can be downloaded at |
||||
<a href="http://www.dokeos.com/download.../dokeosopenlaszlo_1_8.tar.gz">http://www.dokeos.com/download/... dokeosopenlaszlo_1_8.tar.gz</a> |
||||
</li> |
||||
<li> |
||||
The Red5 packages can be downloaded at |
||||
<a href="http://www.dokeos.com/download.../dokeosred5_1_8.tar.gz">http://www.dokeos.com/download/... dokeosred5_1_8.tar.gz</a> |
||||
</li> |
||||
</ul> |
||||
</p> |
||||
<h4><a name="Openlaszlo">1.4.1 Requirements and installation of OpenLaszlo</a></h4> |
||||
<p>Depending if the Openlaszlo server is installed on the same server as the webserver of dokeos, different parameters have to be changed</p> |
||||
<ul> |
||||
<li>Installation of the Openlaszlo server tar -xzvf dokeosopenlaszlo_1_8.tar.gz</li> |
||||
<li>Check the path to the JAVA_HOME in <b>$yourinst/lps-latest/Server/tomcat-5.0.24/bin/startup.bin(bat)</b></li> |
||||
<li>If on a different server then the file should be edited <b>$yourinst/lps-latest/Server/lps-latest/videoconference/videoconference.lzx</b> (rmtphost should change to the host of dokeosserver, rmtphostlocal local tomcatserver)</li> |
||||
<li>Start server with <b>$yourinst/lps-latest/Server/tomcat-5.0.24/bin/startup.bin(bat)</b></li> |
||||
</ul> |
||||
<h4><a name="Red5">1.4.2 Requirements and installation of Red5 Server</a></h4> |
||||
<p>Installation and set-up of the Red5 Server</p> |
||||
<ul> |
||||
<li>Installation tar -xzvf dokeosred5_1_8.tar.gz</li> |
||||
<li>Check the path to the JAVA_HOME<b>$yourinst/dist/red5.sh(bat)</b></li> |
||||
<li>Start the server with <b>$yourinst/dist/red5.sh(bat)</b></li> |
||||
</ul> |
||||
<h4><a name="ApacheConfig">1.4.3 Requirements for the connection of Tomcat with Apache</a></h4> |
||||
<p>The mod-jk or mod-jk module for apache(2) has to be installed in order to transfer the sessiondata from the Dokeos to the |
||||
additional plugins. For the installation of the additional modules see the installation guide of the webserver.</p> |
||||
<ul> |
||||
<li>Apache2 with mod-jk module</li> |
||||
<ul> |
||||
<li>Install mod-jk</li> |
||||
<li>Configure the workers.properties file</li> |
||||
<ul> |
||||
<li>edit file /etc/libapache2-mod-jk/workers.properties (ubuntu)</li> |
||||
<li>workers.java_home=/usr/lib/j2sdk1.5-sun (path to the java sdk)</li> |
||||
<li>workers.tomcat_home=$yourInstallation/lps-latest/Server/tomcat-5.0.24 (path to tomcat of Openlaszlo)</li> |
||||
</ul> |
||||
<li>Configure the file jk.load</li> |
||||
<ul> |
||||
<li>edit file /etc/apache2/mods-enabled/jk.load (ubuntu)</li> |
||||
<li>JkLogFile /var/log/apache2/mod_jk.log</li> |
||||
<li>JkLogLevel info</li> |
||||
<li>JkLogStampFormat "[%a %b %d %H:%M:%S %Y]"</li> |
||||
<li>JkMount /lps-latest ajp13</li> |
||||
<li>JkMount /lps-latest/dokeos/* ajp13</li> |
||||
</ul> |
||||
<li>Restart/Reload Apache2</li> |
||||
</ul> |
||||
<li>Apache2 with mod-jk2 module</li> |
||||
<ul> |
||||
<li>Install mod-jk2</li> |
||||
<li>copy a default workers2.properties to /etc/apache2/</li> |
||||
<li>edit jk2.load remove comment lines</li> |
||||
<li>Restart/reload Apache2</li> |
||||
</ul> |
||||
</ul> |
||||
<h4><a name="DokeosVideo">1.4.4 Configuration of DokeosVideoServerving plugin</a></h4> |
||||
<p>The configuration of the videoServing is done via de admin pages of Dokeos</p> |
||||
<p>Configuration in dokeos platform admin, Configure the services, Configure VideoConferencingServer</p> |
||||
<p>This contains the URL to the videoserver the example is for a localversion </p> |
||||
<ul> |
||||
<li>url:<b>/lps-latest/videoconferencing/videoconferencing.html</b></li> |
||||
</ul> |
||||
<b>Bandwidth calculation</b> |
||||
<p>Outgoing Stream:7KB Incoming Stream: 12KB</p> |
||||
<p>1 one2four VideoConference: 4 outgoing streams from every client: 4*7KB=28KB incoming traffic on server-side |
||||
12 incoming streams to every client: 12*12KB=144KB outgoing traffic from server-side</p> |
||||
<p>1 one2many Conference (up to 50 seats) 1 outgoing streams -> 7KB incoming traffic 50 incoming streams -> |
||||
50*12KB = 524KB outgoing traffic</p> |
||||
|
||||
<h2><a name="install_new_version">2. Installing a new version of Dokeos</a></h2> |
||||
<p> 2.1. Download the Dokeos 1.8 install package (.zip for Windows users or .tar.gz for all others) from the <a href="http://www.dokeos.com/download.php">Dokeos download page</a>. </p> |
||||
<p> 2.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-community-1.8.tar.gz </p> |
||||
<p> 2.3. Move by any means (FTP, SCP, local file copy) the contents of the |
||||
Dokeos install package to your website on your webserver (whether webroot or subdirectory). Your webserver can also be your local computer. Be sure to copy all the folders (archive, home, claroline, courses) as well as all the .php files. </p> |
||||
<p> For Windows users who install Dokeos locally: if you use an Apache/PHP/MySQL combination package, just drag and drop the contents of the Dokeos install package into the web directory of the combination package:</p> |
||||
<ul> |
||||
<li><strong>EasyPHP</strong> - C:\Program Files\easyphp\www\</li> |
||||
<li><strong>WAMP</strong> - C:\Program Files\wamp\www\ |
||||
<li><strong>XAMP</strong> - C:\Program Files\xamp\www\</li> |
||||
</ul> |
||||
<p><a name="protections"> 2.4. The following directories need to be readable, writeable and executable for the owner of the apache webservice: </a></p> |
||||
<ul> |
||||
<li>dokeos/main/inc/conf/</li> |
||||
<li>dokeos/main/garbage/</li> |
||||
<li>dokeos/main/upload/</li> |
||||
<li>dokeos/main/img/default_courses_img/</li> |
||||
<li>dokeos/archive/</li> |
||||
<li>dokeos/courses/</li> |
||||
<li>dokeos/home/</li> |
||||
</ul> |
||||
<p> On Linux, Mac OS X and BSD operating systems you can use the CHMOD 777 command for this. |
||||
In Windows, you may need to check the properties of the folders (by right-clicking on them). </p> |
||||
<p> 2.5. The following files need to be readable and writeable for everyone: </p> |
||||
<ul> |
||||
<li>dokeos/main/inc/conf/configuration.php (if present)</li> |
||||
<li>dokeos/home/*.html</li> |
||||
</ul> |
||||
<p> On Linux, Mac OS X and BSD operating systems you can use the CHMOD 666 command for this. |
||||
In Windows, you may need to check the properties of the files and folders (by right-clicking on them). </p> |
||||
<p> <b>NOTE:</b><br/> |
||||
Do not modify the home_*.html files directly. Instead, |
||||
choose "Configure the homepage" in the Dokeos administration section. </p> |
||||
<p> 2.6. Open a web browser and go to |
||||
http://www.yourserver.org/yoursite/dokeos/index.php |
||||
|
||||
If you install Dokeos locally (not on a server) open: |
||||
http://localhost/dokeos/index.php </p> |
||||
<p> 2.7. Click on the install button and follow instructions. |
||||
|
||||
Windows: with combination packages like easyphp, out of the box, login and password |
||||
for MySQL should probably remain empty. </p> |
||||
<p> <strong>2.8. Configuration and security after installation</strong> </p> |
||||
<ul> |
||||
<li><strong>Protect your configuration file: </strong> make sure no one can overwrite it. You can find the config file in <em>(dokeos folder)</em>/main/inc/conf/configuration.php. Make it read-only (windows/xwindows: right-click the file to edit the properties. linux/bsd/macosx: use the chmod 444 command). The config file is created by Apache so you may need to be root user to change its permissions.</li> |
||||
<li><strong>Protect your installation folder: </strong> if the <em>(dokeos folder)</em>/main/install folder is still accessible, someone could install over your existing version (you could lose your data that way). Move the folder somewhere out of the web directories so it is not accessible, change its name, or edit its properties so no one can read or execute it.</li> |
||||
<li><strong>For better security: </strong> making the files world-writable will help you install, and solves many issues for people without much admin experience. However, it's better security to make the owner of the apache process (often called apache or www-data) also owner of all the dokeos files and folders. Ths way, these files need only be readable and writable by the Apache process owner, not by the entire world.</li> |
||||
<li><strong>Configure your Dokeos installation: </strong> in the administration section of Dokeos, you can use the Dokeos Config Settings to adjust the behavior of your installation.</li> |
||||
<li><strong>Configure Dokeos mail: </strong> most of Dokeos uses the mail settings from the php.ini file. However, the announcements tool uses phpMailer (another free software project) and the settings for this tool can be adjusted in <em>(dokeos folder)</em>/main/inc/conf/mail.conf.php.</li> |
||||
</ul> |
||||
<hr> |
||||
<h2><a name="upgrade_previous_version">3. Upgrading from a previous version of Dokeos</a></h2> |
||||
<p> Before upgrading we heavily 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.<br/> |
||||
</p> |
||||
<p> <em>If you upgrade from Dokeos 1.8</em>, you can simply copy the new files of 2.0.1 over |
||||
the files of the older version. You should not copy over the home, courses or archive folders, otherwise you might lose data. If you accidentally copy over those folders, you can simply replace them with the folders from your backup.<br/> |
||||
<em>If you upgrade from a lower version of Dokeos (1.6.x)</em>, |
||||
you'll have to use the built-in upgrade facility, as described below. </p> |
||||
<p> 3.1. Download the Dokeos 1.8 install package (.zip for Windows users or .tar.gz for all others) from the <a href="http://www.dokeos.com/download.php">Dokeos download page</a>. </p> |
||||
<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-community-1.8.tar.gz </p> |
||||
<p> 3.3. Move the Dokeos directory to a different path from the previous version </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.8 to be installed in the same directory as |
||||
the previous version : |
||||
<ul> |
||||
<li>move the old directory to a new location (e.g. move dokeos/ to dokeos_old/)</li> |
||||
<li>uncompress Dokeos 1.8 to the old version directory (e.g. uncompress Dokeos 2.0.1 to dokeos/)</li> |
||||
<li>go to next step</li> |
||||
</ul> |
||||
</p> |
||||
<p> 3.4. The following files need to be readable and writeable by the web server: |
||||
<ul> |
||||
<li>dokeos/main/inc/conf/configuration.php (if present)</li> |
||||
<li>dokeos/home/*.html</li> |
||||
</ul> |
||||
On Linux, Mac OS X and BSD operating systems you can use the CHMOD 666 command for this. |
||||
In Windows, you may need to check the properties of the folders. |
||||
</p> |
||||
<p> <b>NOTE:</b><br/> |
||||
Do not modify the home_*.html files directly. Instead, |
||||
choose "Configure the homepage" in the Dokeos administration section. </p> |
||||
<p> 3.5. The following directories need to be readable, writeable and executable by the web server: |
||||
<ul> |
||||
<li>dokeos/main/inc/conf/</li> |
||||
<li>dokeos/main/garbage/</li> |
||||
<li>dokeos/main/upload/</li> |
||||
<li>dokeos/main/img/default_courses_img/</li> |
||||
<li>dokeos/archive/</li> |
||||
<li>dokeos/courses/</li> |
||||
<li>dokeos/home/</li> |
||||
</ul> |
||||
On Linux, Mac OS X and BSD operating systems you can use the CHMOD 777 command for this. |
||||
In Windows, you may need to check the properties of the folders. |
||||
</p> |
||||
<p> 3.6. Open a web browser and go to |
||||
http://www.yourserver.org/yoursite/dokeos/index.php<br /> |
||||
On 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 "Upgrade from Dokeos 1.6, 1.6.1, 1.6.2, 1.6.3, 1.6.4, 1.6.5" and follow the instructions. </p> |
||||
<h2><a name="troubleshooting">4. Troubleshooting</a></h2> |
||||
<p> In the future we will also provide instructions on how to do a "manual" install |
||||
of Dokeos, by creating the database tables yourself. |
||||
|
||||
If you have any problems, go to the <a href="http://www.dokeos.com">Dokeos website</a> and ask a question on our <a href="http://www.dokeos.com/forum/">support forum</a>. Please read the previous messages first to see if there is |
||||
already an answer to your question. We also maintain a list of <a href="http://www.dokeos.com/wiki/index.php/FAQ">Frequently Asked Questions</a>. </p> |
||||
<h2><a name="admin_section">5. Administration section</a></h2> |
||||
<p> To access the Dokeos administration section, open browser, |
||||
go to your Dokeos adress and log in with the admin user. |
||||
Then you will see a "Platform admin section" link in the header of the web page. </p> |
||||
<h2><a name="ldap">6. LDAP</a></h2> |
||||
<p> <i>This part is optional, only organisations with an LDAP server will need to read this.</i><br/> |
||||
An LDAP module is already provided in Dokeos, but it has to be configured to make it work. </p> |
||||
<p> <b>Compiling</b><br/> |
||||
Linux servers: It's possible that you have to recompile php with ldap support. |
||||
Newer distributions also allow downloading rpms for additional packages. </p> |
||||
<p> <b>Activating LDAP in Dokeos</b><br/> |
||||
In (dokeos folder)/main/inc/conf/configuration.php, around line 90, you see<br/> |
||||
//for new login module<br/> |
||||
//uncomment these to activate ldap<br/> |
||||
//$extAuthSource['ldap']['login'] = "./main/auth/ldap/login.php";<br/> |
||||
//$extAuthSource['ldap']['newUser'] = "./main/auth/ldap/newUser.php";<br/> |
||||
<br/> |
||||
remove the // from the last two lines to activate LDAP.<br/> |
||||
</p> |
||||
<p> <b>Settings</b><br/> |
||||
Ask the LDAP server admin for the settings: |
||||
<ul> |
||||
<li>ldap server name</li> |
||||
<li>ldap server port (usually 389)</li> |
||||
<li>ldap dc</li> |
||||
</ul> |
||||
You must enter these in |
||||
(dokeos folder)/main/auth/ldap/ldap_var.inc.php <br/> |
||||
//parameters for LDAP module<br/> |
||||
$usesLDAP = TRUE;<br/> |
||||
$usesCurriculum = FALSE;<br/> |
||||
$ldaphost = "myldapserver.com"; // your ldap server<br/> |
||||
$ldapport = 389; // your ldap server's port number<br/> |
||||
$ldapDc = "dc=xx, dc=yy, dc=zz"; //domain<br/> |
||||
</p> |
||||
<p> <b>Teacher/student status</b><br/> |
||||
If you wish, you can give teacher/student status to dokeos users according to settings in the ldap server. |
||||
This is not a standard field however, so you'll have to change some code. |
||||
main/auth/ldap/ldap_var.inc.php |
||||
around line 189, function putUserInfoInClaroline ($login, $infoArray) </p> |
||||
<p> if (<i>your criterium</i>)<br/> |
||||
{<br/> |
||||
$statut = STUDENT;<br/> |
||||
}<br/> |
||||
else<br/> |
||||
{<br/> |
||||
$statut = COURSEMANAGER;<br/> |
||||
}<br/> |
||||
</p> |
||||
<p> If this seems too difficult, the simplest solution is to just put |
||||
$statut = STUDENT; and give course manager rights through the administration section. </p> |
||||
<p> <b>Protected LDAP servers</b><br/> |
||||
Some LDAP servers do not support anonymous use of the directory services |
||||
In this case, you need code that binds with a name and password - this code has already been provided, |
||||
just ask on a forum or email for this. </p> |
||||
<p> |
||||
<h2>7 Debian based linux distribution (ubuntu)</h2> |
||||
<p>The following packages have to be installed</p> |
||||
<ul> |
||||
<li>Apache(2)</li> |
||||
<ul> |
||||
<li>apt-get install apache2</li> |
||||
<li>apt-get install apache2-common</li> |
||||
<li>apt-get install apache2-utils</li> |
||||
<li>apt-get install apache2-utils</li> |
||||
<li>apt-get install libapache2-mod-jk</li> |
||||
</ul> |
||||
<li>Mysql</li> |
||||
<ul> |
||||
<li>apt-get install mysql-server</li> |
||||
<li>apt-get install mysql-common</li> |
||||
</ul> |
||||
<li>php4</li> |
||||
<ul> |
||||
<li>apt-get install php4</li> |
||||
<li>apt-get install php4-common</li> |
||||
<li>apt-get install php4-mysql</li> |
||||
<li>apt-get install apache2-mod-php4</li> |
||||
</ul> |
||||
<li>Java</li> |
||||
<ul> |
||||
<li>apt-get install sun-java5-jdk</li> |
||||
</ul> |
||||
<li>Powerpoint and Presenter conversiontool</li> |
||||
<ul> |
||||
<li>apt-get install openoffice.org</li> |
||||
<li>apt-get install xvfb xbase-clients</li> |
||||
<li>Install basic fonts and x-window when a headless server is used</li> |
||||
<li>copy the oooserver.init file</li> |
||||
<li>start the openoffice server with /etc/init.d/oooserver start</li> |
||||
</ul> |
||||
<li>Install Openlaszlo and tomcat</li> |
||||
<ul> |
||||
<li>downlooad dokeosopenlaszlo_1_8.tar.gz</li> |
||||
<li>tar -xvzf dokeosopenlaszlo_1_8.tar.gz</li> |
||||
<li>change if needed the references to java_home</li> |
||||
<li>start the server with $installdir/lps-latest/Server/tomcat-5.0.24/bin/startup.sh</li> |
||||
</ul> |
||||
<li>Install Red5 server</li> |
||||
<ul> |
||||
<li>download dokeosred5_1_8.tar.gz</li> |
||||
<li>tar -xvzf dokeosred5_1_8.tar.gz</li> |
||||
<li>change if needed the references to java_home</li> |
||||
<li>start the server with $installdir/dist/red5.sh</li> |
||||
</ul> |
||||
<li>Install Dokeos</li> |
||||
<ul> |
||||
<li>download dokeos.tar.gz</li> |
||||
<li>tar -xvzf dokeos.tar.gz</li> |
||||
<li>change the apache setting</li> |
||||
<li>restart your web-server</li> |
||||
<li>goto your dokeos homepage</li> |
||||
</ul> |
||||
</ul> |
||||
<hr> |
||||
Contact address: Dokeos, 44 rue des palais, B-1030 Brussels, Belgium<br/> |
||||
Mail: info@dokeos.com |
||||
<hr> |
||||
</p> |
||||
</div> |
||||
</div> |
||||
</body> |
||||
</html> |
||||
@ -1,327 +0,0 @@ |
||||
<html> |
||||
<head> |
||||
<title>VodiÄ? po namestitvi Dokeos community release 2.0</title> |
||||
<meta http-equiv="Content-Type" content="text/html; charset=windows-1250" /> |
||||
<link rel="stylesheet" href="../main/css/default/default.css" type="text/css" media="screen,projection" /> |
||||
<link rel="shortcut icon" href="../favicon.ico" type="image/x-icon" /> |
||||
</head> |
||||
<body> |
||||
<div id="header1"> |
||||
<h1>VodiÄ? po namestitvi Dokeos 1.8 </h1> |
||||
</div> |
||||
<a href="index.html">Documentation</a> > Slovenian installation guide |
||||
<div id="outerframe"> |
||||
<div id="main"> |
||||
<p>Zahvaljujemo se vam, ker ste si prenesli Dokeos! |
||||
|
||||
To besedilo vas bo vodilo preko osnovnih korakov namestitve Dokeos 2.0. |
||||
|
||||
Preberite ga v celoti preden priÄ?nete z namestitvijo.</p> |
||||
<p>Ta vodiÄ? je dostopen tudi v drugih jezikih, seznam se nahaja na <a href="documentation/index.html">tej strani</a>. Spletna stran Dokeos bo vsebovala obvestilo vsakiÄ?, ko bo dostopen nov prevod.</p> |
||||
<p>Tole je le kratek vodiÄ? po postopku namestitve. Pripravljamo priroÄ?nik |
||||
|
||||
s podrobnejšimi informacijami o namestitvi, ki pa v Ä?asu nastanka tega dokumenta še ni na voljo. Ko bo, bo priroÄ?nik dostopen na naslovu <a href="http://www.dokeos.com/documentation.php">Dokeos documentation page</a>. Nastajanje priroÄ?nika si lahko ogledate na <a href="http://www.dokeos.com/wiki/index.php/Manual">web writing area</a>. VzdrĹľujemo tudi seznam <a href="http://www.dokeos.com/wiki/index.php/FAQ">pogosto zastavljenih vprašanj (FAQ)</a>.</p> |
||||
<p> <b>Vsebina</b> </p> |
||||
<ol> |
||||
<li>Zahteve</li> |
||||
<li>Namestitev nove razliÄ?ice Dokeos</li> |
||||
<li>Nadgradnja predhodne razliÄ?ice Dokeos</li> |
||||
<li>Odpravljanje teĹľav</li> |
||||
<li>Administracija</li> |
||||
<li>Ldap (opcijsko)</li> |
||||
</ol> |
||||
<p></p> |
||||
<h2>1. Zahteve</h2> |
||||
<p>Dokeos je spletna aplikacija, ki za svoje delovanje zahteva nekaj dodatne programske opreme:</p> |
||||
<ul> |
||||
<li>Spletni streĹľnik - priporoÄ?amo <strong>Apache</strong></li> |
||||
<li><strong>PHP</strong></li> |
||||
<li><strong>MySQL</strong> streĹľnik podatkovne baze</li> |
||||
</ul> |
||||
<p> Ta programska oprema mora biti namešÄ?ena na raÄ?unalniškem sistemu preden priÄ?nete z namestitvijo Dokeos. <br /> |
||||
Zahtevano programsko opremo lahko namestite po delih (vsako posamezno), kar ponavadi daje boljše rezultate. Uporabniki zaÄ?etniki, ki bi Ĺľeleli preskusiti |
||||
|
||||
Dokeos, pa lahko uporabijo <i>sestavljen paket programske opreme (bundle)</i> , ki vse potrebno namesti z enim samim namestitvenim postopkom. ÄŚe Ĺľelite tak sestavljen paket, priporoÄ?amo Wamp (dostopen na <a href="http://www.wampserver.com/en/index.php">WAMP5 spletni strani</a>, pri tem potrebujete tudi <a href="http://www.wampserver.com/en/add-ons.php">PHP4 add-on</a>) ali <a href="http://www.apachefriends.org/en/index.html">XAMP</a>. </p> |
||||
<h3>1.1. Spletni streĹľnik</h3> |
||||
<p> PriporoÄ?amo Apache spletni streĹľnik. Dokeos vsebuje moĹľnosti izkorišÄ?anja |
||||
|
||||
nakaterih Apache varnostnih mehanizmov. ÄŚe vam ta ne odgovorja, lahko uporabite poljuben drug spletni streĹľnik. |
||||
|
||||
Za ustrezno uporabo varnostnih mehanizmov Apache spletnega streĹľnika, morate namestiti in aktivirati Apache modul <b>mod_rewrite</b>. Pravila mod_rewrite za Dokeos |
||||
|
||||
so zapisana v <b>.htaccess</b> datoteki mape <b>courses</b>, torej jih morate omogoÄ?iti v nastavitvah streĹľnika Apache (<b>AllowOverride FileInfo</b> v datoteki <b>httpd.conf</b>). <br /> |
||||
<br /> |
||||
<a href="http://httpd.apache.org/download.cgi">Prenesi si Apache spletni streĹľnik</a><br /> |
||||
<a href="http://httpd.apache.org/docs-project/">PriroÄ?nik za uporabo Apache spletnega streĹľnika</a> </p> |
||||
<h3>1.2. PHP</h3> |
||||
<p>Potrebujete PHP verzije 4.3.2 ali kasnejše (4.x verzije), konfiguriranega z |
||||
|
||||
naslednjimi moduli : mysql, zlib, preg, xml. PHP verzije 5 ali novejši |
||||
|
||||
še niso podprti s strani Dokes. |
||||
|
||||
Potrebujete tudi ldap modul , Ä?e Ĺľelite uporabljati ldap v povezavi z Dokeos. |
||||
|
||||
VeÄ?ina PHP4 predprevedenih distribucij prihaja z vsemi naštetimi moduli. |
||||
|
||||
Kakorkoli Ĺľe, njihova prisotnost se preveri v Dokeos namestitvenem postopku. <br /> |
||||
<br /> |
||||
<a href="http://www.php.net/downloads.php">Prenesi si PHP</a><br /> |
||||
<a href="http://www.php.net/docs.php">PHP priroÄ?nik</a> </p> |
||||
<p> Nekateri uporabniki lahko naletijo na teĹľave v primeru, de se nastavitev PHP razlikuje od:</p> |
||||
<ul> |
||||
<li>short_open_tag = On</li> |
||||
<li>safe_mode = Off</li> |
||||
<li>magic_quotes_gpc = On</li> |
||||
<li>magic_quotes_runtime = Off</li> |
||||
</ul> |
||||
<p> Predhodne razliÄ?ice Dokeos zahtevajo <b>register_globals</b> nastavljen na vrednost <b>On</b>. To ni veÄ? potrebno. </p> |
||||
<p><strong>BSD uporabniki:</strong> naslednje php knjiĹľnjice (moduli) morajo biti vkljuÄ?eni v namestitev php:</p> |
||||
<ul> |
||||
<li><b>php-mysql</b> The mysql shared extension for php</li> |
||||
<li><b>php-pcre</b> The pcre shared extension for php</li> |
||||
<li><b>php-session</b> The session shared extension for php</li> |
||||
<li><b>php-zlib</b> The zlib shared extension for php</li> |
||||
<li><b>php-xml</b></li> |
||||
<li>(opcijsko) <b>php-ldap</b> Ä?e Ĺľelite uporabiti LDAP autentifikacijo</li> |
||||
</ul> |
||||
<h3>1.3. MySQL streĹľnik podatkovne baze</h3> |
||||
<p>Potrebujete uporabniško ime in geslo, ki dovoljujeta upravljanje in kreiranje vsaj ene podatkovne baze. |
||||
|
||||
Dokeos vam prednastavljeno kreira novo podatkovno bazo z vsakim kreiranim teÄ?ajem. |
||||
|
||||
To pomeni, da vam mora streĹľnik dovoliti kreiranje in upravljanje veÄ?ih podatkovnih baz. |
||||
|
||||
V postopku namestitve lahko izberete namestitev z eno samo podatkovno bazo, Ä?e vam ponudnik storitve ne omogoÄ?a kreiranje veÄ?ih. <br /> |
||||
<br /> |
||||
<a href="http://dev.mysql.com/downloads/">Prenesi si MySQL streĹľnik</a><br /> |
||||
<a href="http://dev.mysql.com/doc/mysql/en/index.html">MySQL uporabniški priroÄ?nik</a> </p> |
||||
<p> <b><i>Opomba:</i></b><br /> |
||||
Vse kaĹľe da znak za povešenko /backticks character/ <b>(`)</b>, vstavljen v veÄ?ino |
||||
|
||||
Dokeos SQL povpraševanj od razliÄ?ice 1.3 ne deluje z MySQL |
||||
|
||||
verzijami pred 3.23.6. </p> |
||||
<h3>1.4. Pravice dostopa</h3> |
||||
<p> Nadalje, potrebujete pisalni dostop (Write access) pri dostopu do spletnih map, kjer se nahaja namešÄ?en Dokeos. Na Windows platformah z lokalno namestitvijo to ni problem. Pri oddaljenem dostopu pa potrebujete dovoljenje za funkcijo CHMOD vsled uporabe protokolov FTP, telnet ali drugih. </p> |
||||
<hr> |
||||
<h2>2. Namestitev nove razliÄ?ice Dokeos</h2> |
||||
<p> 2.1. Prenesite si 2.0 namestitveni paket (.zip za Windows uporabnike ali .tar.gz za ostale) s <a href="http://www.dokeos.com/download.php">Dokeos spletnega naslova</a>. </p> |
||||
<p> 2.2. Dekomprimirajte (unzip / untar) prenesen namestitveni paket. |
||||
|
||||
VeÄ?ina novejših operacijskih sistemov |
||||
|
||||
je to zmoĹľna izvesti z vgrajenimi grafiÄ?nimi aplikacijami, Ä?e pa to ne deluje, |
||||
|
||||
lahko to izvedete preko ukaznega poziva: v mapi, kamor ste si prenesli namestitveni paket odtipkajte <b>tar -zxvf dokeos-2.0.tar.gz</b> </p> |
||||
<p>2.3. Prestavite (FTP, SCP, lokalno kopiranje datotek) vsebino Dokeos namestitvenega paketa na Ĺľeleno spletno stran spletnega streĹľnika (ali v korensko mapo spletnega streĹľnika ali njegovo poljubno podmapo). Vaš spletni streĹľnik je lahko tudi vaš lokalni raÄ?unalnik. Pazite, da boste prestavili vse mape (archive, home, claroline, |
||||
|
||||
courses) kot tudi vse .php datoteke. </p> |
||||
<p>Za Windows uporabnike, ki namešÄ?ajo Dokeos lokalno: Ä?e uporabljate |
||||
|
||||
Apache/PHP/MySQL sestavljen paket, uporabite funkcijo povleci in izpusti (drag and drop) na vsebini Dokeos namestitvenega paketa v WWW mapo namešÄ?enega sestavljenega paketa:</p> |
||||
<ul> |
||||
<li><strong>EasyPHP</strong> - C:\Program Files\easyphp\www\</li> |
||||
<li><strong>WAMP</strong> - C:\Program Files\wamp\www\</li> |
||||
<li><strong>XAMP</strong> - C:\Program Files\xamp\www\</li> |
||||
</ul> |
||||
<p> 2.4. Naslednje mape morajo imeti bralne, pisalne in izvršilne pravice za vse in vsakogar: </p> |
||||
<ul> |
||||
<li>dokeos/main/inc/conf/</li> |
||||
<li>dokeos/main/garbage/</li> |
||||
<li>dokeos/main/upload/</li> |
||||
<li>dokeos/main/img/default_courses_img/</li> |
||||
<li>dokeos/archive/</li> |
||||
<li>dokeos/courses/</li> |
||||
<li>dokeos/home/</li> |
||||
</ul> |
||||
<p> Na operacijskih sistemih Linux, Mac OS X in BSD lahko uporabite ukaz CHMOD 777 za dodeljevanje pravic. |
||||
|
||||
Pri Windows OS, preverite lastnosti map (klik z desnim miškinim gumbom na mapi). </p> |
||||
<p> 2.5. Naslednje mape morajo imeti bralne in pisalne pravice za vse in vsakogar: </p> |
||||
<ul> |
||||
<li>dokeos/main/inc/conf/configuration.php (Ä?e obstaja)</li> |
||||
<li>dokeos/home/*.html</li> |
||||
</ul> |
||||
<p> Na operacijskih sistemih Linux, Mac OS X in BSD lahko uporabite ukaz CHMOD 666. |
||||
|
||||
Pri Windows OS, preverite lastnosti map (klik z desnim miškinim gumbom na mapi). </p> |
||||
<p> <b><i>OPOMBA:</i></b><br /> |
||||
Ne spreminjajte vsebine <b>home_*.html</b> datotek direktno. Namesto tega, |
||||
|
||||
uporabite moĹľnost "Uredi domaÄ?o stran" v Dokeos administracijskem podroÄ?ju. </p> |
||||
<p> 2.6. Odprite okno spletnega brskalnika in pojdite na |
||||
|
||||
http://www.vasstreznik.org/vasastran/dokeos/index.php |
||||
|
||||
|
||||
|
||||
ÄŚe ste Dokeos namestili lokalno, odprite: |
||||
|
||||
http://localhost/dokeos/index.php </p> |
||||
<p> 2.7. Kliknite na gumb <b>install</b> in sledite navodilom. |
||||
|
||||
|
||||
|
||||
Windows: pri uporabi sestavljenega paketa, kot je npr. easyphp, bosta uporabniško ime in geslo |
||||
|
||||
za MySQL verjetno prazna /ju ni/. </p> |
||||
<p> <strong>2.8. Nastavitve in varnost po postopku namestitve</strong> </p> |
||||
<ul> |
||||
<li><strong>ZašÄ?ita datoteke z nastavitvami: </strong> zagotovite, da je nihÄ?e ne bo mogel spremeniti. Datoteko z nastavitvami najdete na <em>(dokeos mapa)</em>/main/inc/conf/configuration.php. |
||||
|
||||
Naredite jo zgolj bralno (windows/xwindows: desni miškin klik na datoteki, lastnosti. |
||||
|
||||
linux/bsd/macosx: uporabite ukaz chmod 444 ). Datoteka z nastavitvami je generirana s strani Apache, torej boste morali imeti pravice root uporabnika za spremembo pravic.</li> |
||||
<li><strong>ZašÄ?ita namestitvene mape: </strong> v primeru, da je <em>(dokeos mapa)</em>/main/install |
||||
|
||||
mapa še vedno dostopna, lahko nepooblašÄ?ena oseba izvrši novo namestitev preko trenutne namestitve (s ponovno namestitvijo so vaši trenutni podatki lahko izgubljeni). Premaknite mapo nekam izven obsega |
||||
|
||||
vaših spletnih map, da preko spletnega streĹľnika ne bo dosegljiva, in spremenite lastnosti tako, da datotek ne bo mogel nihÄ?e brati in izvrševati.</li> |
||||
<li><strong>Za boljšo varnost: </strong> nastavitev pravic dostopa na naÄ?in, da so vse datoteke in mape dostopne vsem pri pisalnih in izvršilnih dostopih, je lahko v pomoÄ? pri namestivi portala, in je tudi lahko v pomoÄ? pri reševanju doloÄ?enih problemov, predvsem za uporabnike z malo ali niÄ? administratorske prakse. Kakorkoli Ĺľe, za varnost je veliko bolje, da je lastnik vseh datotek in map Dokeos namestitve apache proces (obiÄ?ajno poimenovan apache, www ali httpd). Na ta naÄ?in, morajo datoteke namestitve biti le bralne in pisalne za lastnika (Apache proces), ne pa tudi za vse ostale.</li> |
||||
<li><strong>Konfiguracija in prilagajanje Dokeos namestitve: </strong> v administracijskem podroÄ?ju Dokeos lahko uporabite Dokeos nastavitve za prilagoditev vaše namestitve.</li> |
||||
<li><strong>Nastavitev Dokeos e-poštnih storitev: </strong> pretežni del Dokeos-a uporablja poštne nastavitve iz php.ini datoteke. Le |
||||
|
||||
orodje obvestil uporablja phpMailer (drug odprtokodni projekt) |
||||
|
||||
in nastavitve za to orodje se nahajajo v datoteki <em>(dokeos mapa)</em>/main/inc/conf/mail.conf.php.</li> |
||||
</ul> |
||||
<hr> |
||||
<h2>3. Nadgradnja predhodne razliÄ?ice Dokeos</h2> |
||||
<p> Pred nagraditvijo toplo priporoÄ?amo izdelavo popolne rezervne kopije trenutnih Dokeos map, njihove vsebine in podatkovnih baz. ÄŚe niste prepriÄ?ani, kako boste to izvedli, se obrnite po nasvet na gostitelja oz. ponudnika storitve. <br/> |
||||
</p> |
||||
<p> 3.1. Prenesite si Dokeos 2.0 namestitveni paket (.zip za Windows uporabnike ali .tar.gz za vse ostale) s spletnega naslova <a href="http://www.dokeos.com/download.php">Dokeos download page</a>. </p> |
||||
<p> 3.2. Dekomprimirajte (unzip / untar) prenesen namestitveni paket. |
||||
|
||||
VeÄ?ina novejših operacijskih sistemov |
||||
|
||||
je to zmoĹľno izvesti z vgrajenimi grafiÄ?nimi aplikacijami, Ä?e pa to ne deluje, |
||||
|
||||
lahko to izvedete preko ukaznega poziva: v mapi, kamor ste si prenesli namestitveni paket odtipkajte <b>tar -zxvf dokeos-2.0.tar.gz</b> </p> |
||||
<p> 3.3. Premaknite Dokeos mapo pod koren mape spletnega streĹľnika, proÄ? od obstojeÄ?e namestitve </p> |
||||
<p> <b><i>OPOZORILO:</i></b><br /> |
||||
Ne brišite obstojeÄ?e namestitve Dokeos pred namestitvijo nove. Staro namestitev lahko odstranite šele po uspešnem zakljuÄ?ku nadgraditve. </p> |
||||
<p> <b><i>NASVET:</i></b><br /> |
||||
ÄŚe Ĺľelite namestiti Dokeos 2.0 v isto mapo, kot je bil namešÄ?en pred nadgraditvijo: |
||||
<ul> |
||||
<li>prestavite mapo s staro namestitvijo na novo mesto (npr. move dokeos/ dokeos_old/)</li> |
||||
<li>dekomprimirajte Dokeos 2.0 na mesto stare namestitve (npr. dekomprimirajte Dokeos 2.0 v dokeos/)</li> |
||||
<li>pojdite na naslednji korak nadgraditve</li> |
||||
</ul> |
||||
</p> |
||||
<p> 3.4. Naslednje datoteke morajo biti bralne in pisalne za vsakogar: |
||||
<ul> |
||||
<li>dokeos/main/inc/conf/configuration.php (Ä?e obstaja)</li> |
||||
<li>dokeos/home/*.html</li> |
||||
</ul> |
||||
Na operacijskih sistemih Linux, Mac OS X in BSD lahko uporabite ukaz CHMOD 666. |
||||
|
||||
Pri Windows OS, preverite lastnosti map (klik z desnim miškinim gumbom na mapi). |
||||
</p> |
||||
<p> <b><i>OPOMBA:</i></b><br /> |
||||
Ne spreminjajte vsebine <b>home_*.html</b> datotek direktno. Namesto tega |
||||
|
||||
uporabite moĹľnost "Uredi domaÄ?o stran" v Dokeos administracijski sekciji. </p> |
||||
<p> 3.5. Naslednje mape morajo biti bralne, pisalne in izvršne za vsakogar: </p> |
||||
<ul> |
||||
<li>dokeos/main/inc/conf/</li> |
||||
<li>dokeos/main/garbage/</li> |
||||
<li>dokeos/main/upload/</li> |
||||
<li>dokeos/main/img/default_courses_img/</li> |
||||
<li>dokeos/archive/</li> |
||||
<li>dokeos/courses/</li> |
||||
<li>dokeos/home/</li> |
||||
</ul> |
||||
Na operacijskih sistemih Linux, Mac OS X in BSD lahko uporabite ukaz CHMOD 777 za doseljevanje pravic. |
||||
|
||||
Pri Windows OS, preverite lastnosti map (klik z desnim miškinim gumbom na mapi). |
||||
<p></p> |
||||
<p> 3.6. Odprite okno spletnega brskalnika in pojdite na |
||||
|
||||
http://www.yourserver.org/yoursite/dokeos/index.php .<br /> |
||||
Windows lokalno, z npr. easyphp ali drugim primerljivim, pojdite na: |
||||
|
||||
http://localhost/dokeos/index.php </p> |
||||
<p> 3.7. Kliknite gumb install , nato kliknite na "Update from Dokeos 1.5 | 1.5.4 | 1.5.5" in sledite navodilom. </p> |
||||
<h2>4. Odpravljanje teĹľav</h2> |
||||
<p> V prihodnosti imamo namen zagotoviti navodila za "roÄ?no" namestitev Dokeos, vkljuÄ?no z "roÄ?nim" kreiranjem podatkovne baze in vseh potrebnih tabel. |
||||
|
||||
|
||||
|
||||
ÄŚe naletite na kakršenkoli problem, pojdite na <a href="http://www.dokeos.com/">Dokeos spletno stran</a> in zastavite vprašanje na našem <a href="http://www.dokeos.com/forum/">forumu podpore</a>. Preberi prosim najprej predhodna sporoÄ?ila! Lahko, da je bil vaš problem Ĺľe rešen, vprašanje predhodno Ĺľe zastavljeno. VzdrĹľujemo tudi seznam <a href="http://www.dokeos.com/wiki/index.php/FAQ">pogosto zastavljanih vprašanj</a>. </p> |
||||
<h2>5. Administracija</h2> |
||||
<p> Za dostop do Dokeos administracijskega podroÄ?ja, odprite brskalnik, |
||||
|
||||
pojdite na Dokeos naslov vašega portala in se prijavite kot adminstratorski uporabnik. |
||||
|
||||
Videli boste "Platform admin section / podroÄ?je Upravitelj teÄ?aja" povezavo v glavi spletne strani portala. </p> |
||||
<h2>6. LDAP</h2> |
||||
<p> <i>Ta del je opcijski, sledeÄ?e besedilo je namenjeno le organizacijam z LDAP streĹľnikom .</i><br /> |
||||
LDAP modul je integriran v Dokeos distribucijo, potrebno ga je le ustrezno nastaviti, da ga usposobite za delo. </p> |
||||
<p> <b>Prevajanje</b><br /> |
||||
Linux streĹľniki: MoĹľno je, da boste morali ponovno prevesti php z ldap podporo. |
||||
|
||||
Novejše distribucije tudi dovoljujejo selektiven prenos rpm-jev za dodatne podporne pakete.<br/> |
||||
Enako velja tudi za BSD uporabnike. </p> |
||||
<p> <b>Activiranje LDAP v Dokeos</b><br/> |
||||
V (dokeos mapa)/main/inc/conf/configuration.php, okoli vrstice 90, se nahaja naslednje besedilo<br/> |
||||
//for new login module<br/> |
||||
//uncomment these to activate ldap<br/> |
||||
//$extAuthSource['ldap']['login'] = "./main/auth/ldap/login.php";<br/> |
||||
//$extAuthSource['ldap']['newUser'] = "./main/auth/ldap/newUser.php";<br/> |
||||
<br/> |
||||
odstranite // izpred zadnjih dveh vrstic za aktiviranje LDAP.<br/> |
||||
</p> |
||||
<p> <b>Nastavitve</b><br/> |
||||
Pozanimajte se pri upravitelju LDAP streĹľnika za naslednje nastavitve: |
||||
<ul> |
||||
<li>ldap ime streĹľnika</li> |
||||
<li>ldap streĹľniška vrata (obiÄ?ajno 389)</li> |
||||
<li>ldap dc</li> |
||||
</ul> |
||||
Te vrednosti morate vnesti v datoteko |
||||
|
||||
(dokeos mapa)/main/auth/ldap/ldap_var.inc.php <br/> |
||||
//parameters for LDAP module<br/> |
||||
$usesLDAP = TRUE;<br/> |
||||
$usesCurriculum = FALSE;<br/> |
||||
$ldaphost = "myldapserver.com"; // vaš ldap strežnik<br/> |
||||
$ldapport = 389; // vaša ldap številka strežniških vrat<br/> |
||||
$ldapDc = "dc=xx, dc=yy, dc=zz"; //domena<br/> |
||||
</p> |
||||
<p> <b>UÄ?itelj/teÄ?ajnik status</b><br /> |
||||
ÄŚe Ĺľelite, lahko uÄ?itelju/teÄ?ajniku dodelite znotraj dokeos status iz vpisov ldap streĹľnika. |
||||
|
||||
To ni standarna moĹľnost, torej boste morali rahlo spremeniti programsko kodo: |
||||
|
||||
main/auth/ldap/ldap_var.inc.php |
||||
|
||||
okoli vrstice 189, function putUserInfoInClaroline ($login, $infoArray) </p> |
||||
<p> if (<i>tvoj kriterij</i>)<br /> |
||||
{<br /> |
||||
$statut = STUDENT;<br /> |
||||
}<br /> |
||||
else<br /> |
||||
{<br /> |
||||
$statut = COURSEMANAGER;<br /> |
||||
}<br /> |
||||
</p> |
||||
<p> ÄŚe se vam to zdi preteĹľko, je najenostavnejša rešitev ta, da enostavno doloÄ?ite |
||||
|
||||
$statut = STUDENT; in dodeljute upravljalcu teÄ?aja pravice preko administracijske sekcije portala. </p> |
||||
<p> <b>ZašÄ?iteni LDAP streĹľniki</b><br /> |
||||
Nekateri LDAP streĹľniki ne podpirajo anonimne uporabe direktorijskih storitev |
||||
|
||||
V tem primeru, potrebujete dodatno programsko kodo, ki bo povezovala LDAP z uporabniškim imenom in geslom - koda je zagotovljena, |
||||
|
||||
le vprašajte na forumu ali jo zahtevajte preko e-pošte. </p> |
||||
<p> |
||||
<hr> |
||||
Kontaktni naslov: Dokeos, 44 rue des palais, B-1030 Brussels, Belgium<br /> |
||||
E-pošta: info@dokeos.com |
||||
<hr> |
||||
</p> |
||||
</div> |
||||
</div> |
||||
</body> |
||||
</html> |
||||
Loading…
Reference in new issue