إعداد موقعك <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"/>

# 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

يمكنك تعديل التثبيت الخاص بك بتعديل هذا الملف ، رغم انك ربما لن تحتاج الى ان تفعل ذلك. <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"/>