From Claroline Documentation

Table of contents

١ مقدمة ٢ قبل إعداد البرنامج ٢.١ متطلبات النظام ٢.١.١ انظمة التشغيل ٢.١.٢ مخدم الانترنت ٢.١.٣ لغة PHP ٢.١.٤ MYSQL مخدم قاعدة البيانات ٢.١.٥ Rights on folders ٢.١.٦ مخدم البريد الإلكتروني ٢.٢ MySql متطلبات ٢.٢.١ tables repository ٢.٢.١.١ الجداول الأساسية ٢.٢.١.٢ جداول المقررات ٢.٣ على القرص الصلب ٢.٤ File system right

مقدمة

هذه الصفحة موجهة لمدراء المواقع و ليش للمطورين و لكنها قد تحوي بعض الملاحظات الخاصة بالمطورين .

قبل إعداد البرنامج

متطلبات النظام

قبل كل شئ لا تنسى قراءة الملف install.txt الذي يحوي معلومات هامة عن إعداد البرنامج .

انظمة التشغيل

تحتاج لأحد أنظمة التشغيل التالية:

• لينكس / BSD / يونكس (*)
• ويندوز (9x, Me, NT4, 2000, 2003, XP)
• ماكنتوش .

ملاحظة

• نقوم عادة باختبار النظام على توزيعة لينكس Debian (النسخة المستقرة) و على توزيعة لينكس Mandrake و لكن من اجل بقية التوزيعات فيفترض ان يعمل البرنامج بشكل صحيح. و قد تلقينا ردود إيجابية من قبل مستخدمين يعملون على توزيعة لينكس Red Hat و توزيعة Suse , فلا تتردد بالاتصال بنا عند حصول أي مشكلة على أي توزيعة اخرى من توزيعات نظام التشغيل لينكس .

مخدم الانترنت

ننصح باستخدام مخدم Apache مع العلم ان البرنامج يعمل على المخدمات التالية:

• Apache 1.3 or 2.0
• Microsoft IIS

لغة PHP

يلزم لعمل البرنامج استخدام لغة PHP (الإصدار 4.1 و ما فوق ) مع إعداد الوحدات التالية ضمنها :mysql, zlib, preg. معظم توزيعات لغة PHP تأتي مع دعم مسبق لهذه الوحدات و بكل الاحوال فإن برنامج الإعداد يقوم بتفحص الإعدادات .

قد تظهر بعض المشاكل عند المستخدمين إذا كانت اعدادت لغة PHP لديهم لا تنسجم مع الإعدادات التالية :

short_open_tag       = On
register_globals     = On
safe_mode            = Off
magic_quotes_gpc     = On
magic_quotes_runtime = Off
error_reporting      = E_ALL & ~E_NOTICE (*)

ملاحظات

• المستخدمون الذين يعملون على الإصدار 4.2 او أقل يجب عليهم وضع المتغير register_global بوضعية on.

register_globals = On

• المستخدمون الذين يعملون على الإصدار 4.3 او أقل يجب عليهم وضع الإعداد التالي أيضاً.

magic_quotes_gpc = On

• من الممكن تغيير الإعداد error_reporting لمستوى أقل و ليس لمستوى اعلى.

MYSQL مخدم قاعدة البيانات

You must have a MySQL databases server and a login/password allowing to administrate and create at least one database. By default, Claroline will create a single database wich contains all courses created. If you want to use Claroline on a 'multiple databases host' you have to select this option on purpose at installation. It means your host should allow you to create and administrate several databases.

تحذير

• If you use the single database install option, it is recommended to use this database for Claroline use only. If you share this database with other applications, interferences could occurs between table names of both applications that could result in serious problems.

ملاحظة

• The backticks characters (`) inserted inside most of the Claroline SQL queries since Claroline 1.3 doesn't work with MySQL versions previous to 3.23.6.

ملاحظات هامة

• Claroline works with only one server and only one account.
• Claroline need at least one database.
• With installation option single database, Claroline is hack to be able to work with an account wich can't create databases
• With installation option multi databases, Claroline is build with the idea that the account can create databases.

Rights on folders

Give write access to web directory where claroline has been moved or unzipped to. Remotely, you need to be allowed to change rights permissions on folders and files through FTP, telnet, ssh or any means.

If you don't want to set write access on the whole folders, it's recommended for security reasons. Give to the web server user write access on these folders :

• With Claroline 1.5.x :
  • / (root directory)
  • /claroline/admin
  • /claroline/sql
  • /claroline/claroline_garbage
  • /claroline/lang

• With Claroline 1.6.x :
  • / (root directory)
  • courses
  • claroline/admin
  • claroline/sql
  • claroline/claroline_garbage
  • claroline/lang

مخدم البريد الإلكتروني

A mail server as called Mail Transport Agent (MTA).

This not absolutely necessary but some Claroline features will remain silent if you don't provide MTA.

• Most GNU/Linux distributions provide MTA (Sendmail, Exim, Qmail, PostFix, ...).
• On MS Windows machines, no MTA are provided by default. You can either modify the configuration file php.ini to redirect mail to an MTA available on an other machine, or install an MTA on the Claroline server. Several MTA are available for MS Windows (Blat, Netmail95, WMailto , Hamster ...).

MySql متطلبات

tables repository

Claroline need 2 types of tables repository (in one or several databases).

1. Main tables
2. Course tables

الجداول الأساسية

There are tables:

• Central (users, tools list, ...).
• Statistics of the platform.

These tables are created in one database.

جداول المقررات

There are tables for:

• Course tools.
• Groups.
• Statistics of the course.

Claroline is built to have one table for each "course-tool" pair. So table for chat in course foo is not the same table for course bar.

This means that there will be many tables. It's more user-friendly to have one database for each course but before install we don't know how many courses would be created. So Claroline need a user with database creation rights. (it's multi databases option at the installation)

A lot of mysql administrator would find it crazy: 'haw, give db creation rights to my users ... NO!'

If the administrator holds still on their position, you can request one database and shake all tables of courses in the same database. (it's the single database option at the installation)

Note to the administrators

A very good solution is to request a right to create databases with a fixed prefix.

• Create a user with less right as possible (nothing)
• Give all access for this user on db 'foo%'

With these rights, the account can create all databases he need but all these databases must begin with foo name. You can set this database name prefix at the installation.

Note to the developers

The solution for administrators, is also a great if you need to run many claroline platforms on the same machine. Personally we have a user called "claroline" with a password. The rights for this user is "all" on "claro%" database. And when we install a claroline, we set as prefix "clarofoo" where "foo" is our checkout name.

على القرص الصلب

claroline need to be in the web space.

So claroline contains:

• index.php.
• Some html files.
• Claroline sub-folders and scripts.
• Readme and licence files.

So if you want that claroline isn't the only "tool" on the website, it's better to create a subdir in your document root.

It gives something like:

i.e.

• The document root is /var/www/html/

cd /var/www/html/
mkdir mycampus
cd mycampus

• Place in mycampus subfolder the content of archive (or cvs checkout for the developers).

File system right

To manage files of Claroline, use an account member of group of your webserver process.

i.e.

• Debian GNU/Linux

addgroup paul www-data

• Mandrake GNU/Linux

addgroup paul apache