====== إعداد موقعك  <Updated date="18-Mar-2008 by Kamal Salih"/> ======

لكي يعمل Greenstone بشكل صحيح ، فان تراخيص النفاذ لملفات معينة يجب أن تعد بشكل ملائم. ايضا ، يوجد ملف إعداد مرتبط بموقع Greenstone .إجراء التثبيت الاجراء يخلق ملف إعداد عام بناءا على ما قمت في إختيارات التثبيت ؛ ومهما يكن من محتوياته ، فانه أن يفصل  لمواجهة الحالات المختلفة. يفسر هذا القسم كلا من هذه القضايا. <Updated date="18-Mar-2008 by Kamal Salih"/>

===== ملف التراخيص  <Updated date="18-Mar-2008 by Kamal Salih"/> =====

وهذا القسم لا يهم لويندوز 95/98 Windows، لأن هذه النظم لا تحدد اصحاب الملفات.<Updated date="18-Mar-2008 by Kamal Salih"/>

في بيئة  ويندوز Windows NT, 2000، وانظمة يونيكس ، نصوص CGI لا تعمل  كمستخدمين عاديين ، لان المستخدمين لا يمكن تعريفهم في الويب . وبدلا من ذلك ، فانها تعاملهم كالمستخدم الذي بدأ تشغيل برنامج مزود الويب (علي نظم ويندوز Windows ) ، او بوصفه مستخدم خاص (يطلق عليه “//nobody//” على أنظمة يونيكس Unix ). ولهذا السبب ، فان جميع الملفات والادله ضمن  //C:\Program Files\gsdl// يجب أن تكون مقروءة  (أو على الأقل يمكن قراءتها من قبل مستخدم نص- CGI ، وربما  “//nobody//”"). لاختبار أن ضبط إعداد ملف التراخيص قد تم بشكل صحيح ، قم بتشغيل برنامج //library.exe// من أوامر  السطر. إذا كانت الملفات في الاماكن الصحيحه ولكن التراخيص لم تعد بصورة سليمة ، سوف تعمل من أوامر  السطر - أي عندما تقوم//أنت// بتنفيذه. ولكن ليس من المتصفح- وهذا يعني ، عندما يقوم المستخدم " “//nobody//”" بتنفيذه. اختبار آخر و هو الدخول كمستخدم آخر لمعرفة ما اذا كان ملف التراخيص قد تم إعداده للمستخدم الأصلي فقط." <Updated date="18-Mar-2008 by Kamal Salih"/>

لكي تعمل من خلال متصفح الويب ، فان جميع أدلة Greenstone لا بد من إتاحة قراءتها. ايضا دليل  //C:\Program Files\gsdl\etc//وجميع محتوياته يجب ان تكون قابلة للكتابة .//writable// وهذا هو الدليل الذي يكتب فيه برنامج المكتبه مدونات الاستعمال،مدونات الخطأ والتهيئه،ومختلف قواعد بيانات المستعملين. إذا كنت مترددا في جعل هذا الدليل قابل للكتابة ، يمكنك تعيين التراخيص و تعين الملفات التالية للكتابة //errout.txt//, //initout.txt//, //key.db//, //users.db//, //history.db// و //usage.txt//، //users.db //.لمستخدم  CGI .<Updated date="18-Mar-2008 by Kamal Salih"/>

اذا لم يعد ملف التراخيص بصورة صحيحة لـ //C:\Program Files\gsdl\etc// ، قد تجد ان ترخيص المستخدم وتاريخ البحث لا يعملان ، ولذلك لا توجد مدونة الإستخدام ولم يتم توليد ملف (//usage.txt//) . <Updated date="18-Mar-2008 by Kamal Salih"/>

===== ملف الإعداد gsdlsite.cfg   <Updated date="18-Mar-2008 by Kamal Salih"/> =====

إجراء التثبيت  يخلق ملف إعداد عام بناءا على ما قمت به في إختيارات التثبيت. بالنسبة لتثبيتنا هذا هو الملف //C:\Program Files\gsdl\cgi-bin\gsdlsite.cfg// و محتوياته هي : <Updated date="18-Mar-2008 by Kamal Salih"/>

<code>
# Site configuration file for Greenstone.
# Lines begining with
# are comments.
# This file should be placed in the same directory as your library
# executable file. it should be edited to suit your site.
# points to the GSDLHOME directory
gsdlhome “C:/Program Files/gsdl ”
# this is the http address of GSDLHOME
# if your webservers DocumentRoot is set to $GSDLHOME
# then httpprefix can be commented out
httpprefix /gsdl
# this is the http address of the directory which
# contains the images for the interface.
httpimg /gsdl/images
# should contain the http address of this cgi script. This
# is not needed if the http server sets the environment variable
# SCRIPT_NAME
#gwcgi         /cgi-bin/library
# maxrequests is the most requests a fastcgi process
# will serve before it exits. This can be set to a
# low figure (like 1) while debugging and then set
# to a high figure (like 10000) when everything is
# working well.
#maxrequests 10000
</code>

يمكنك تعديل التثبيت الخاص بك بتعديل هذا الملف ، رغم انك ربما لن تحتاج الى ان تفعل ذلك. <Updated date="18-Mar-2008 by Kamal Salih"/>

يشير السطر //gsdlhome // الى دليل//C:\Program Files\gsdl//  <Updated date="18-Mar-2008 by Kamal Salih"/>

//httpprefix // هو عنوان الويب للدليل الذي يثبت فيه  Greenstone . سابقا شرحنا كيفية تهيئة الاسم المستعار حتى ان عناوين المواقع على شكل // http:%%//%%localhost/gsdl/ //... يبحث عنها في دليل  //C:\Program Files\gsdl// .ووضع سطر //httpprefix/gsdl// في ملف الإعداد //gsdlsite//   يضع التقليد نفسه لبرامج Greenstone . <Updated date="18-Mar-2008 by Kamal Salih"/>

//httpimg // هو عنوان الويب لدليل//C:\Program Files\gsdl\images//  ، الذي يحتوي على جميع صور gif المستخدمة فى الواجهة.في أي تثبيت معياري لـ Greenstone سيكون هذا دائما //httpprefix/images// ، والسطر في الملف أعلاه يبقى دون مساس. <Updated date="18-Mar-2008 by Kamal Salih"/>

//gwcgi // هو عنوان الويب لمكتبة برنامج    CGI .و هذا ليس مطلوبا من جانب معظم مزودات الويب webservers (بما في ذلك اباتشي Apache ) ، وينبغي أن تظل كما هي .لا تجري أي تعديل ما لم تكن متاكدا من انك بحاجة اليه ، لان ذلك قد يحدث المشاكل. <Updated date="18-Mar-2008 by Kamal Salih"/>

//maxrequests// هي تستخدم  فقط مع إصدارة Greenstone التي يتم تجميعها باستخدام خيار “fast-cgi” .التوزيع الثنائي المعياري  لا يشمل هذا الخيار لان كل مزودات الويب لا تتم تهيئتها  لدعمه . يسرع  “fast-cgi”  تنفيذ الـ CGI بالإحتفاظ بملف التنفيذ الرئيسي  في الذاكرة بدعوة البرنامج ، بدلا من تحميله في كل مرة من القرص عندما تطلب  صفحة ويب برنامج  Greenstone.وتكون  المفاضله في مقدار الذاكرة المستخدم ،و التي يمكن أن تنمو بطول بقاء البرنامج في الذاكرة. بمجرد أن يتم توليد صفحات //maxrequests//  ،فان برنامج CGI يخرج ، وبذلك تحرر الذاكرة المتراكمة. للرد على الطلب التالي لصفحة ويب ، فان برنامج CGI يقوم بالقراءة من القرص مرة أخري ،و بالتالي تبدأ دورة جديدة من الصفحات المطلوبة.في معظم التثبيتات يستخدم بروتوكول CGI  المعياري ، وهو ما يعني ان //maxrequests//  يمكن أن نتجاهلها بأمان.<Updated date="18-Mar-2008 by Kamal Salih"/>