ความช่วยเหลือในการติดตั้ง
การติดตั้ง OpenConstructionERP
เลือกวิธีที่ต้องการใช้งาน ทำตามขั้นตอนตามลำดับเลข และหากมีอะไรดูไม่ถูกต้อง ให้หาข้อความที่คุณเห็นในรายการปัญหาด้านล่าง คำเตือนใดๆ ระหว่างการติดตั้งไม่ได้ทำให้โปรเจกต์ของคุณมีความเสี่ยง
ไม่แน่ใจว่าต้องใช้อะไร?
- คุณใช้ Windows 10 หรือ 11ตัวติดตั้ง Windows (.exe)
- คุณมี Mac ที่ใช้ชิป M1, M2, M3 หรือ M4macOS (.dmg, Apple Silicon)
- คุณมี Mac ที่ใช้ Intelpip หรือ Docker (ไม่มีแอปสำหรับ Mac ที่ใช้ Intel)
- คุณใช้ Ubuntu, Debian หรือ Linux MintLinux .deb
- คุณใช้ Fedora, RHEL หรือ Rocky LinuxLinux .rpm
- คุณใช้ Linux ดิสทริบิวชันอื่นLinux AppImage
- คุณมี Python 3.12 หรือใหม่กว่าอยู่แล้ว หรือต้องการใช้บนเซิร์ฟเวอร์pip
- คุณใช้ Docker หรือกำลังตั้งค่าให้ทีมDocker
ดูก่อน
วิธีติดตั้ง OpenConstructionERP
วิดีโอแนะนำบน Windows บันทึกด้วยเวอร์ชัน 17.7.1 บางหน้าจอใน 18.5 อาจดูต่างออกไป และช่วงรอระหว่างติดตั้งถูกตัดให้สั้นลงในวิดีโอ
Windows
- 1
ดาวน์โหลด
OpenConstructionERP_18.5.0_x64-setup.exeจากหน้ารุ่นสิ่งที่คุณจะเห็นไฟล์ขนาดประมาณ 800 MB ในโฟลเดอร์ Downloads
- 2
ดับเบิลคลิกที่ไฟล์นั้น หากหน้าต่างสีน้ำเงินขึ้นว่า "Windows protected your PC" ให้คลิก "More info" ตรวจว่าชื่อไฟล์ขึ้นต้นด้วย OpenConstructionERP แล้วคลิก "Run anyway"
สิ่งที่คุณจะเห็นWindows ขอสิทธิ์ผู้ดูแลระบบ คลิก Yes
- 3
เลือกภาษาของตัวติดตั้ง ยอมรับสัญญาอนุญาต และใช้โฟลเดอร์ที่แนะนำ
C:\Program Files\OpenConstructionERPตามเดิมสิ่งที่คุณจะเห็นแถบความคืบหน้า แล้วตามด้วยหน้าสิ้นสุด
- 4
คลิก Finish หรือเปิด OpenConstructionERP จากเมนู Start
สิ่งที่คุณจะเห็นหน้าจอโหลด "กำลังเริ่มแอป" พร้อมรายการ: เริ่ม backend, เริ่มฐานข้อมูลในเครื่อง, เตรียมฐานข้อมูล, เริ่มเซิร์ฟเวอร์ของแอป, เปิดแอป
- 5
รอในการเปิดครั้งแรกสุด อย่าปิดหน้าต่าง
สิ่งที่คุณจะเห็น"การเปิดครั้งแรกจะตั้งค่าฐานข้อมูลในเครื่องของคุณ อาจใช้เวลาหนึ่งถึงสองนาที โปรดรอ" การเปิดครั้งต่อไปเร็วกว่ามาก
- 6
เลือกวิธีเปิด: เป็นหน้าต่างแอป (แนะนำ) หรือในเบราว์เซอร์ปกติของคุณ
สิ่งที่คุณจะเห็น"คุณต้องการเปิด OpenConstructionERP อย่างไร?" แล้วตามด้วยหน้าเข้าสู่ระบบ
- 7
เข้าสู่ระบบด้วยบัญชีทดลอง: อีเมล demo@openconstructionerp.com รหัสผ่าน DemoPass1234! หลังจากนั้นคุณสร้างบัญชีและโปรเจกต์ของตัวเองได้
สิ่งที่คุณจะเห็นแอป โปรเจกต์ตัวอย่างจะถูกสร้างเบื้องหลังตอนเปิดครั้งแรก รายการโปรเจกต์จึงอาจบอกชั่วคราวว่ากำลังมา
- 8
ในการติดตั้งใหม่ ผู้ดูแลระบบจะถูกถามครั้งเดียวว่าจะใช้โมดูลใดบ้าง ติ๊กที่ต้องการแล้วไปต่อ เปลี่ยนภายหลังได้ด้วยปุ่ม Background services บนแถบด้านบน
สิ่งที่คุณจะเห็นรายการโมดูลที่แสดงครั้งเดียว พร้อมหน่วยความจำที่แต่ละโมดูลต้องใช้
หากคุณเห็นข้อความ
การติดตั้งหน้าต่างสีน้ำเงิน "Windows protected your PC"
หมายความว่าอย่างไร ตัวติดตั้งยังไม่ได้ลงนามดิจิทัล Windows จึงไม่รู้จักผู้เผยแพร่ นี่คือคำเตือน ไม่ใช่การตรวจพบไวรัส
ต้องทำอย่างไร คลิก "More info" ตรวจว่าชื่อไฟล์ขึ้นต้นด้วย OpenConstructionERP แล้วคลิก "Run anyway"
การติดตั้งSmart App Control บล็อกแอป และไม่มีปุ่มให้ไปต่อ
หมายความว่าอย่างไร Smart App Control ของ Windows 11 ปฏิเสธโปรแกรมที่ไม่ได้ลงนาม
ต้องทำอย่างไร Smart App Control อนุญาตแอปเดียวไม่ได้ หากต้องการให้เปิดอยู่ ให้รัน OpenConstructionERP ด้วย Docker Desktop หรือใน WSL (Linux ที่มากับ Windows) ซึ่ง Smart App Control ไม่ตรวจสอบ ขั้นตอนโดยละเอียด: docs/desktop/WINDOWS_BLOCKED.md ในรีโพซิทอรี
การติดตั้ง"Please choose an installation folder whose path uses only Latin letters, digits and spaces. The built-in database cannot start from a folder with other characters in its path" (ข้อความนี้มีเฉพาะภาษาอังกฤษ)ความหมาย: เส้นทางของโฟลเดอร์ติดตั้งต้องมีเฉพาะอักษรละติน ตัวเลข และช่องว่างเท่านั้น เพราะฐานข้อมูลในตัวไม่สามารถเริ่มทำงานจากเส้นทางอื่นได้
หมายความว่าอย่างไร พาธของโฟลเดอร์ที่คุณเลือกมีตัวอักษรซีริลลิก จีน ตัวอักษรมีเครื่องหมายกำกับ หรืออักขระที่ไม่ใช่ละตินอื่นๆ
ต้องทำอย่างไร ใช้ C:\Program Files\OpenConstructionERP ที่แนะนำตามเดิม หรือเลือกโฟลเดอร์เช่น C:\OpenConstructionERP การติดตั้งแบบเงียบ (/S) จะจบด้วยรหัส 3 และเขียนสาเหตุลงใน %TEMP%\OpenConstructionERP-install-error.log
การติดตั้งตัวติดตั้งหยุดพร้อมข้อผิดพลาดเกี่ยวกับ WebView2
หมายความว่าอย่างไร Windows ปฏิเสธการติดตั้ง Microsoft WebView2 ซึ่งเป็นส่วนประกอบที่วาดหน้าต่างของแอป ส่วนนี้รวมอยู่ในตัวติดตั้งแล้วจึงไม่ต้องใช้อินเทอร์เน็ต ข้อผิดพลาดมาจาก Windows เอง (นโยบาย การอัปเดตที่ค้างอยู่ หรือ WebView2 รุ่นเก่าที่เสียหาย)
ต้องทำอย่างไร รีสตาร์ตคอมพิวเตอร์แล้วรันตัวติดตั้งอีกครั้ง หากยังล้มเหลว ให้ติดตั้ง "Microsoft Edge WebView2 Runtime" จาก Microsoft แล้วรันตัวติดตั้งของเราอีกครั้ง
การติดตั้งโปรแกรมป้องกันไวรัสลบหรือกักกันไฟล์ระหว่างการติดตั้งหรือตอนเปิดครั้งแรก
หมายความว่าอย่างไร โปรแกรมนี้ใหม่และยังไม่ได้ลงนาม และโปรแกรมป้องกันไวรัสบางตัวมองด้วยความสงสัย
ต้องทำอย่างไร กู้ไฟล์คืนจากการกักกัน และเพิ่มสองโฟลเดอร์นี้ในรายการยกเว้น: โฟลเดอร์โปรแกรม C:\Program Files\OpenConstructionERP และโฟลเดอร์ข้อมูลของคุณ C:\Users\<your name>\.openestimate จากนั้นรันตัวติดตั้งซ้ำทับการติดตั้งเดิม หากไม่แน่ใจว่าไฟล์เป็นของจริง โปรดเขียนมาหาเราก่อน
การอัปเกรดหน้าจอที่ถามว่าจะเขียนทับรุ่นที่ติดตั้งไว้หรือลบออกก่อน พร้อมบรรทัดที่แนะนำให้ลบออก
ต้องทำอย่างไร ใช้ตัวเลือกที่ถูกเลือกไว้แล้วตามเดิม (เขียนทับ) โปรเจกต์ของคุณจะยังอยู่ การเปิดครั้งแรกหลังอัปเกรดอาจใช้เวลานานกว่าปกติเพราะฐานข้อมูลอัปเดตตัวเอง
การอัปเกรดคุณรัน OpenConstructionERP ผ่าน pip หรือจากเทอร์มินัลบนคอมพิวเตอร์เครื่องเดียวกันด้วย และมันหยุดทำงานระหว่างอัปเกรด
หมายความว่าอย่างไร ทั้งสองแบบใช้โฟลเดอร์ .openestimate และฐานข้อมูลเดียวกัน ตัวติดตั้งจะหยุดฐานข้อมูลนั้นเพื่อเปลี่ยนโปรแกรม เมื่ออัปเกรดจาก 18.4.0 ตัวถอนการติดตั้งเก่าจะปิดโปรแกรมทุกตัวที่ชื่อ openconstructionerp.exe ด้วย
ต้องทำอย่างไร หยุดรุ่นที่รันในเทอร์มินัล (Ctrl+C) ก่อนติดตั้งหรืออัปเกรด แล้วเปิดใหม่หลังจากนั้น
การเริ่มต้นใช้งานหน้าจอโหลดค้างอยู่หนึ่งนาทีหรือนานกว่าในการเปิดครั้งแรกสุด
หมายความว่าอย่างไร แอปกำลังสร้างฐานข้อมูลในเครื่องของตัวเอง ขั้นตอนนี้เกิดขึ้นครั้งเดียวเท่านั้น
ต้องทำอย่างไร รอสักครู่และอย่าปิดหน้าต่าง บนดิสก์ที่ช้าหรือใกล้เต็มอาจใช้เวลานานกว่าปกติ การเปิดครั้งต่อไปจะเร็ว
การเริ่มต้นใช้งานกล่อง "OpenConstructionERP failed to start" ที่ระบุไฟล์ล็อก
หมายความว่าอย่างไร แอปเปิดหน้าต่างของตัวเองไม่ได้เลย
ต้องทำอย่างไร เปิดอีกครั้ง หากกล่องปรากฏอีก ให้ส่งไฟล์ล็อกที่ระบุมาให้เรา
การเริ่มต้นใช้งาน"The backend started, but the local database is not answering, so the app cannot open."ความหมาย: ส่วนเซิร์ฟเวอร์เริ่มทำงานแล้ว แต่ฐานข้อมูลภายในเครื่องไม่ตอบสนอง จึงเปิดแอปไม่ได้
หมายความว่าอย่างไร ฐานข้อมูลในเครื่องไม่เริ่มทำงาน มักเกิดหลังจากการใช้งานที่ปิดไม่เรียบร้อย
ต้องทำอย่างไร รีสตาร์ตคอมพิวเตอร์แล้วเปิดแอปอีกครั้ง หากเกิดซ้ำ ให้ส่ง desktop-launcher.log และล็อกของฐานข้อมูลมาให้เรา (ดูที่ล็อก)
การเริ่มต้นใช้งาน"The backend started, but this installation is missing the application files it serves"ความหมาย: ส่วนเซิร์ฟเวอร์เริ่มทำงานแล้ว แต่การติดตั้งขาดไฟล์ของส่วนติดต่อผู้ใช้
หมายความว่าอย่างไร โฟลเดอร์โปรแกรมขาดบางส่วน ซึ่งมักเป็นเพราะโปรแกรมป้องกันไวรัสลบไป
ต้องทำอย่างไร ตรวจดูที่กักกันของโปรแกรมป้องกันไวรัส แล้วรันตัวติดตั้งซ้ำทับการติดตั้งเดิม โปรเจกต์ของคุณจะไม่ถูกแตะต้อง
การเริ่มต้นใช้งาน"The application backend did not start in time" หรือ "The application backend stopped responding while preparing the local database" (หรือในขั้นตอนอื่น)
หมายความว่าอย่างไร การเริ่มใช้เวลานานกว่าที่แอปรอ ข้อความจะระบุว่าอยู่ที่ขั้นตอนไหน
ต้องทำอย่างไร ปิดหน้าต่างแล้วเปิดใหม่ หากดิสก์ใกล้เต็มให้เพิ่มพื้นที่ว่างก่อน หากหยุดที่ขั้นตอนเดิมอีก ให้ส่ง desktop-launcher.log มาให้เรา
การเริ่มต้นใช้งาน"The drive ran out of space while the application was starting" หรือ "There is not enough free space to start the application"
หมายความว่าอย่างไร เป็นอย่างนั้นจริงๆ ข้อความจะระบุโฟลเดอร์และพื้นที่ว่างที่เหลือ
ต้องทำอย่างไร เพิ่มพื้นที่ว่างบนไดรฟ์นั้นแล้วเปิดใหม่
การเริ่มต้นใช้งานข้อความที่บอกว่าโฟลเดอร์ฐานข้อมูลในเครื่อง "sits too deep in the filesystem" พร้อมตัวเลขสองตัว
หมายความว่าอย่างไร Windows จำกัดความยาวของพาธ และพาธของโฟลเดอร์ข้อมูลคุณยาวเกินไปสำหรับไฟล์ฐานข้อมูล การเปิดใช้พาธยาวใน Windows ไม่ช่วย
ต้องทำอย่างไร ตั้งตัวแปรสภาพแวดล้อมของผู้ใช้ OE_DATA_DIR เป็นพาธสั้นๆ เช่น C:\OpenConstructionERP\data (Start พิมพ์ "environment variables" เลือก Edit environment variables for your account แล้ว New) จากนั้นเปิดใหม่
การเริ่มต้นใช้งานชื่อผู้ใช้ Windows ของคุณมีอักขระที่ไม่ใช่ละติน (เช่นซีริลลิกหรือจีน) และคุณกำลังหาฐานข้อมูลของคุณ
หมายความว่าอย่างไร ฐานข้อมูลที่มากับแอปทำงานจากพาธแบบนั้นไม่ได้ ตั้งแต่ 18.5.0 แอปจึงเก็บไว้ที่ C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata ก่อน 18.5.0 แอปเปิดไม่ได้เลยสำหรับบัญชีแบบนี้
ต้องทำอย่างไร ไม่มีอะไรต้องแก้ ไฟล์ pgdata.location ในโฟลเดอร์ .openestimate ของคุณระบุโฟลเดอร์ฐานข้อมูลที่แน่นอน สำหรับสำรองข้อมูลให้คัดลอกทั้งสองโฟลเดอร์
ระหว่างใช้งาน"The application backend stopped, restarting" แล้วหน้าต่างโหลดใหม่
หมายความว่าอย่างไร ส่วนที่ทำงานเบื้องหลังของแอปหยุดโดยไม่คาดคิด และแอปเริ่มมันใหม่ งานที่บันทึกไว้ยังอยู่ แอปทำแบบนี้ได้มากสุดสองครั้งใน 30 นาที
ต้องทำอย่างไร ใช้งานต่อได้ หากเกิดซ้ำหรือเห็น "The application backend has stopped" ให้ส่ง desktop-launcher.log และ logs/backend-crash.log มาให้เรา
การเริ่มต้นใช้งานทุกครั้งที่เปิดแอปคุณจะถูกออกจากระบบและภาษากลับเป็นอังกฤษ
หมายความว่าอย่างไร โปรแกรมอื่นใช้พอร์ต 8732 ซึ่งปกติแอปใช้อยู่ เมื่อเป็นแบบนี้รุ่น 18.5.0 จะเลือกพอร์ตว่างแบบสุ่มทุกครั้งที่เปิด และหน้าต่างถือว่าพอร์ตใหม่ทุกพอร์ตเป็นไซต์ใหม่ จึงหาการเข้าสู่ระบบและภาษาไม่เจอ
ต้องทำอย่างไร ปิดหรือตั้งค่าใหม่ให้โปรแกรมอื่นที่ใช้พอร์ต 8732 (ใน Windows รัน netstat -ano | findstr :8732 ในเทอร์มินัลเพื่อดู process ID ของมัน) โปรเจกต์ของคุณไม่ได้รับผลกระทบ มีเพียงการเข้าสู่ระบบและการเลือกภาษา
การเริ่มต้นใช้งานคุณกังวลว่าแอปจะชนกับ PostgreSQL ที่คุณรันอยู่แล้วบนพอร์ต 5432
หมายความว่าอย่างไร ไม่ชน ฐานข้อมูลที่มากับแอปใน Windows ใช้พอร์ตในเครื่องที่ว่างแบบสุ่ม ส่วนใน macOS และ Linux ฟังเฉพาะ socket ในเครื่อง ไม่ใช่พอร์ต TCP
ต้องทำอย่างไร ไม่ต้องทำอะไร
ล็อกอยู่ที่ไหน
desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.logทุกอย่างที่แอปเดสก์ท็อปทำตอนเริ่มทำงาน อยู่ในโฟลเดอร์โฮมของคุณเสมอ แม้คุณจะย้ายโฟลเดอร์ข้อมูลไปแล้วbackend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.logรายละเอียดของการหยุดโดยไม่คาดคิด อยู่ในโฟลเดอร์ข้อมูล จึงย้ายไปพร้อมกับOE_DATA_DIRdatabase log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder frompgdata.location>\log)เหตุที่ฐานข้อมูลที่มากับแอปไม่เริ่มทำงานOpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log(พิมพ์%TEMP%ในแถบที่อยู่ของ Explorer)เหตุที่ตัวติดตั้ง Windows ปฏิเสธโฟลเดอร์ติดตั้ง
หากต้องการเปิดโฟลเดอร์ ให้วางข้อความนี้ในแถบที่อยู่ของ Explorer:
%USERPROFILE%\.openestimatemacOS
- 1
ดาวน์โหลด
OpenConstructionERP_18.5.0_aarch64.dmgแล้วเปิดสิ่งที่คุณจะเห็นหน้าต่างที่มีไอคอนแอป OpenConstructionERP
- 2
ลาก OpenConstructionERP ไปที่ Applications
สิ่งที่คุณจะเห็นแอปปรากฏในโฟลเดอร์ Applications
- 3
เปิด Terminal หนึ่งครั้งแล้วรัน
xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.appสิ่งที่คุณจะเห็นไม่มีผลลัพธ์ ซึ่งถูกต้องแล้ว คำสั่งนี้ลบเครื่องหมายการดาวน์โหลด เพราะ Apple ยังไม่ได้ notarize แอป
- 4
เปิด OpenConstructionERP จาก Applications
สิ่งที่คุณจะเห็นหน้าจอโหลด "กำลังเริ่มแอป" การเปิดครั้งแรกจะตั้งค่าฐานข้อมูลในเครื่องและใช้เวลาหนึ่งถึงสองนาที
- 5
เลือกหน้าต่างแอปหรือเบราว์เซอร์
สิ่งที่คุณจะเห็นหน้าเข้าสู่ระบบ
- 6
เข้าสู่ระบบด้วยบัญชีทดลอง: อีเมล demo@openconstructionerp.com รหัสผ่าน DemoPass1234! หลังจากนั้นคุณสร้างบัญชีและโปรเจกต์ของตัวเองได้
สิ่งที่คุณจะเห็นแอป โปรเจกต์ตัวอย่างจะถูกสร้างเบื้องหลังตอนเปิดครั้งแรก รายการโปรเจกต์จึงอาจบอกชั่วคราวว่ากำลังมา
- 7
ในการติดตั้งใหม่ ผู้ดูแลระบบจะถูกถามครั้งเดียวว่าจะใช้โมดูลใดบ้าง ติ๊กที่ต้องการแล้วไปต่อ เปลี่ยนภายหลังได้ด้วยปุ่ม Background services บนแถบด้านบน
สิ่งที่คุณจะเห็นรายการโมดูลที่แสดงครั้งเดียว พร้อมหน่วยความจำที่แต่ละโมดูลต้องใช้
หากคุณเห็นข้อความ
การเริ่มต้นใช้งานหน้าจอโหลดค้างอยู่หนึ่งนาทีหรือนานกว่าในการเปิดครั้งแรกสุด
หมายความว่าอย่างไร แอปกำลังสร้างฐานข้อมูลในเครื่องของตัวเอง ขั้นตอนนี้เกิดขึ้นครั้งเดียวเท่านั้น
ต้องทำอย่างไร รอสักครู่และอย่าปิดหน้าต่าง บนดิสก์ที่ช้าหรือใกล้เต็มอาจใช้เวลานานกว่าปกติ การเปิดครั้งต่อไปจะเร็ว
การเริ่มต้นใช้งาน"The backend started, but the local database is not answering, so the app cannot open."ความหมาย: ส่วนเซิร์ฟเวอร์เริ่มทำงานแล้ว แต่ฐานข้อมูลภายในเครื่องไม่ตอบสนอง จึงเปิดแอปไม่ได้
หมายความว่าอย่างไร ฐานข้อมูลในเครื่องไม่เริ่มทำงาน มักเกิดหลังจากการใช้งานที่ปิดไม่เรียบร้อย
ต้องทำอย่างไร รีสตาร์ตคอมพิวเตอร์แล้วเปิดแอปอีกครั้ง หากเกิดซ้ำ ให้ส่ง desktop-launcher.log และล็อกของฐานข้อมูลมาให้เรา (ดูที่ล็อก)
การเริ่มต้นใช้งาน"The backend started, but this installation is missing the application files it serves"ความหมาย: ส่วนเซิร์ฟเวอร์เริ่มทำงานแล้ว แต่การติดตั้งขาดไฟล์ของส่วนติดต่อผู้ใช้
หมายความว่าอย่างไร โฟลเดอร์โปรแกรมขาดบางส่วน ซึ่งมักเป็นเพราะโปรแกรมป้องกันไวรัสลบไป
ต้องทำอย่างไร ตรวจดูที่กักกันของโปรแกรมป้องกันไวรัส แล้วรันตัวติดตั้งซ้ำทับการติดตั้งเดิม โปรเจกต์ของคุณจะไม่ถูกแตะต้อง
การเริ่มต้นใช้งาน"The application backend did not start in time" หรือ "The application backend stopped responding while preparing the local database" (หรือในขั้นตอนอื่น)
หมายความว่าอย่างไร การเริ่มใช้เวลานานกว่าที่แอปรอ ข้อความจะระบุว่าอยู่ที่ขั้นตอนไหน
ต้องทำอย่างไร ปิดหน้าต่างแล้วเปิดใหม่ หากดิสก์ใกล้เต็มให้เพิ่มพื้นที่ว่างก่อน หากหยุดที่ขั้นตอนเดิมอีก ให้ส่ง desktop-launcher.log มาให้เรา
การเริ่มต้นใช้งาน"The application never finished unpacking itself, so its backend never started." หรือ "The application could not unpack itself into the temporary folder it uses."
หมายความว่าอย่างไร ใน macOS และ Linux แอปจะแตกไฟล์ backend ของตัวเองทุกครั้งที่เปิด ดิสก์ที่ช้าหรือเต็ม หรือโปรแกรมป้องกันไวรัสที่ล็อกไฟล์ จะขวางขั้นตอนนี้ (แอปบน Windows ไม่แตกไฟล์เองอีกแล้วตั้งแต่ 18.5)
ต้องทำอย่างไร เพิ่มพื้นที่ว่างบนไดรฟ์ที่มีโฟลเดอร์ชั่วคราวของคุณ หรืออนุญาตแอปในโปรแกรมป้องกันไวรัส แล้วเปิดใหม่
การเริ่มต้นใช้งาน"The drive ran out of space while the application was starting" หรือ "There is not enough free space to start the application"
หมายความว่าอย่างไร เป็นอย่างนั้นจริงๆ ข้อความจะระบุโฟลเดอร์และพื้นที่ว่างที่เหลือ
ต้องทำอย่างไร เพิ่มพื้นที่ว่างบนไดรฟ์นั้นแล้วเปิดใหม่
ระหว่างใช้งาน"The application backend stopped, restarting" แล้วหน้าต่างโหลดใหม่
หมายความว่าอย่างไร ส่วนที่ทำงานเบื้องหลังของแอปหยุดโดยไม่คาดคิด และแอปเริ่มมันใหม่ งานที่บันทึกไว้ยังอยู่ แอปทำแบบนี้ได้มากสุดสองครั้งใน 30 นาที
ต้องทำอย่างไร ใช้งานต่อได้ หากเกิดซ้ำหรือเห็น "The application backend has stopped" ให้ส่ง desktop-launcher.log และ logs/backend-crash.log มาให้เรา
การเริ่มต้นใช้งานทุกครั้งที่เปิดแอปคุณจะถูกออกจากระบบและภาษากลับเป็นอังกฤษ
หมายความว่าอย่างไร โปรแกรมอื่นใช้พอร์ต 8732 ซึ่งปกติแอปใช้อยู่ เมื่อเป็นแบบนี้รุ่น 18.5.0 จะเลือกพอร์ตว่างแบบสุ่มทุกครั้งที่เปิด และหน้าต่างถือว่าพอร์ตใหม่ทุกพอร์ตเป็นไซต์ใหม่ จึงหาการเข้าสู่ระบบและภาษาไม่เจอ
ต้องทำอย่างไร ปิดหรือตั้งค่าใหม่ให้โปรแกรมอื่นที่ใช้พอร์ต 8732 (ใน Windows รัน netstat -ano | findstr :8732 ในเทอร์มินัลเพื่อดู process ID ของมัน) โปรเจกต์ของคุณไม่ได้รับผลกระทบ มีเพียงการเข้าสู่ระบบและการเลือกภาษา
การเริ่มต้นใช้งานคุณกังวลว่าแอปจะชนกับ PostgreSQL ที่คุณรันอยู่แล้วบนพอร์ต 5432
หมายความว่าอย่างไร ไม่ชน ฐานข้อมูลที่มากับแอปใน Windows ใช้พอร์ตในเครื่องที่ว่างแบบสุ่ม ส่วนใน macOS และ Linux ฟังเฉพาะ socket ในเครื่อง ไม่ใช่พอร์ต TCP
ต้องทำอย่างไร ไม่ต้องทำอะไร
การติดตั้ง"OpenConstructionERP is damaged and can't be opened" (ข้อความอาจแสดงเป็นภาษาของระบบคุณ)
หมายความว่าอย่างไร Apple ยังไม่ได้ notarize แอป และแอปยังมีเครื่องหมายการดาวน์โหลดอยู่ แอปไม่ได้เสียหาย
ต้องทำอย่างไร วิธีนี้วิธีเดียวที่ช่วยได้: ใน Terminal รัน xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app หนึ่งครั้ง แล้วเปิดแอปตามปกติ
การติดตั้ง"OpenConstructionERP cannot be opened because the developer cannot be verified" (หรือ Apple ตรวจสอบไม่ได้ว่าไม่มีมัลแวร์ ข้อความอาจแสดงเป็นภาษาของระบบคุณ)
หมายความว่าอย่างไร แอปลงนามแบบ ad hoc แต่ Apple ยังไม่ได้ notarize
ต้องทำอย่างไร รันคำสั่ง xattr เดียวกัน หรือเปิด System Settings แล้วไปที่ Privacy & Security เลื่อนลงแล้วคลิก Open Anyway ทำเพียงครั้งเดียว
การติดตั้งแอปไม่ทำงานบน Mac ของคุณเลย
หมายความว่าอย่างไร รุ่นสำหรับ Mac ใช้ได้กับ Apple Silicon เท่านั้น (M1 และใหม่กว่า) ไม่มีรุ่นสำหรับ Intel
ต้องทำอย่างไร บน Mac ที่ใช้ Intel ให้ใช้ pip (Python 3.12 หรือใหม่กว่า) หรือ Docker
ล็อกอยู่ที่ไหน
desktop-launcher.log~/.openestimate/desktop-launcher.logทุกอย่างที่แอปเดสก์ท็อปทำตอนเริ่มทำงาน อยู่ในโฟลเดอร์โฮมของคุณเสมอ แม้คุณจะย้ายโฟลเดอร์ข้อมูลไปแล้วbackend-crash.log~/.openestimate/logs/backend-crash.logรายละเอียดของการหยุดโดยไม่คาดคิด อยู่ในโฟลเดอร์ข้อมูล จึงย้ายไปพร้อมกับOE_DATA_DIRdatabase log folder~/.openestimate/pgdata/logเหตุที่ฐานข้อมูลที่มากับแอปไม่เริ่มทำงาน
หากต้องการเปิดโฟลเดอร์จากเทอร์มินัล:
open ~/.openestimateLinux
Linux: .deb (Ubuntu, Debian, Mint)
- 1
ดาวน์โหลด
OpenConstructionERP_18.5.0_amd64.debสิ่งที่คุณจะเห็นไฟล์ขนาดประมาณ 830 MB
- 2
ในเทอร์มินัล ที่โฟลเดอร์ดาวน์โหลด ให้รัน
sudo apt install ./OpenConstructionERP_18.5.0_amd64.debสิ่งที่คุณจะเห็นapt จะแสดงแพ็กเกจและไลบรารีที่ต้องใช้ แล้วติดตั้งให้ เครื่องหมาย ./ หน้าชื่อไฟล์สำคัญ
- 3
เปิด OpenConstructionERP จากเมนูแอปพลิเคชัน
สิ่งที่คุณจะเห็นหน้าจอโหลด การเปิดครั้งแรกใช้เวลาหนึ่งถึงสองนาที
- 4
เข้าสู่ระบบด้วยบัญชีทดลอง: อีเมล demo@openconstructionerp.com รหัสผ่าน DemoPass1234! หลังจากนั้นคุณสร้างบัญชีและโปรเจกต์ของตัวเองได้
สิ่งที่คุณจะเห็นแอป โปรเจกต์ตัวอย่างจะถูกสร้างเบื้องหลังตอนเปิดครั้งแรก รายการโปรเจกต์จึงอาจบอกชั่วคราวว่ากำลังมา
- 5
ในการติดตั้งใหม่ ผู้ดูแลระบบจะถูกถามครั้งเดียวว่าจะใช้โมดูลใดบ้าง ติ๊กที่ต้องการแล้วไปต่อ เปลี่ยนภายหลังได้ด้วยปุ่ม Background services บนแถบด้านบน
สิ่งที่คุณจะเห็นรายการโมดูลที่แสดงครั้งเดียว พร้อมหน่วยความจำที่แต่ละโมดูลต้องใช้
Linux: .rpm (Fedora, RHEL, Rocky)
- 1
ดาวน์โหลด
OpenConstructionERP-18.5.0-1.x86_64.rpmสิ่งที่คุณจะเห็นไฟล์ขนาดประมาณ 850 MB
- 2
รัน
sudo dnf install ./OpenConstructionERP-18.5.0-1.x86_64.rpmสิ่งที่คุณจะเห็นdnf แก้ dependency และติดตั้งให้
- 3
เปิด OpenConstructionERP จากเมนูแอปพลิเคชัน
สิ่งที่คุณจะเห็นหน้าจอโหลด การเปิดครั้งแรกใช้เวลาหนึ่งถึงสองนาที
- 4
เข้าสู่ระบบด้วยบัญชีทดลอง: อีเมล demo@openconstructionerp.com รหัสผ่าน DemoPass1234! หลังจากนั้นคุณสร้างบัญชีและโปรเจกต์ของตัวเองได้
สิ่งที่คุณจะเห็นแอป โปรเจกต์ตัวอย่างจะถูกสร้างเบื้องหลังตอนเปิดครั้งแรก รายการโปรเจกต์จึงอาจบอกชั่วคราวว่ากำลังมา
- 5
ในการติดตั้งใหม่ ผู้ดูแลระบบจะถูกถามครั้งเดียวว่าจะใช้โมดูลใดบ้าง ติ๊กที่ต้องการแล้วไปต่อ เปลี่ยนภายหลังได้ด้วยปุ่ม Background services บนแถบด้านบน
สิ่งที่คุณจะเห็นรายการโมดูลที่แสดงครั้งเดียว พร้อมหน่วยความจำที่แต่ละโมดูลต้องใช้
Linux: AppImage (any distribution)
- 1
ดาวน์โหลด
OpenConstructionERP_18.5.0_amd64.AppImageสิ่งที่คุณจะเห็นไฟล์ขนาดประมาณ 910 MB
- 2
ทำให้ไฟล์รันได้
chmod +x OpenConstructionERP_18.5.0_amd64.AppImageสิ่งที่คุณจะเห็นไม่มีผลลัพธ์
- 3
รันไฟล์นั้น
./OpenConstructionERP_18.5.0_amd64.AppImageสิ่งที่คุณจะเห็นหน้าจอโหลด การเปิดครั้งแรกใช้เวลาหนึ่งถึงสองนาที
- 4
เข้าสู่ระบบด้วยบัญชีทดลอง: อีเมล demo@openconstructionerp.com รหัสผ่าน DemoPass1234! หลังจากนั้นคุณสร้างบัญชีและโปรเจกต์ของตัวเองได้
สิ่งที่คุณจะเห็นแอป โปรเจกต์ตัวอย่างจะถูกสร้างเบื้องหลังตอนเปิดครั้งแรก รายการโปรเจกต์จึงอาจบอกชั่วคราวว่ากำลังมา
- 5
ในการติดตั้งใหม่ ผู้ดูแลระบบจะถูกถามครั้งเดียวว่าจะใช้โมดูลใดบ้าง ติ๊กที่ต้องการแล้วไปต่อ เปลี่ยนภายหลังได้ด้วยปุ่ม Background services บนแถบด้านบน
สิ่งที่คุณจะเห็นรายการโมดูลที่แสดงครั้งเดียว พร้อมหน่วยความจำที่แต่ละโมดูลต้องใช้
หากคุณเห็นข้อความ
การเริ่มต้นใช้งานหน้าจอโหลดค้างอยู่หนึ่งนาทีหรือนานกว่าในการเปิดครั้งแรกสุด
หมายความว่าอย่างไร แอปกำลังสร้างฐานข้อมูลในเครื่องของตัวเอง ขั้นตอนนี้เกิดขึ้นครั้งเดียวเท่านั้น
ต้องทำอย่างไร รอสักครู่และอย่าปิดหน้าต่าง บนดิสก์ที่ช้าหรือใกล้เต็มอาจใช้เวลานานกว่าปกติ การเปิดครั้งต่อไปจะเร็ว
การเริ่มต้นใช้งาน"The backend started, but the local database is not answering, so the app cannot open."ความหมาย: ส่วนเซิร์ฟเวอร์เริ่มทำงานแล้ว แต่ฐานข้อมูลภายในเครื่องไม่ตอบสนอง จึงเปิดแอปไม่ได้
หมายความว่าอย่างไร ฐานข้อมูลในเครื่องไม่เริ่มทำงาน มักเกิดหลังจากการใช้งานที่ปิดไม่เรียบร้อย
ต้องทำอย่างไร รีสตาร์ตคอมพิวเตอร์แล้วเปิดแอปอีกครั้ง หากเกิดซ้ำ ให้ส่ง desktop-launcher.log และล็อกของฐานข้อมูลมาให้เรา (ดูที่ล็อก)
การเริ่มต้นใช้งาน"The backend started, but this installation is missing the application files it serves"ความหมาย: ส่วนเซิร์ฟเวอร์เริ่มทำงานแล้ว แต่การติดตั้งขาดไฟล์ของส่วนติดต่อผู้ใช้
หมายความว่าอย่างไร โฟลเดอร์โปรแกรมขาดบางส่วน ซึ่งมักเป็นเพราะโปรแกรมป้องกันไวรัสลบไป
ต้องทำอย่างไร ตรวจดูที่กักกันของโปรแกรมป้องกันไวรัส แล้วรันตัวติดตั้งซ้ำทับการติดตั้งเดิม โปรเจกต์ของคุณจะไม่ถูกแตะต้อง
การเริ่มต้นใช้งาน"The application backend did not start in time" หรือ "The application backend stopped responding while preparing the local database" (หรือในขั้นตอนอื่น)
หมายความว่าอย่างไร การเริ่มใช้เวลานานกว่าที่แอปรอ ข้อความจะระบุว่าอยู่ที่ขั้นตอนไหน
ต้องทำอย่างไร ปิดหน้าต่างแล้วเปิดใหม่ หากดิสก์ใกล้เต็มให้เพิ่มพื้นที่ว่างก่อน หากหยุดที่ขั้นตอนเดิมอีก ให้ส่ง desktop-launcher.log มาให้เรา
การเริ่มต้นใช้งาน"The application never finished unpacking itself, so its backend never started." หรือ "The application could not unpack itself into the temporary folder it uses."
หมายความว่าอย่างไร ใน macOS และ Linux แอปจะแตกไฟล์ backend ของตัวเองทุกครั้งที่เปิด ดิสก์ที่ช้าหรือเต็ม หรือโปรแกรมป้องกันไวรัสที่ล็อกไฟล์ จะขวางขั้นตอนนี้ (แอปบน Windows ไม่แตกไฟล์เองอีกแล้วตั้งแต่ 18.5)
ต้องทำอย่างไร เพิ่มพื้นที่ว่างบนไดรฟ์ที่มีโฟลเดอร์ชั่วคราวของคุณ หรืออนุญาตแอปในโปรแกรมป้องกันไวรัส แล้วเปิดใหม่
การเริ่มต้นใช้งาน"The drive ran out of space while the application was starting" หรือ "There is not enough free space to start the application"
หมายความว่าอย่างไร เป็นอย่างนั้นจริงๆ ข้อความจะระบุโฟลเดอร์และพื้นที่ว่างที่เหลือ
ต้องทำอย่างไร เพิ่มพื้นที่ว่างบนไดรฟ์นั้นแล้วเปิดใหม่
ระหว่างใช้งาน"The application backend stopped, restarting" แล้วหน้าต่างโหลดใหม่
หมายความว่าอย่างไร ส่วนที่ทำงานเบื้องหลังของแอปหยุดโดยไม่คาดคิด และแอปเริ่มมันใหม่ งานที่บันทึกไว้ยังอยู่ แอปทำแบบนี้ได้มากสุดสองครั้งใน 30 นาที
ต้องทำอย่างไร ใช้งานต่อได้ หากเกิดซ้ำหรือเห็น "The application backend has stopped" ให้ส่ง desktop-launcher.log และ logs/backend-crash.log มาให้เรา
การเริ่มต้นใช้งานทุกครั้งที่เปิดแอปคุณจะถูกออกจากระบบและภาษากลับเป็นอังกฤษ
หมายความว่าอย่างไร โปรแกรมอื่นใช้พอร์ต 8732 ซึ่งปกติแอปใช้อยู่ เมื่อเป็นแบบนี้รุ่น 18.5.0 จะเลือกพอร์ตว่างแบบสุ่มทุกครั้งที่เปิด และหน้าต่างถือว่าพอร์ตใหม่ทุกพอร์ตเป็นไซต์ใหม่ จึงหาการเข้าสู่ระบบและภาษาไม่เจอ
ต้องทำอย่างไร ปิดหรือตั้งค่าใหม่ให้โปรแกรมอื่นที่ใช้พอร์ต 8732 (ใน Windows รัน netstat -ano | findstr :8732 ในเทอร์มินัลเพื่อดู process ID ของมัน) โปรเจกต์ของคุณไม่ได้รับผลกระทบ มีเพียงการเข้าสู่ระบบและการเลือกภาษา
การเริ่มต้นใช้งานคุณกังวลว่าแอปจะชนกับ PostgreSQL ที่คุณรันอยู่แล้วบนพอร์ต 5432
หมายความว่าอย่างไร ไม่ชน ฐานข้อมูลที่มากับแอปใน Windows ใช้พอร์ตในเครื่องที่ว่างแบบสุ่ม ส่วนใน macOS และ Linux ฟังเฉพาะ socket ในเครื่อง ไม่ใช่พอร์ต TCP
ต้องทำอย่างไร ไม่ต้องทำอะไร
การติดตั้ง.deb ต้องการ libwebkit2gtk-4.1-0 หรือ dpkg รายงานว่า dependency ไม่ครบ
หมายความว่าอย่างไร แอปต้องใช้ WebKitGTK 4.1 เพื่อวาดหน้าต่าง dpkg -i ไม่ติดตั้ง dependency
ต้องทำอย่างไร ติดตั้งด้วย sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb ซึ่งจะดึงไลบรารีมาด้วย หากดิสทริบิวชันของคุณไม่มี libwebkit2gtk-4.1-0 (Ubuntu เก่ากว่า 22.04, Debian เก่ากว่า 12) ให้ใช้ pip
การติดตั้งAppImage ไม่ทำอะไรเมื่อดับเบิลคลิก
หมายความว่าอย่างไร ไฟล์ยังไม่ได้ถูกทำเครื่องหมายว่าเป็นโปรแกรม
ต้องทำอย่างไร รัน chmod +x OpenConstructionERP_18.5.0_amd64.AppImage แล้วเปิดอีกครั้ง
การติดตั้งข้อผิดพลาดของ AppImage ที่พูดถึง FUSE หรือ libfuse.so.2
หมายความว่าอย่างไร ดิสทริบิวชันรุ่นใหม่ไม่ติดตั้งไลบรารี FUSE 2 ที่ AppImage ใช้แล้ว
ต้องทำอย่างไร ติดตั้งไลบรารีนั้น (sudo apt install libfuse2 ส่วนใน Ubuntu 24.04 ใช้ sudo apt install libfuse2t64) หรือใช้ .deb, .rpm หรือ pip
ล็อกอยู่ที่ไหน
desktop-launcher.log~/.openestimate/desktop-launcher.logทุกอย่างที่แอปเดสก์ท็อปทำตอนเริ่มทำงาน อยู่ในโฟลเดอร์โฮมของคุณเสมอ แม้คุณจะย้ายโฟลเดอร์ข้อมูลไปแล้วbackend-crash.log~/.openestimate/logs/backend-crash.logรายละเอียดของการหยุดโดยไม่คาดคิด อยู่ในโฟลเดอร์ข้อมูล จึงย้ายไปพร้อมกับOE_DATA_DIRdatabase log folder~/.openestimate/pgdata/logเหตุที่ฐานข้อมูลที่มากับแอปไม่เริ่มทำงาน
หากต้องการเปิดโฟลเดอร์จากเทอร์มินัล:
xdg-open ~/.openestimatepip
- 1
รัน
pip install --upgrade openconstructionerpสิ่งที่คุณจะเห็นpip ดาวน์โหลดแพ็กเกจและ dependency ของมัน
- 2
รัน
openconstructionerpสิ่งที่คุณจะเห็นข้อความต้อนรับสั้นๆ เมื่อรันครั้งแรกจะถามว่าจะโหลดโปรเจกต์ตัวอย่างหรือไม่ และจะเปิดเบราว์เซอร์หรือไม่
- 3
รอจนกว่าฐานข้อมูลในเครื่องจะตั้งค่าเสร็จ
สิ่งที่คุณจะเห็น"Database: embedded PostgreSQL 16 (no Docker)" แล้วเซิร์ฟเวอร์จะเริ่มทำงาน เบราว์เซอร์ของคุณเปิด http://127.0.0.1:8080 (เหมือนกับ http://localhost:8080)
- 4
เข้าสู่ระบบ กับข้อมูลตัวอย่างคุณใช้ demo@openconstructionerp.com / DemoPass1234! ได้
สิ่งที่คุณจะเห็นแดชบอร์ด
- 5
ในการติดตั้งใหม่ ผู้ดูแลระบบจะถูกถามครั้งเดียวว่าจะใช้โมดูลใดบ้าง ติ๊กที่ต้องการแล้วไปต่อ เปลี่ยนภายหลังได้ด้วยปุ่ม Background services บนแถบด้านบน
สิ่งที่คุณจะเห็นรายการโมดูลที่แสดงครั้งเดียว พร้อมหน่วยความจำที่แต่ละโมดูลต้องใช้
- 6
หากต้องการหยุด ให้กด Ctrl+C ในเทอร์มินัล ครั้งหน้าก็แค่รัน openconstructionerp อีกครั้ง
สิ่งที่คุณจะเห็นเซิร์ฟเวอร์หยุดทำงาน ข้อมูลของคุณยังอยู่ในโฟลเดอร์
.openestimateในโฟลเดอร์โฮมของคุณ
คำสั่งที่มีประโยชน์
ไม่พบคำสั่ง openconstructionerp
python -m openconstructionerpมีบางอย่างไม่ทำงาน: ตรวจ Python พอร์ต โฟลเดอร์ข้อมูล และฐานข้อมูล แล้วบอกว่าต้องทำอะไร
openconstructionerp doctorพอร์ต 8080 ถูกโปรแกรมอื่นใช้อยู่
openconstructionerp serve --port 8081คอมพิวเตอร์เครื่องอื่นในเครือข่ายของคุณต้องเข้าถึงได้
openconstructionerp serve --host 0.0.0.0 --port 8080คุณต้องบอกรุ่นของคุณให้เรา
openconstructionerp --versionหากคุณเห็นข้อความ
การติดตั้งpip บอกว่าไม่พบดิสทริบิวชันที่เหมาะสม หรือต้องใช้ Python รุ่นอื่น
หมายความว่าอย่างไร OpenConstructionERP ต้องใช้ Python 3.12 หรือใหม่กว่า
ต้องทำอย่างไร ติดตั้ง Python 3.12 หรือใหม่กว่า แล้วรัน python3.12 -m pip install --upgrade openconstructionerp (ใน Windows: py -3.12 -m pip install --upgrade openconstructionerp)
การติดตั้งerror: externally-managed-environment (Ubuntu 23.04+, Debian 12+)ความหมาย: ระบบ Linux ของคุณปกป้อง Python ของตัวเองและปฏิเสธการติดตั้งแพ็กเกจลงไป
หมายความว่าอย่างไร Python ของระบบไม่อนุญาตให้ pip ติดตั้งลงไปในตัวมัน
ต้องทำอย่างไร ใช้ pipx install openconstructionerp หรือสร้าง virtual environment ก่อน: python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp
การเริ่มต้นใช้งาน"openconstructionerp" is not recognized หรือ command not found
หมายความว่าอย่างไร โฟลเดอร์ที่ pip วางคำสั่งไว้ไม่อยู่ใน PATH ของคุณ (พบบ่อยใน Windows)
ต้องทำอย่างไร ให้รัน python -m openconstructionerp แทน ใช้ได้ทุกระบบโดยไม่ต้องแตะ PATH
การเริ่มต้นใช้งาน"Port 8080 is already in use. Try: openconstructionerp serve --port 8081"ความหมาย: โปรแกรมอื่นกำลังใช้พอร์ต 8080 อยู่แล้ว ให้เริ่มแอปบนพอร์ตอื่น เช่น 8081
หมายความว่าอย่างไร โปรแกรมอื่นใช้พอร์ต 8080 อยู่
ต้องทำอย่างไร รันคำสั่งที่แนะนำ แล้วเปิดที่อยู่ที่มันพิมพ์ออกมา
การเริ่มต้นใช้งาน"Embedded PostgreSQL could not start"ความหมาย: ไม่สามารถเริ่มฐานข้อมูล PostgreSQL ในตัวได้
หมายความว่าอย่างไร ฐานข้อมูลที่ฝังมาไม่เริ่มทำงาน ข้อความจะพิมพ์พาธของล็อกของมัน
ต้องทำอย่างไร รัน openconstructionerp doctor หากไม่ช่วย ให้ติดตั้งใหม่ด้วย pip install --upgrade --force-reinstall openconstructionerp แล้วส่งล็อกที่ระบุมาให้เรา
ล็อกอยู่ที่ไหน
terminal outputthe terminal window (pip);docker compose logs app(Docker)สำหรับ pip และ Docker ให้คัดลอกสิ่งที่เทอร์มินัลพิมพ์ และผลลัพธ์ของopenconstructionerp doctor
Docker
- 1
ในโฟลเดอร์ว่าง ดาวน์โหลดไฟล์ compose สองไฟล์
curl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/docker-compose.quickstart.yml -o docker-compose.ymlcurl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/docker-compose.quickstart.image.yml -o docker-compose.override.ymlสิ่งที่คุณจะเห็นสองไฟล์ในโฟลเดอร์
- 2
สร้างไฟล์ความลับหนึ่งครั้ง
echo "POSTGRES_PASSWORD=$(openssl rand -base64 24)" > .envecho "JWT_SECRET=$(openssl rand -hex 32)" >> .envสิ่งที่คุณจะเห็นไฟล์
.envเก็บไว้ให้ดี: มีรหัสผ่านฐานข้อมูลและความลับสำหรับการเข้าสู่ระบบ - 3
เริ่มใช้งาน
docker compose pull app && docker compose up -dสิ่งที่คุณจะเห็นคอนเทนเนอร์สองตัวเริ่มทำงาน: postgres และ app
- 4
เปิด http://localhost:8080 แล้วเข้าสู่ระบบด้วย demo@openconstructionerp.com / DemoPass1234!
สิ่งที่คุณจะเห็นหน้าเข้าสู่ระบบ การเปิดครั้งแรกอาจใช้เวลาหนึ่งนาทีระหว่างที่ฐานข้อมูลเตรียมตัว
- 5
ในการติดตั้งใหม่ ผู้ดูแลระบบจะถูกถามครั้งเดียวว่าจะใช้โมดูลใดบ้าง ติ๊กที่ต้องการแล้วไปต่อ เปลี่ยนภายหลังได้ด้วยปุ่ม Background services บนแถบด้านบน
สิ่งที่คุณจะเห็นรายการโมดูลที่แสดงครั้งเดียว พร้อมหน่วยความจำที่แต่ละโมดูลต้องใช้
คำสั่งที่มีประโยชน์
ตรวจว่าคอนเทนเนอร์ทั้งสองทำงานและมีสถานะปกติ
docker compose psดูว่าทำไมแอปจึงไม่เริ่ม
docker compose logs appพอร์ต 8080 บนเครื่องของคุณถูกใช้อยู่
OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -dการตั้งค่า compose นี้ใช้สำหรับประเมินผลและใช้งานในเครื่อง สำหรับเซิร์ฟเวอร์ production ดู docs/INSTALL_LINUX.md และ docker-compose.prod.yml ในรีโพซิทอรี
หากคุณเห็นข้อความ
การเริ่มต้นใช้งานCompose หยุดพร้อมข้อความ "POSTGRES_PASSWORD must be set" หรือ "JWT_SECRET must be set"
หมายความว่าอย่างไร ไม่มีไฟล์ .env ที่มีความลับสองค่า หรือไม่ได้อยู่ในโฟลเดอร์เดียวกัน
ต้องทำอย่างไร สร้างไฟล์ .env ตามขั้นตอนที่ 2 ในโฟลเดอร์ที่มี docker-compose.yml
การเริ่มต้นใช้งานเปิด http://localhost:8080 ไม่ได้
หมายความว่าอย่างไร คอนเทนเนอร์ยังไม่ทำงาน หรือพอร์ต 8080 ถูกใช้อยู่
ต้องทำอย่างไร รัน docker compose ps และ docker compose logs app หากต้องการใช้พอร์ตอื่น: OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d แล้วเปิด http://localhost:8081
การติดตั้งบน Mac ที่ใช้ Apple Silicon หรือเครื่อง ARM อื่น Docker เตือนว่าแพลตฟอร์มของอิมเมจ linux/amd64 ไม่ตรงกัน หรือแอปทำงานช้ามาก
หมายความว่าอย่างไร อิมเมจที่เผยแพร่สร้างสำหรับ x86-64 เท่านั้น
ต้องทำอย่างไร สร้างจากซอร์สด้วย make quickstart หรือใช้ pip
ล็อกอยู่ที่ไหน
terminal outputthe terminal window (pip);docker compose logs app(Docker)สำหรับ pip และ Docker ให้คัดลอกสิ่งที่เทอร์มินัลพิมพ์ และผลลัพธ์ของopenconstructionerp doctor
ข้อมูลของคุณ การอัปเกรด และการถอนการติดตั้ง
- Windows
C:\Users\<your name>\.openestimateและC:\ProgramData\OpenConstructionERP\clusters\<id>\pgdataหากชื่อผู้ใช้ของคุณมีอักขระที่ไม่ใช่ละติน โดยpgdata.locationระบุไว้ - macOS~/
.openestimate(ซ่อนอยู่ กด Cmd+Shift+. ใน Finder) - Linux~/
.openestimate - pip~/
.openestimateโฟลเดอร์เดียวกับแอปเดสก์ท็อป เว้นแต่คุณระบุ--data-dirหรือตั้งOE_DATA_DIR - DockerDocker volume <folder>_pg_data (ฐานข้อมูล) และ <folder>_app_data (ไฟล์) โดย <folder> คือชื่อโฟลเดอร์ที่มี
docker-compose.yml
การอัปเกรด
ติดตั้งรุ่นใหม่ทับรุ่นเก่า โฟลเดอร์ .openestimate ของคุณไม่ใช่ส่วนหนึ่งของโปรแกรม โปรเจกต์ ผู้ใช้ และการตั้งค่าจึงยังอยู่ การเปิดครั้งแรกหลังอัปเกรดอาจใช้เวลานานกว่าปกติเพราะฐานข้อมูลอัปเดตตัวเอง
การถอนการติดตั้ง
การถอนการติดตั้งจะลบโปรแกรมและเก็บโปรเจกต์ของคุณไว้ ใน Windows ตัวถอนการติดตั้งมีตัวเลือก "Delete the application data" (ในภาษาของตัวติดตั้ง): ตัวเลือกนี้ลบเฉพาะการเข้าสู่ระบบและภาษาที่หน้าต่างแอปบันทึกไว้ (ใน %APPDATA% และ %LOCALAPPDATA%\io.openconstructionerp.desktop) ไม่ลบโปรเจกต์ของคุณ หากต้องการเริ่มใหม่ทั้งหมด ให้ถอนการติดตั้ง คัดลอก .openestimate ไปที่ปลอดภัย แล้วจึงลบ
การสำรองข้อมูล
ปิดแอปแล้วคัดลอกโฟลเดอร์ .openestimate (และโฟลเดอร์ ProgramData ที่ระบุใน pgdata.location ถ้ามี)
ยังติดปัญหาอยู่? เราช่วยได้
โปรดแจ้งข้อมูลต่อไปนี้:
- รุ่น (อยู่ในชื่อไฟล์ที่ดาวน์โหลด pip:
openconstructionerp --versionDocker: แท็กของอิมเมจ) และวิธีที่ติดตั้ง (ตัวติดตั้ง Windows, .dmg, .deb, .rpm, AppImage, pip หรือ Docker) - ระบบของคุณ (Windows: Start พิมพ์
winvermacOS: เมนู Apple แล้ว About This Mac Linux: ดิสทริบิวชันและรุ่น) - ข้อความที่ขึ้นแบบตรงตัว หรือภาพหน้าจอ
- ไฟล์ล็อกที่ระบุไว้ด้านบน
ไฟล์ล็อกอาจมีชื่อผู้ใช้และชื่อโฟลเดอร์ของคุณ ตรวจดูก่อนโพสต์ต่อสาธารณะ หากต้องการ ส่งทางอีเมลจะดีกว่า
ขั้นตอนถัดไปหลังติดตั้ง
ข้อความฉบับเต็มมีบน GitHub ด้วย ในภาษา English, Deutsch และ Русский