ลง DSpace บน Ubuntu

อ้างอิงมาจากคู่มือของ DSpace เขียนแบบขำๆ นะครับ

เริ่มจากเตรียม Package ที่จำเป็นก่อน

• Java ทั้งหลายแหล่
• tomcat [อันนี้คิดว่าคงต้องลงด้วยมือ]
• ant
• maven2
• perl
• DB Engine แนะนำ Postgresql ไม่งั้นก็ต้องใช้ Oracle

เริ่มกันเลยดีกว่า

1. สร้าง user สำหรับ dspace (ใช้ชื่ออื่นก็ได้นะ) ทั้งบน linux และบน postgresql (อย่าลืมให้อำนาจใน db เยอะๆ ฮ่าๆๆๆ)
2. แก้ไฟล์ dspace.cfg ซึ่งอยู่ที่ <<install_folder>>/dspace/config/dspace.cfg
   • แก้ dspace.dir ให้เป็นปลายทางที่ต้องการลง พอตอนมันทำ ant fresh_install แล้วมันจะก๊อปไฟล์ไปลงให้ตรงนั้นอัตโนมัติ (ถ้าไม่คิดอะไรใช้ default คือ /dspace ก็พอได้อยู่)
   • แก้ dspace.url อย่าลืมเช็ค hostname,  port ของ Tomcat ที่ตั้งค่าไว้ (ปกติอยู่ที่ 8080) และเช็ค path ของ url ด้วย
   • แก้ hostname ถ้าใช้เล่นเครื่องตัวเองก็ไม่เป็นไร
   • แก้ db.name ถ้าใช้ postgresql ก็ uncomment บรรทัดของ postres แล้ว comment db.name = ${default.db.name}
   • ตั้ง db.username และ db.password จัดไปให้ตรงกับ user ที่ตั้งไว้
   • เซต  mail server (mail.server, mail.server.port, mail.server.username กับ mail.server.password ) ถ้าไม่มีก็ใช้ GMail เป็น SMTP Server ก็ได้
   • เซตเมล์แสดงผล (mail.from.address, feedback.recipient, mail.admin, registration.notify) เป็น mail ที่ต้องการ (ถ้าเราใช้ GMail อันบนก็เซตให้เป็นอันเดียวกันไปเลยทั้งหมดก็ได้ ง่ายดี)
   • เป็นอันเสร็จเรียบร้อยสำหรับการตั้งค่าบน dspace.cfg

   Tip: ถ้าต้องการเซตค่าเดียวกัน ใช้ ${<<ตัวแปร>>} ในการ Assign ค่าแทนได้ ตัวอย่างเช่น ถ้าต้องการใช้ mail.admin เป็นอันเดียวกันกับ mail.from.address ก็เซตอย่างนี้:
   mail.admin = ${mail.from.adress}

3. เปลี่ยนให้ folder ที่ถูก unzip มาเป็นของ user ของ dspace ทั้งหมด
   sudo chown -R <<user>> dspace
4. เริ่มลากยวงขโยง dependency ทั้งเหล่าออกมาด้วยการ:
   sudo su <<user>>
   cd <<install_folder>>/dspace
   mvn package
5. นอน และนี่คือผลลัพธ์:
   [INFO] Copying 851 files to <<install_folder>>/dspace/target/dspace-1.5.1-build.dir
   [INFO]
   [INFO]
   [INFO] ————————————————————————
   [INFO] Reactor Summary:
   [INFO] ————————————————————————
   [INFO] DSpace Addon Modules ……………………………. SUCCESS [7:54.515s]
   [INFO] DSpace XML-UI (Manakin) :: Web Application ………… SUCCESS [44:26.957s]
   [INFO] DSpace LNI :: Web Application ……………………. SUCCESS [2:19.438s]
   [INFO] DSpace OAI :: Web Application ……………………. SUCCESS [32.244s]
   [INFO] DSpace JSP-UI :: Web Application …………………. SUCCESS [1:23.730s]
   [INFO] DSpace SWORD :: Web Application ………………….. SUCCESS [43.660s]
   [INFO] DSpace Assembly and Configuration ………………… SUCCESS [2:20.377s]
   [INFO] ————————————————————————
   [INFO] ————————————————————————
   [INFO] BUILD SUCCESSFUL
   [INFO] ————————————————————————
   [INFO] Total time: 59 minutes 41 seconds
   [INFO] Finished at: Fri Sep 26 23:39:12 ICT 2008
   [INFO] Final Memory: 19M/38M
   [INFO] ————————————————————————
6. มันควรจะบังเกิด folder <<install_folder>>/dspace/dspace-<<install version>>.build.dir มาถ้า mvn สำเร็จ
7. สั่ง ant fresh_install แล้วก็ไล่แก้ error ที่ออกมาทีละตัว
   • ถ้า error สร้าง path /bin คิดว่าน่าจะเป็นที่ permission ให้ไปแก้ owner หรือ chmod ซะ
   • database dspace does not exist ก็เข้าไปสร้าง database ซะ (สั่ง createdb dspace)
   • ถ้าเจอ error ประหลาดของ ant ก็เพิ่มแพ็คเกจ ant-optional (sudo apt-get install ant optional)
   • ตอนนี้ที่คยเจอจะประมาณนี้ถ้าเจออย่างอื่นจะโพสอีกที

   ซึ่งถ้าลงสำเร็จมันจะบังเกิดหน้าจอสรุปประมาณนี้
   [echo] ====================================================================
   [echo]  The DSpace code has been installed, and the database initialized.
   [echo]
   [echo]  To complete installation, you should do the following:
   [echo]
   [echo]  * Setup your Web servlet container (e.g. Tomcat) to look for your
   [echo]    DSpace web applications in: /dspace/webapps/
   [echo]
   [echo]    OR, copy any web applications from /dspace/webapps/ to
   [echo]    the appropriate place for your servlet container.
   [echo]    (e.g. ‘$CATALINA_HOME/webapps’ for Tomcat)
   [echo]
   [echo]  * Make an initial administrator account (an e-person) in DSpace:
   [echo]
   [echo]    /dspace/bin/create-administrator
   [echo]
   [echo]  * Start up your servlet container (Tomcat etc.)
   [echo]
   [echo]  You should then be able to access your DSpace’s ‘home page’:
   [echo]
   [echo]    http://localhost:8080/jspui
   [echo]
   [echo]  You should also be able to access the administrator UI:
   [echo]
   [echo]    http://localhost:8080/jspui/dspace-admin
   [echo] ====================================================================
   [echo]

   BUILD SUCCESSFUL
   Total time: 10 seconds

8. เข้าไปแก้ไฟล์ context เพื่อให้ tomcat รู้จัก dspace โดยเพิ่มโค้ดประมาณนี้ลงไปใน $CATALINA_HOME/conf/server.xml ภายใต้แท็ก <Host> ($CATALINA_HOME หมายถึงที่อยู่ของ tomcat เช่น /opt/tomcat6 ถ้าวาง tomcat ไว้ที่อื่นมันก็จะอยู่ที่อื่น)

   <!-- DEFINE A CONTEXT PATH FOR DSpace JSP User Interface  -->
   <Context path="/jspui" docBase="<<dspace target install folder>>/webapps/jspui" debug="0"
   	reloadable="true" cachingAllowed="false"
   	allowLinking="true"/>
   
   <!-- DEFINE A CONTEXT PATH FOR DSpace OAI User Interface  -->
   <Context path="/oai" docBase="<<dspace target install folder>>/webapps/oai" debug="0"
   	reloadable="true" cachingAllowed="false"
   	allowLinking="true"/>

   ถ้าจะ deploy SWORD เพิ่มก็เพิ่ม context ลงไปได้เองเลย

9. chmod โฟลเดอร์ upload กับ assetstore ให้เป็นอะไรที่ชาวบ้าน write ได้ (777 ไปเลยก็ได้ถ้าขี้เกียจ)
10. สร้าง admin เข้าไปที่ <<dspace target install folder>>/bin แล้วสั่ง create-administrator ตามๆ เขาไปเรื่อยๆ
11. start tomcat แล้วเข้าไปยลโฉมผลงาน