provis webservice version 2.0neo.moph.go.th/jhcis/manualwebservice20120326.pdf ·...
TRANSCRIPT
P R O V I S W E B S E R V I C E P a g e | 1
คมอการตดต งและการใชงาน
PROVIS WEBSERVICE
Version 2.0.5
Server (หนา 2) Jhcis (หนา 13)
P R O V I S W E B S E R V I C E P a g e | 2
ตวอยางในคมอนสามารถใชไดสาหรบ Fedora และ Centos
1. ตดตง java (หนา 3)
3. ตดตง tomcat (หนา 5)
4. ปรบแตง tomcat (หนา 6)
5. Deploy web service (หนา 8)
การตดต ง web service server
2. กาหนดคาใน iptables (หนา 5)
6. กาหนดรหสผานและสทธให user (หนา 11)
P R O V I S W E B S E R V I C E P a g e | 3
1. Download java http://www.oracle.com/technetwork/java/javase/downloads/index.html
เลอก jre
Accept License Agreement และ คลก download java ตาม platform ของ server ทจะนาไปตดตง จากตวอยางเรา download เปน rpm package
1. ตดต ง java
P R O V I S W E B S E R V I C E P a g e | 4 2. ตดตงดวยคาสง
rpm –ivh jre-xxx.rpm
3. Run คาสง
# export JAVA_HOME=/usr/java/jre1.7.0_03 # export PATH=$JAVA_HOME/bin:$PATH หมายเหต directory jre1.7.0_03 คอ version ของ java ทตดตงในคมอ หาก เปน version อนให เปลยน
4. แกไข file /etc/profile โดยเพมคาสงเหลานลงไป export JAVA_HOME=/usr/java/jre1.7.0_03 export PATH=$JAVA_HOME/bin:$PATH
5. ตรวจสอบ version ของ java ดวยคาสง java –version
P R O V I S W E B S E R V I C E P a g e | 5
1. หาก iptables ยงไมได allow port 8080 และ 8443 ใหเพมเขาไป
1. Download tomcat rpm ท http://provis.moph.go.th/tomcat6/tomcat-6.0.24-
0.noarch.rpm 2. ตดตงดวยคาสง rpm –ivh tomcat-6.0.24-0.noarch.rpm
หมายเหต ในกรณทระบบปฏบตการแจงเตอนวา ตองการโปรแกรมระบบทเกยวของในการตดตง (error: Failed dependencies) ใหเตม --nodeps --nomd5 ลงไปดวย ตวอยางเชน rpm -ivh --nodeps --nomd5 tomcat-6.0.24-0.noarch.rpm
3. Allow port 8080 และ 8443 ใน firewall และโทรแจง สรอ. (สบทร.) ให unblock สอง port นดวย
4. Start service ดวยคาสง /etc/init.d/tomcat start 5. ทดสอบดวยการเปด web browser เพม http://xxx.xxx.xxx.xxx:8080
6. เพม service และตง auto start tomcat ดวยคาสง
3. ตดต ง tomcat
chkconfig --add tomcat chkconfig tomcat on
2. กาหนดคา iptables
P R O V I S W E B S E R V I C E P a g e | 6
1. ปรบแตง performance Edit /tomcat_dir/bin/catalina.sh (ถาตดตง rpm ตามคมอ จะอยท /opt/tomcat/ ) เพม code ดานลางลงไป หากมอยแลวใหแกไข การกาหนด memory ใหพจารณาตามความเหมาะสมตามสภาพแวดลอมนนๆ หมายเหต ถาไมสามารถสงรน tomcat ไดใหลองปรบเปลยนคา –Xms และ –Xmx
เสรจแลวให restart tomcat เพอใหเกดผล /etc/init.d/tomcat restart 2. กาหนดคา SSL ใน tomcat
Generate keystore file โดยใช keytool ทใหมากบ java โดยมขนตอน ดงน 1. cd ไปท JAVA_HOME (path ขนอยกบ version)
windows
linux
2. ใชคาสงดงนโดยพมพตอเนองเปนบรรทดเดยวกน
• ใหแทนท abc123 ดวยรหสผาน (password) ของทานเอง • เมอเสรจแลว key จะถกสรางไวท /opt/tomcat • ในระบบปฏบตการวนโดวส ใหระบตาแหนงทอยของ tomcat ใหถกตอง เชน
C:\Program Files (x86)\Apache Tomcat\provis.bin
ทมา : http://techtracer.com/2007/09/12/setting-up-ssl-on-tomcat-in-3-easy-steps/
4. ปรบแตง tomcat
CATALINA_OPTS="-Xms128m -Xmx1024m -XX:PermSize=64m -XX:MaxPermSize=128m -Xss2m -XX:+UseConcMarkSweepGC -XX:+CMSClassUnloadingEnabled -XX:+CMSPermGenSweepingEnabled -Dfile.encoding=UTF-8" export CATALINA_OPTS
cd C:\Program Files (x86)\Java\jre6\bin
keytool -genkey -alias provis -keypass abc123 -keystore /opt/tomcat/provis.bin -storepass abc123
cd /usr/java/jre1.7.0_03/bin/
P R O V I S W E B S E R V I C E P a g e | 7
3. กรอกขอมลทใชในการสราง key
4. แกไขไฟล /opt/tomcat/conf/server.xml โดยเพม บรรทดดานลางนลงไปภายใต tag <Service name="Catalina">
3. กาหนด tomcat user เพอใชจดการ tomcat แกไขไฟล /opt/tomcat/conf/ tomcat-users.xml เพม บรรทดดานลางนกอน </tomcat-users>
จากตวอยาง user คอ admin และ password คอ 123456
<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
maxThreads="150" scheme="https" secure="true"
clientAuth="false" sslProtocol="TLS"
keystoreFile="/opt/tomcat/provis.bin"
keystorePass="abc123" />
<role rolename="manager"/> <user name=”admin" password=”123456" roles="manager" />
What is your first and last name? [Unknown]: weerayuth momotalo What is the name of your organizational unit? [Unknown]: pcu What is the name of your organization? [Unknown]: health What is the name of your City or Locality? [Unknown]: bangkok What is the name of your State or Province? [Unknown]: bangkok What is the two-letter country code for this unit? [Unknown]: TH Is CN= weerayuth momotalo, OU= pcu, O= health, L= bangkok, ST= bangkok, C=TH correct? [no]: yes
P R O V I S W E B S E R V I C E P a g e | 8
1. Download PROVISWS.war ท http://provis.moph.go.th/works/webservice/ 2. เขาหนา tomcat ท http://xxx.xxx.xxx.xxx:8080
เลอก link tomcat manager พรอมกรอก พรอมกรอก user และ pass ทตงเอาไวใน file tomcat-users.xml ในขนตอนกอนหนาน
3. เมอเขามาในหนา manager แลวให scroll page เลอนลงมาในสวนของการ deploy คลกป ม เลอกไฟล เพอเลอก PROVISWS.war แลวคลก Deploy
5. Deploy web service
P R O V I S W E B S E R V I C E P a g e | 9
4. หาก deploy สาเรจ ใหสงเกตในสวน Applications จะพบวา PROVISWS ถกด deploy แลว และใหสงเกตในคอลมน running หากเปน true แสดงวา โปรแกรมพรอมใชงาน
5. คลกป ม stop
6. กาหนดคาการเชอมตอฐานขอมลโดยแกไขไฟล /opt/webapps/PROVISWS/WEB-INF/classes/hibernate.cfg.xml - Host / IP - Port - Database - Username - Password
7. กลบไปทหนา tomcat manager แลวคลกป ม start
P R O V I S W E B S E R V I C E P a g e | 10
8. คลกท link PROVISWS
9. ถาไมมอะไรผดพลาดจะขนหนาเวบ provis web service และถากาหนดคาการเชอมตอฐานขอมลในขอท 6 ถกตองและฐานขอมลใชการได ในสวนของ server status จะแจงวาเชอมตอฐานขอมลแลว พรอมแสดงชอจงหวดของทาน
P R O V I S W E B S E R V I C E P a g e | 11
เวบเซอรวสตงแต Version 2.0.5 ขนไป User ทใชในการเชอมตอ web service เปน user ชดเดยวกนทใชใน web provis ซงคาเรมตนของ user คอ u + pcucode และ password คอ p + pcucode และมสทธในการเขาถง web service ซงไมปลอดภย เราแนะนาใหทานเปลยน password และกาหนดสทธใหม
การจดการ User
1. เขาไปในหนา web provis แลว login ในสวนของผดแลระบบ เลอนหนาเวบลงมาจนถงสวนของ ขอมลผใชงาน
2. เมอคลกใน menu นกจะสามารถจดการ user ทงหมดได
6. กาหนดรหสผานและสทธให user
P R O V I S W E B S E R V I C E P a g e | 12 การกาหนดให user มสทธในการใชงาน webservice
ในการเพมและแกไข user ทานสามารถกาหนดสทธในการใชงาน webservice เปนบาง user ไดโดย ทาเครองหมายถกหนาชองเวปเซอร วส อนๆ ในสวนของสทธการใชงาน ตามรปภาพดานลาง
หากไมตองการให user ใดใชงาน web service กใหเอาเครองหมายออก
P R O V I S W E B S E R V I C E P a g e | 13
1. ทหนารบบรการใน jhcis ใหคลกป ม ประวตบรการจาก Provis Server
2. หากเปนการใชงานครงแรก หรอ เคยใชงานแลวแตมปญหาในการเชอมตอกบ server หนาตางกาหนดคาการเชอมตอจะแสดงขนมาโดยอตโนมต
ใหกรอก IP / host , user , pass ทกาหนดไวใน เวบ provis (ผดแลระบบมหนาทแจกขอมลเหลานให ผใช JHCIS ) โดยคลกทป ม Edit และเมอกรอกเสรจแลวใหกดป ม Save หากสามารถตดตอ server ได
การใชงาน web service ใน jhcis
P R O V I S W E B S E R V I C E P a g e | 14 และ user กบ pass ถกตอง ตาราง web service ทพรอมใหบรการจะแสดงขอมล service และสลบหนาจอกลบไปแสดงผลการคนหาประวต
การแกไขปญหาในกรณทเชอมตอไมได
1. ตรวจสอบการเชอมตอ internet 2. ตรวจสอบคาการเชอมตอดวยตนเอง
การกาหนดคาการเชอมตอดวยตนเองในกรณทหนาจอกาหนดคาไมแสดงขนมาให
1. คลกทเครองหมายลกศร ทขอบซายของโปรแกรม
P R O V I S W E B S E R V I C E P a g e | 15
2. คลกท menu กาหนดคาระบบ ดานซายมอ และ เลอก tab WebService แลวกาหนดคา