Config OFBiz to use MS SQL Server express 2005

ในบทความนี้จะแบ่งการทำงานออกเป็น 4 ส่วนดังนี้

1. การติดตั้ง JDBC Driver ของ SQL Server 2005
2. การเซ็ตอัพ OFBiz
3. การ install entity และข้อมูล ของ OFBiz ทั้งหมดลงใน SQL Server 2005
4. ตรวจสอบ

1. การติดตั้ง JDBC Driver ของ SQL Server 2005

สิ่งที่ต้องมี
1.Microsoft SQL Server 2005 Express Edition
2. SQL Server Management Studio Express
3. Microsoft SQL Server 2005 JDBC Driver 1.2

4. OpenTaps 1.0.0 (ในบทความนี้ใช้ OpenTaps แทนตัว OFBiz เนื่องจากต้องการตัดปัญหาเรื่องการติดตั้งไปก่อน)

ขั้นตอน

1. ให้ Unpack JDBC Driver ที่ได้ Download มา ลงไปที่ใดก็ได้ที่คุณต้องการ จากนั้น เข้าไปดูใน folder
%JDBC_Installfolder%\Microsoft SQL Server 2005 JDBC Driver\sqljdbc_1.2\enu\
(โดย %JDBC_Installfolder% คือ ที่ที่ได้ทำการ Unpack JDBC Driver ลงไป)
จะพบไฟล์ sqljdbc.jar ให้คัดลอกไฟล์ดังกล่าวไปไว้ที่
%Opentaps_Installfolder%\framework\entity\lib\jdbc\
(เช่นเดียวกัน %Opentaps_Installfolder% คือ ที่ที่ได้ทำการติดตั้ง Opentaps)

2.ให้คัดลอกไฟล์ที่ชื่อ sqljdbc_xa.dll ที่อยู่ในโฟลเดอร์
%JDBC_Installfolder%\Microsoft SQL Server 2005 JDBC Driver\sqljdbc_1.2\enu\xa\x86\
ไปไว้ที่
%SQLServer_Installfolder%\Microsoft SQL Server\MSSQL.1\MSSQL\Binn\
ซึ่งเป็นไฟล์ช่วยให้ Java application สามารถสร้างหลายๆ transaction ได้พร้อมกัน

3. เปิด SQL Management Studio express แล้ว login เข้าไปใน instance ของ SQL Server ที่เราต้องการใช้งานร่วมกัน OFBiz

4. จากนั้นให้ให้เปิดไฟล์ xa_install.sql ใน Studio express โดยไฟล์นี้จะอยู่ใน
%JDBC_Installfolder%\Microsoft SQL Server 2005 JDBC Driver\sqljdbc_1.2\enu\xa\
แล้วจากนั้นให้กดปุ่ม F5 เพื่อทำการ Execute จากนั้นเราก็จะได้ Extended Stored Procedures ในฐานข้อมูล Master ของ SQL Server โดยถ้าเราเข้าไปดูภายในโฟลเดอร์ Extended Stored Procedures จะเห็น Procedures ดังรูป


5. ทำการสร้าง Database ใหม่ชื่อว่า ofbiz
6. ทำการสร้าง login ใหม่ที่ชื่อว่า ofbiz โดยตั้ง password เป็นอะไรก็ได้ (เพียงแต่เราต้องจำเอาไว้เพื่อไป config ต่อในส่วนของ ofbiz) จากนั้นให้ เพิ่ม User ที่ชื่อ ofbiz ที่เพิ่งสร้างนี้เข้าไปใน Database ที่ชื่อ ofbiz นี้ด้วย (ชื่อ login กับ Database จะเหมือนกัน)

2. การเซ็ตอัพ OFBiz

1. ให้เปิดไฟล์ entityengine.xml ซี่งอยู่ในโฟลเดอร์
%Opentaps_Installfolder%\framework\entity\config\
แล้วให้เลื่อนหน้าจอลงมาจนถึงบรรทัดที่เขียนว่า

datasource name="localmssql"
ในที่นี้ให้เราทำการ Config ดังนี้

jdbc-uri="jdbc:sqlserver://localhost:1475;databaseName=ofbiz;SelectMethod=cursor;"

ในบรรทัดนี้ให้ปรับชื่อ server และ port ที่ SQL Server ใช้งานอยู่ให้ถูกต้อง โดยในที่นี้ SQL Server จะทำงานบน localhost และใช้พอร์ตเบอร์ 1475

jdbc-password="ofbiz"

ในบันทัดนี้ก็ให้เปลี่ยน password ให้ตรงกับ login ที่ชื่อว่า ofbiz ที่เราเพิ่งสร้างไปในขั้นตอนที่แล้ว

จากนั้นให้เลื่อนหน้าจอขึ้นไปด้านบนจนพบบันทัดที่ว่า

group-map group-name="org.ofbiz" datasource-name="localderby"

จากนั้นให้เปลี่ยน datasource-name จาก localderby ให้เป็น localmssql โดยจะต้องแก้อยู่ประมาณสาม delegator ซึ่งมีชื่อว่า "default" "default-no-eca" และ "test"

3. การ install entity และข้อมูล ของ OFBiz ทั้งหมดลงใน SQL Server 2005

1. ให้เข้า command prompt แล้วเลือกไปที่โฟลเดอร์ที่เรา install Opentaps ไว้
2. จากนั้นให้เรารันคำสั่ง ant run-install-seed เพื่อทำการสร้าง Schema ของ OFBiz ทั้งหมด พร้อมทั้ง "seed" ข้อมูลเข้าไปใน Schema ที่เราได้สร้างไว้แล้ว

4. ตรวจสอบ

1. คราวนี้ให้เราลองไปตรวจสอบใน Studio Express กันดูว่าฐานข้อมูลที่เราเพิ่งสร้างมานั้นมี Table และข้อมูลเพิ่มขึ้นมาหรือไม่

จะเห็นว่ามี Table จำนวนมหาศาลเกิดขึ้นมาพร้อมทั้งข้อมูลที่ถูก Insert เข้ามาด้วย

2. คราวนี้ลองรันคำสั่ง startofbiz.bat ที่อยู่ในโฟลเดอร์ของ OpenTaps ดู แล้วเข้าไปใน uri นี้
https://localhost:8443/webtools/control/entitymaint
แล้ว login ด้วย username:admin password:ofbiz จะพบหน้าจอแสดง entity ทั้งหมดของ ofbiz (ซึ่งสร้างอยู่ใน SQL Server)