Trợ giúp cài đặt
Cài đặt OpenConstructionERP
Chọn cách bạn muốn chạy, làm theo các bước đánh số, và nếu có gì trông không ổn, hãy tìm thông báo bạn đang thấy trong danh sách sự cố bên dưới. Không cảnh báo nào trong lúc cài đặt gây rủi ro cho dự án của bạn.
Chưa chắc mình cần gì?
- Bạn dùng Windows 10 hoặc 11Trình cài đặt Windows (.exe)
- Bạn có máy Mac dùng chip M1, M2, M3 hoặc M4macOS (.dmg, Apple Silicon)
- Bạn có máy Mac dùng Intelpip hoặc Docker (không có ứng dụng cho Mac dùng Intel)
- Bạn dùng Ubuntu, Debian hoặc Linux MintLinux .deb
- Bạn dùng Fedora, RHEL hoặc Rocky LinuxLinux .rpm
- Bạn dùng một bản phân phối Linux khácLinux AppImage
- Bạn đã có Python 3.12 trở lên, hoặc muốn chạy trên máy chủpip
- Bạn dùng Docker hoặc đang thiết lập cho một nhómDocker
Xem trước
Cách cài đặt OpenConstructionERP
Video hướng dẫn trên Windows, quay bằng phiên bản 17.7.1. Một số màn hình trong 18.5 trông khác, và thời gian chờ khi cài đặt đã được rút ngắn trong video.
Windows
- 1
Tải
OpenConstructionERP_18.5.0_x64-setup.exetừ trang phát hành.Bạn sẽ thấyMột tệp khoảng 800 MB trong thư mục Downloads.
- 2
Bấm đúp vào tệp. Nếu một cửa sổ màu xanh hiện "Windows protected your PC", hãy bấm "More info", kiểm tra tên tệp bắt đầu bằng OpenConstructionERP, rồi bấm "Run anyway".
Bạn sẽ thấyWindows xin quyền quản trị viên. Bấm Yes.
- 3
Chọn ngôn ngữ của trình cài đặt, chấp nhận giấy phép và giữ nguyên thư mục được gợi ý
C:\Program Files\OpenConstructionERP.Bạn sẽ thấyMột thanh tiến trình, rồi trang hoàn tất.
- 4
Bấm Finish hoặc mở OpenConstructionERP từ menu Start.
Bạn sẽ thấyMàn hình tải "Đang khởi động ứng dụng" cùng một danh sách: khởi động backend, khởi động cơ sở dữ liệu cục bộ, chuẩn bị cơ sở dữ liệu, khởi động máy chủ ứng dụng, mở ứng dụng.
- 5
Hãy chờ ở lần chạy đầu tiên. Đừng đóng cửa sổ.
Bạn sẽ thấy"Lần chạy đầu tiên thiết lập cơ sở dữ liệu cục bộ của bạn. Việc này có thể mất một hoặc hai phút, vui lòng chờ." Các lần chạy sau nhanh hơn nhiều.
- 6
Chọn cách mở: dưới dạng cửa sổ ứng dụng (khuyên dùng) hoặc trong trình duyệt thông thường của bạn.
Bạn sẽ thấy"Bạn muốn mở OpenConstructionERP bằng cách nào?" rồi đến trang đăng nhập.
- 7
Đăng nhập bằng tài khoản demo: email demo@openconstructionerp.com, mật khẩu DemoPass1234!. Sau đó bạn có thể tạo tài khoản và dự án của riêng mình.
Bạn sẽ thấyỨng dụng. Các dự án demo được tạo ngầm ở lần chạy đầu tiên, nên danh sách dự án có thể báo trong chốc lát rằng chúng đang được tạo.
- 8
Với bản cài mới, quản trị viên được hỏi một lần bạn sẽ dùng những module nào. Tích những module cần rồi tiếp tục. Sau này bạn có thể đổi bằng nút Background services trên thanh phía trên.
Bạn sẽ thấyMột danh sách module hiện một lần, kèm dung lượng bộ nhớ mỗi module cần.
Nếu bạn thấy một thông báo
Cài đặtMột cửa sổ màu xanh "Windows protected your PC".
Ý nghĩa Trình cài đặt chưa được ký số, nên Windows không biết nhà phát hành. Đây là một cảnh báo, không phải phát hiện virus.
Cần làm gì Bấm "More info", kiểm tra tên tệp bắt đầu bằng OpenConstructionERP, rồi bấm "Run anyway".
Cài đặtSmart App Control chặn ứng dụng, không có nút để tiếp tục.
Ý nghĩa Smart App Control của Windows 11 từ chối các chương trình chưa được ký.
Cần làm gì Smart App Control không thể cho phép riêng một ứng dụng. Để giữ nó bật, hãy chạy OpenConstructionERP bằng Docker Desktop hoặc trong WSL (Linux tích hợp sẵn trong Windows), những nơi Smart App Control không kiểm tra. Hướng dẫn từng bước: docs/desktop/WINDOWS_BLOCKED.md trong kho mã.
Cài đặt"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" (thông báo này chỉ có tiếng Anh)Ý nghĩa: đường dẫn thư mục cài đặt chỉ được chứa chữ cái Latin, chữ số và dấu cách, vì cơ sở dữ liệu tích hợp không thể khởi động từ đường dẫn nào khác.
Ý nghĩa Đường dẫn của thư mục bạn chọn có chữ Kirin, chữ Trung, chữ có dấu hoặc các ký tự không phải Latin khác.
Cần làm gì Giữ nguyên C:\Program Files\OpenConstructionERP được gợi ý hoặc chọn một thư mục như C:\OpenConstructionERP. Cài đặt im lặng (/S) kết thúc với mã 3 và ghi lý do vào %TEMP%\OpenConstructionERP-install-error.log.
Cài đặtTrình cài đặt dừng với lỗi về WebView2.
Ý nghĩa Windows từ chối cài Microsoft WebView2, thành phần vẽ cửa sổ của ứng dụng. Nó đã có trong trình cài đặt nên không cần internet; lỗi đến từ chính Windows (chính sách, bản cập nhật đang chờ, hoặc WebView2 cũ bị hỏng).
Cần làm gì Khởi động lại máy tính và chạy lại trình cài đặt. Nếu vẫn lỗi, hãy cài "Microsoft Edge WebView2 Runtime" từ Microsoft rồi chạy trình cài đặt của chúng tôi thêm một lần nữa.
Cài đặtPhần mềm diệt virus xóa hoặc cách ly một tệp trong lúc cài đặt hoặc ở lần chạy đầu tiên.
Ý nghĩa Chương trình còn mới và chưa được ký, và một số phần mềm diệt virus nghi ngờ điều đó.
Cần làm gì Khôi phục tệp từ khu cách ly và thêm hai thư mục này vào danh sách ngoại lệ: thư mục chương trình C:\Program Files\OpenConstructionERP và thư mục dữ liệu của bạn C:\Users\<your name>\.openestimate. Sau đó chạy lại trình cài đặt đè lên bản cài hiện có. Nếu không chắc tệp là thật, hãy viết cho chúng tôi trước.
Nâng cấpMột màn hình hỏi nên ghi đè bản đã cài hay gỡ nó trước, kèm một dòng gợi ý gỡ.
Cần làm gì Giữ lựa chọn đã được chọn sẵn (ghi đè). Dự án của bạn được giữ nguyên. Lần chạy đầu tiên sau khi nâng cấp có thể lâu hơn khi cơ sở dữ liệu tự cập nhật.
Nâng cấpBạn còn chạy OpenConstructionERP bằng pip hoặc từ terminal trên cùng máy, và nó dừng lại trong lúc nâng cấp.
Ý nghĩa Cả hai dùng chung thư mục .openestimate và cùng một cơ sở dữ liệu. Trình cài đặt dừng cơ sở dữ liệu đó để thay chương trình. Khi nâng cấp từ 18.4.0, trình gỡ cài đặt cũ cũng đóng mọi chương trình có tên openconstructionerp.exe.
Cần làm gì Hãy dừng bản chạy trong terminal (Ctrl+C) trước khi cài hoặc nâng cấp, rồi chạy lại sau đó.
Khởi độngMàn hình tải đứng yên một phút hoặc lâu hơn ở lần chạy đầu tiên.
Ý nghĩa Ứng dụng tạo cơ sở dữ liệu cục bộ của nó. Việc này chỉ xảy ra một lần.
Cần làm gì Hãy chờ và đừng đóng cửa sổ. Trên ổ đĩa chậm hoặc gần đầy, việc này có thể lâu hơn. Các lần chạy sau rất nhanh.
Khởi độngMột hộp "OpenConstructionERP failed to start" nêu tên một tệp nhật ký.
Ý nghĩa Ứng dụng hoàn toàn không mở được cửa sổ của nó.
Cần làm gì Chạy lại thêm một lần. Nếu hộp thoại lại hiện, hãy gửi cho chúng tôi tệp nhật ký mà nó nêu.
Khởi động"The backend started, but the local database is not answering, so the app cannot open."Ý nghĩa: phần máy chủ đã khởi động, nhưng cơ sở dữ liệu cục bộ của nó không phản hồi, nên không thể mở ứng dụng.
Ý nghĩa Cơ sở dữ liệu cục bộ không khởi động, thường sau một phiên làm việc không được đóng sạch.
Cần làm gì Khởi động lại máy tính và chạy lại ứng dụng. Nếu lặp lại, hãy gửi cho chúng tôi desktop-launcher.log và nhật ký của cơ sở dữ liệu (xem Nhật ký).
Khởi động"The backend started, but this installation is missing the application files it serves"Ý nghĩa: phần máy chủ đã khởi động, nhưng bản cài đặt thiếu các tệp giao diện người dùng.
Ý nghĩa Thiếu một phần của thư mục chương trình, thường do phần mềm diệt virus đã gỡ nó.
Cần làm gì Kiểm tra khu cách ly của phần mềm diệt virus, rồi chạy lại trình cài đặt đè lên bản cài hiện có. Dự án của bạn không bị động đến.
Khởi động"The application backend did not start in time" hoặc "The application backend stopped responding while preparing the local database" (hoặc ở một bước khác).
Ý nghĩa Việc khởi động mất lâu hơn thời gian ứng dụng chờ. Thông báo nêu bước mà nó đang ở.
Cần làm gì Đóng cửa sổ và chạy lại. Hãy giải phóng dung lượng ổ đĩa trước nếu đĩa gần đầy. Nếu nó lại dừng ở cùng bước, hãy gửi cho chúng tôi desktop-launcher.log.
Khởi động"The drive ran out of space while the application was starting" hoặc "There is not enough free space to start the application".
Ý nghĩa Đúng như vậy. Thông báo nêu thư mục và dung lượng trống còn lại.
Cần làm gì Giải phóng dung lượng trên ổ đó và chạy lại.
Khởi độngMột thông báo rằng thư mục cơ sở dữ liệu cục bộ "sits too deep in the filesystem", kèm hai con số.
Ý nghĩa Windows giới hạn độ dài đường dẫn, và đường dẫn thư mục dữ liệu của bạn quá dài đối với các tệp cơ sở dữ liệu. Bật đường dẫn dài trong Windows không giúp được.
Cần làm gì Đặt biến môi trường người dùng OE_DATA_DIR thành một đường dẫn ngắn như C:\OpenConstructionERP\data (Start, gõ "environment variables", Edit environment variables for your account, New) rồi chạy lại.
Khởi độngTên người dùng Windows của bạn có ký tự không phải Latin (ví dụ chữ Kirin hoặc chữ Trung) và bạn đang tìm cơ sở dữ liệu của mình.
Ý nghĩa Cơ sở dữ liệu tích hợp không chạy được từ một đường dẫn như vậy, nên từ 18.5.0 ứng dụng giữ nó ở C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata. Trước 18.5.0, ứng dụng hoàn toàn không khởi động được với các tài khoản như vậy.
Cần làm gì Không có gì cần sửa. Tệp pgdata.location trong thư mục .openestimate của bạn cho biết đúng thư mục cơ sở dữ liệu. Để sao lưu, hãy sao chép cả hai thư mục.
Khi đang chạy"The application backend stopped, restarting" và cửa sổ tải lại.
Ý nghĩa Phần chạy ngầm của ứng dụng đột ngột dừng và ứng dụng đã khởi động lại nó. Công việc đã lưu vẫn còn. Nó chỉ làm vậy tối đa hai lần trong 30 phút.
Cần làm gì Cứ tiếp tục. Nếu lặp lại hoặc bạn thấy "The application backend has stopped", hãy gửi cho chúng tôi desktop-launcher.log và logs/backend-crash.log.
Khởi độngMỗi lần bạn chạy ứng dụng, bạn bị đăng xuất và ngôn ngữ trở về tiếng Anh.
Ý nghĩa Một chương trình khác đang dùng cổng 8732, cổng mà ứng dụng thường dùng. Khi đó bản 18.5.0 chọn một cổng trống ngẫu nhiên mỗi lần chạy, và cửa sổ coi mỗi cổng mới là một trang web mới, nên không tìm thấy phiên đăng nhập và ngôn ngữ.
Cần làm gì Đóng hoặc cấu hình lại chương trình kia đang dùng cổng 8732 (trên Windows chạy netstat -ano | findstr :8732 trong terminal để xem process ID của nó). Dự án của bạn không bị ảnh hưởng, chỉ có đăng nhập và lựa chọn ngôn ngữ.
Khởi độngBạn lo ứng dụng xung đột với một PostgreSQL mà bạn đã chạy sẵn trên cổng 5432.
Ý nghĩa Không xung đột. Cơ sở dữ liệu tích hợp trên Windows lấy một cổng cục bộ trống ngẫu nhiên, còn trên macOS và Linux nó chỉ lắng nghe trên một socket cục bộ, không phải cổng TCP.
Cần làm gì Không cần làm gì.
Nhật ký nằm ở đâu
desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.logMọi việc ứng dụng máy tính để bàn đã làm khi khởi động. Luôn nằm trong thư mục home của bạn, kể cả khi bạn đã chuyển thư mục dữ liệu đi nơi khác.backend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.logChi tiết về một lần dừng đột ngột. Nằm trong thư mục dữ liệu, nên di chuyển cùng vớiOE_DATA_DIR.database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder frompgdata.location>\log)Vì sao cơ sở dữ liệu tích hợp không khởi động.OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log(gõ%TEMP%vào thanh địa chỉ của Explorer)Vì sao trình cài đặt Windows từ chối thư mục cài đặt.
Để mở thư mục, dán đoạn này vào thanh địa chỉ của Explorer:
%USERPROFILE%\.openestimatemacOS
- 1
Tải
OpenConstructionERP_18.5.0_aarch64.dmgvà mở nó.Bạn sẽ thấyMột cửa sổ có biểu tượng ứng dụng OpenConstructionERP.
- 2
Kéo OpenConstructionERP vào Applications.
Bạn sẽ thấyỨng dụng xuất hiện trong thư mục Applications.
- 3
Mở Terminal một lần và chạy.
xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.appBạn sẽ thấyKhông có kết quả in ra. Như vậy là đúng. Lệnh này gỡ dấu tải về, vì Apple chưa notarize ứng dụng.
- 4
Mở OpenConstructionERP từ Applications.
Bạn sẽ thấyMàn hình tải "Đang khởi động ứng dụng". Lần chạy đầu tiên thiết lập cơ sở dữ liệu cục bộ và mất một hoặc hai phút.
- 5
Chọn cửa sổ ứng dụng hoặc trình duyệt.
Bạn sẽ thấyTrang đăng nhập.
- 6
Đăng nhập bằng tài khoản demo: email demo@openconstructionerp.com, mật khẩu DemoPass1234!. Sau đó bạn có thể tạo tài khoản và dự án của riêng mình.
Bạn sẽ thấyỨng dụng. Các dự án demo được tạo ngầm ở lần chạy đầu tiên, nên danh sách dự án có thể báo trong chốc lát rằng chúng đang được tạo.
- 7
Với bản cài mới, quản trị viên được hỏi một lần bạn sẽ dùng những module nào. Tích những module cần rồi tiếp tục. Sau này bạn có thể đổi bằng nút Background services trên thanh phía trên.
Bạn sẽ thấyMột danh sách module hiện một lần, kèm dung lượng bộ nhớ mỗi module cần.
Nếu bạn thấy một thông báo
Khởi độngMàn hình tải đứng yên một phút hoặc lâu hơn ở lần chạy đầu tiên.
Ý nghĩa Ứng dụng tạo cơ sở dữ liệu cục bộ của nó. Việc này chỉ xảy ra một lần.
Cần làm gì Hãy chờ và đừng đóng cửa sổ. Trên ổ đĩa chậm hoặc gần đầy, việc này có thể lâu hơn. Các lần chạy sau rất nhanh.
Khởi động"The backend started, but the local database is not answering, so the app cannot open."Ý nghĩa: phần máy chủ đã khởi động, nhưng cơ sở dữ liệu cục bộ của nó không phản hồi, nên không thể mở ứng dụng.
Ý nghĩa Cơ sở dữ liệu cục bộ không khởi động, thường sau một phiên làm việc không được đóng sạch.
Cần làm gì Khởi động lại máy tính và chạy lại ứng dụng. Nếu lặp lại, hãy gửi cho chúng tôi desktop-launcher.log và nhật ký của cơ sở dữ liệu (xem Nhật ký).
Khởi động"The backend started, but this installation is missing the application files it serves"Ý nghĩa: phần máy chủ đã khởi động, nhưng bản cài đặt thiếu các tệp giao diện người dùng.
Ý nghĩa Thiếu một phần của thư mục chương trình, thường do phần mềm diệt virus đã gỡ nó.
Cần làm gì Kiểm tra khu cách ly của phần mềm diệt virus, rồi chạy lại trình cài đặt đè lên bản cài hiện có. Dự án của bạn không bị động đến.
Khởi động"The application backend did not start in time" hoặc "The application backend stopped responding while preparing the local database" (hoặc ở một bước khác).
Ý nghĩa Việc khởi động mất lâu hơn thời gian ứng dụng chờ. Thông báo nêu bước mà nó đang ở.
Cần làm gì Đóng cửa sổ và chạy lại. Hãy giải phóng dung lượng ổ đĩa trước nếu đĩa gần đầy. Nếu nó lại dừng ở cùng bước, hãy gửi cho chúng tôi desktop-launcher.log.
Khởi động"The application never finished unpacking itself, so its backend never started." hoặc "The application could not unpack itself into the temporary folder it uses."
Ý nghĩa Trên macOS và Linux, ứng dụng giải nén backend của nó mỗi lần chạy. Ổ đĩa chậm hoặc đầy, hoặc phần mềm diệt virus khóa tệp, sẽ cản việc đó. (Ứng dụng Windows không còn tự giải nén từ 18.5.)
Cần làm gì Giải phóng dung lượng trên ổ chứa thư mục tạm của bạn hoặc cho phép ứng dụng trong phần mềm diệt virus, rồi chạy lại.
Khởi động"The drive ran out of space while the application was starting" hoặc "There is not enough free space to start the application".
Ý nghĩa Đúng như vậy. Thông báo nêu thư mục và dung lượng trống còn lại.
Cần làm gì Giải phóng dung lượng trên ổ đó và chạy lại.
Khi đang chạy"The application backend stopped, restarting" và cửa sổ tải lại.
Ý nghĩa Phần chạy ngầm của ứng dụng đột ngột dừng và ứng dụng đã khởi động lại nó. Công việc đã lưu vẫn còn. Nó chỉ làm vậy tối đa hai lần trong 30 phút.
Cần làm gì Cứ tiếp tục. Nếu lặp lại hoặc bạn thấy "The application backend has stopped", hãy gửi cho chúng tôi desktop-launcher.log và logs/backend-crash.log.
Khởi độngMỗi lần bạn chạy ứng dụng, bạn bị đăng xuất và ngôn ngữ trở về tiếng Anh.
Ý nghĩa Một chương trình khác đang dùng cổng 8732, cổng mà ứng dụng thường dùng. Khi đó bản 18.5.0 chọn một cổng trống ngẫu nhiên mỗi lần chạy, và cửa sổ coi mỗi cổng mới là một trang web mới, nên không tìm thấy phiên đăng nhập và ngôn ngữ.
Cần làm gì Đóng hoặc cấu hình lại chương trình kia đang dùng cổng 8732 (trên Windows chạy netstat -ano | findstr :8732 trong terminal để xem process ID của nó). Dự án của bạn không bị ảnh hưởng, chỉ có đăng nhập và lựa chọn ngôn ngữ.
Khởi độngBạn lo ứng dụng xung đột với một PostgreSQL mà bạn đã chạy sẵn trên cổng 5432.
Ý nghĩa Không xung đột. Cơ sở dữ liệu tích hợp trên Windows lấy một cổng cục bộ trống ngẫu nhiên, còn trên macOS và Linux nó chỉ lắng nghe trên một socket cục bộ, không phải cổng TCP.
Cần làm gì Không cần làm gì.
Cài đặt"OpenConstructionERP is damaged and can't be opened" (nội dung có thể hiện bằng ngôn ngữ của hệ thống bạn).
Ý nghĩa Apple chưa notarize ứng dụng và nó vẫn mang dấu tải về. Ứng dụng không bị hỏng.
Cần làm gì Chỉ cách này có tác dụng: trong Terminal chạy một lần xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app rồi mở ứng dụng bình thường.
Cài đặt"OpenConstructionERP cannot be opened because the developer cannot be verified" (hoặc Apple không thể xác minh rằng nó không có mã độc; nội dung có thể hiện bằng ngôn ngữ của hệ thống bạn).
Ý nghĩa Ứng dụng được ký ad hoc nhưng Apple chưa notarize.
Cần làm gì Chạy cùng lệnh xattr đó hoặc mở System Settings, Privacy & Security, cuộn xuống và bấm Open Anyway. Bạn chỉ làm một lần.
Cài đặtỨng dụng hoàn toàn không chạy trên máy Mac của bạn.
Ý nghĩa Bản cho Mac chỉ dành cho Apple Silicon (M1 trở lên). Không có bản cho Intel.
Cần làm gì Trên Mac dùng Intel hãy dùng pip (Python 3.12 trở lên) hoặc Docker.
Nhật ký nằm ở đâu
desktop-launcher.log~/.openestimate/desktop-launcher.logMọi việc ứng dụng máy tính để bàn đã làm khi khởi động. Luôn nằm trong thư mục home của bạn, kể cả khi bạn đã chuyển thư mục dữ liệu đi nơi khác.backend-crash.log~/.openestimate/logs/backend-crash.logChi tiết về một lần dừng đột ngột. Nằm trong thư mục dữ liệu, nên di chuyển cùng vớiOE_DATA_DIR.database log folder~/.openestimate/pgdata/logVì sao cơ sở dữ liệu tích hợp không khởi động.
Để mở thư mục từ terminal:
open ~/.openestimateLinux
Linux: .deb (Ubuntu, Debian, Mint)
- 1
Tải
OpenConstructionERP_18.5.0_amd64.deb.Bạn sẽ thấyMột tệp khoảng 830 MB.
- 2
Trong terminal, tại thư mục tải về, chạy.
sudo apt install ./OpenConstructionERP_18.5.0_amd64.debBạn sẽ thấyapt liệt kê gói và các thư viện nó cần rồi cài đặt. Dấu ./ trước tên tệp là quan trọng.
- 3
Mở OpenConstructionERP từ menu ứng dụng.
Bạn sẽ thấyMàn hình tải. Lần chạy đầu tiên mất một hoặc hai phút.
- 4
Đăng nhập bằng tài khoản demo: email demo@openconstructionerp.com, mật khẩu DemoPass1234!. Sau đó bạn có thể tạo tài khoản và dự án của riêng mình.
Bạn sẽ thấyỨng dụng. Các dự án demo được tạo ngầm ở lần chạy đầu tiên, nên danh sách dự án có thể báo trong chốc lát rằng chúng đang được tạo.
- 5
Với bản cài mới, quản trị viên được hỏi một lần bạn sẽ dùng những module nào. Tích những module cần rồi tiếp tục. Sau này bạn có thể đổi bằng nút Background services trên thanh phía trên.
Bạn sẽ thấyMột danh sách module hiện một lần, kèm dung lượng bộ nhớ mỗi module cần.
Linux: .rpm (Fedora, RHEL, Rocky)
- 1
Tải
OpenConstructionERP-18.5.0-1.x86_64.rpm.Bạn sẽ thấyMột tệp khoảng 850 MB.
- 2
Chạy.
sudo dnf install ./OpenConstructionERP-18.5.0-1.x86_64.rpmBạn sẽ thấydnf giải quyết các phụ thuộc và cài đặt.
- 3
Mở OpenConstructionERP từ menu ứng dụng.
Bạn sẽ thấyMàn hình tải. Lần chạy đầu tiên mất một hoặc hai phút.
- 4
Đăng nhập bằng tài khoản demo: email demo@openconstructionerp.com, mật khẩu DemoPass1234!. Sau đó bạn có thể tạo tài khoản và dự án của riêng mình.
Bạn sẽ thấyỨng dụng. Các dự án demo được tạo ngầm ở lần chạy đầu tiên, nên danh sách dự án có thể báo trong chốc lát rằng chúng đang được tạo.
- 5
Với bản cài mới, quản trị viên được hỏi một lần bạn sẽ dùng những module nào. Tích những module cần rồi tiếp tục. Sau này bạn có thể đổi bằng nút Background services trên thanh phía trên.
Bạn sẽ thấyMột danh sách module hiện một lần, kèm dung lượng bộ nhớ mỗi module cần.
Linux: AppImage (any distribution)
- 1
Tải
OpenConstructionERP_18.5.0_amd64.AppImage.Bạn sẽ thấyMột tệp khoảng 910 MB.
- 2
Cho phép tệp thực thi.
chmod +x OpenConstructionERP_18.5.0_amd64.AppImageBạn sẽ thấyKhông có kết quả in ra.
- 3
Chạy nó.
./OpenConstructionERP_18.5.0_amd64.AppImageBạn sẽ thấyMàn hình tải. Lần chạy đầu tiên mất một hoặc hai phút.
- 4
Đăng nhập bằng tài khoản demo: email demo@openconstructionerp.com, mật khẩu DemoPass1234!. Sau đó bạn có thể tạo tài khoản và dự án của riêng mình.
Bạn sẽ thấyỨng dụng. Các dự án demo được tạo ngầm ở lần chạy đầu tiên, nên danh sách dự án có thể báo trong chốc lát rằng chúng đang được tạo.
- 5
Với bản cài mới, quản trị viên được hỏi một lần bạn sẽ dùng những module nào. Tích những module cần rồi tiếp tục. Sau này bạn có thể đổi bằng nút Background services trên thanh phía trên.
Bạn sẽ thấyMột danh sách module hiện một lần, kèm dung lượng bộ nhớ mỗi module cần.
Nếu bạn thấy một thông báo
Khởi độngMàn hình tải đứng yên một phút hoặc lâu hơn ở lần chạy đầu tiên.
Ý nghĩa Ứng dụng tạo cơ sở dữ liệu cục bộ của nó. Việc này chỉ xảy ra một lần.
Cần làm gì Hãy chờ và đừng đóng cửa sổ. Trên ổ đĩa chậm hoặc gần đầy, việc này có thể lâu hơn. Các lần chạy sau rất nhanh.
Khởi động"The backend started, but the local database is not answering, so the app cannot open."Ý nghĩa: phần máy chủ đã khởi động, nhưng cơ sở dữ liệu cục bộ của nó không phản hồi, nên không thể mở ứng dụng.
Ý nghĩa Cơ sở dữ liệu cục bộ không khởi động, thường sau một phiên làm việc không được đóng sạch.
Cần làm gì Khởi động lại máy tính và chạy lại ứng dụng. Nếu lặp lại, hãy gửi cho chúng tôi desktop-launcher.log và nhật ký của cơ sở dữ liệu (xem Nhật ký).
Khởi động"The backend started, but this installation is missing the application files it serves"Ý nghĩa: phần máy chủ đã khởi động, nhưng bản cài đặt thiếu các tệp giao diện người dùng.
Ý nghĩa Thiếu một phần của thư mục chương trình, thường do phần mềm diệt virus đã gỡ nó.
Cần làm gì Kiểm tra khu cách ly của phần mềm diệt virus, rồi chạy lại trình cài đặt đè lên bản cài hiện có. Dự án của bạn không bị động đến.
Khởi động"The application backend did not start in time" hoặc "The application backend stopped responding while preparing the local database" (hoặc ở một bước khác).
Ý nghĩa Việc khởi động mất lâu hơn thời gian ứng dụng chờ. Thông báo nêu bước mà nó đang ở.
Cần làm gì Đóng cửa sổ và chạy lại. Hãy giải phóng dung lượng ổ đĩa trước nếu đĩa gần đầy. Nếu nó lại dừng ở cùng bước, hãy gửi cho chúng tôi desktop-launcher.log.
Khởi động"The application never finished unpacking itself, so its backend never started." hoặc "The application could not unpack itself into the temporary folder it uses."
Ý nghĩa Trên macOS và Linux, ứng dụng giải nén backend của nó mỗi lần chạy. Ổ đĩa chậm hoặc đầy, hoặc phần mềm diệt virus khóa tệp, sẽ cản việc đó. (Ứng dụng Windows không còn tự giải nén từ 18.5.)
Cần làm gì Giải phóng dung lượng trên ổ chứa thư mục tạm của bạn hoặc cho phép ứng dụng trong phần mềm diệt virus, rồi chạy lại.
Khởi động"The drive ran out of space while the application was starting" hoặc "There is not enough free space to start the application".
Ý nghĩa Đúng như vậy. Thông báo nêu thư mục và dung lượng trống còn lại.
Cần làm gì Giải phóng dung lượng trên ổ đó và chạy lại.
Khi đang chạy"The application backend stopped, restarting" và cửa sổ tải lại.
Ý nghĩa Phần chạy ngầm của ứng dụng đột ngột dừng và ứng dụng đã khởi động lại nó. Công việc đã lưu vẫn còn. Nó chỉ làm vậy tối đa hai lần trong 30 phút.
Cần làm gì Cứ tiếp tục. Nếu lặp lại hoặc bạn thấy "The application backend has stopped", hãy gửi cho chúng tôi desktop-launcher.log và logs/backend-crash.log.
Khởi độngMỗi lần bạn chạy ứng dụng, bạn bị đăng xuất và ngôn ngữ trở về tiếng Anh.
Ý nghĩa Một chương trình khác đang dùng cổng 8732, cổng mà ứng dụng thường dùng. Khi đó bản 18.5.0 chọn một cổng trống ngẫu nhiên mỗi lần chạy, và cửa sổ coi mỗi cổng mới là một trang web mới, nên không tìm thấy phiên đăng nhập và ngôn ngữ.
Cần làm gì Đóng hoặc cấu hình lại chương trình kia đang dùng cổng 8732 (trên Windows chạy netstat -ano | findstr :8732 trong terminal để xem process ID của nó). Dự án của bạn không bị ảnh hưởng, chỉ có đăng nhập và lựa chọn ngôn ngữ.
Khởi độngBạn lo ứng dụng xung đột với một PostgreSQL mà bạn đã chạy sẵn trên cổng 5432.
Ý nghĩa Không xung đột. Cơ sở dữ liệu tích hợp trên Windows lấy một cổng cục bộ trống ngẫu nhiên, còn trên macOS và Linux nó chỉ lắng nghe trên một socket cục bộ, không phải cổng TCP.
Cần làm gì Không cần làm gì.
Cài đặt.deb yêu cầu libwebkit2gtk-4.1-0 hoặc dpkg báo các phụ thuộc chưa được đáp ứng.
Ý nghĩa Ứng dụng cần WebKitGTK 4.1 để vẽ cửa sổ của nó. dpkg -i không cài các phụ thuộc.
Cần làm gì Cài bằng sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb, lệnh này kéo theo cả thư viện. Nếu bản phân phối của bạn không có libwebkit2gtk-4.1-0 (Ubuntu cũ hơn 22.04, Debian cũ hơn 12), hãy dùng pip.
Cài đặtAppImage không làm gì khi bấm đúp.
Ý nghĩa Tệp chưa được đánh dấu là chương trình.
Cần làm gì Chạy chmod +x OpenConstructionERP_18.5.0_amd64.AppImage rồi chạy lại.
Cài đặtMột lỗi AppImage nhắc đến FUSE hoặc libfuse.so.2.
Ý nghĩa Các bản phân phối mới hơn không còn cài thư viện FUSE 2 mà AppImage dùng.
Cần làm gì Cài nó (sudo apt install libfuse2, trên Ubuntu 24.04 là sudo apt install libfuse2t64) hoặc dùng .deb, .rpm hay pip.
Nhật ký nằm ở đâu
desktop-launcher.log~/.openestimate/desktop-launcher.logMọi việc ứng dụng máy tính để bàn đã làm khi khởi động. Luôn nằm trong thư mục home của bạn, kể cả khi bạn đã chuyển thư mục dữ liệu đi nơi khác.backend-crash.log~/.openestimate/logs/backend-crash.logChi tiết về một lần dừng đột ngột. Nằm trong thư mục dữ liệu, nên di chuyển cùng vớiOE_DATA_DIR.database log folder~/.openestimate/pgdata/logVì sao cơ sở dữ liệu tích hợp không khởi động.
Để mở thư mục từ terminal:
xdg-open ~/.openestimatepip
- 1
Chạy.
pip install --upgrade openconstructionerpBạn sẽ thấypip tải gói và các phụ thuộc của nó.
- 2
Chạy.
openconstructionerpBạn sẽ thấyMột lời chào ngắn. Ở lần chạy đầu tiên, nó hỏi có nạp các dự án demo không và có mở trình duyệt không.
- 3
Chờ trong lúc cơ sở dữ liệu cục bộ được thiết lập.
Bạn sẽ thấy"Database: embedded PostgreSQL 16 (no Docker)" rồi máy chủ khởi động. Trình duyệt của bạn mở http://127.0.0.1:8080 (giống http://localhost:8080).
- 4
Đăng nhập. Với dữ liệu demo bạn có thể dùng demo@openconstructionerp.com / DemoPass1234!
Bạn sẽ thấyBảng điều khiển.
- 5
Với bản cài mới, quản trị viên được hỏi một lần bạn sẽ dùng những module nào. Tích những module cần rồi tiếp tục. Sau này bạn có thể đổi bằng nút Background services trên thanh phía trên.
Bạn sẽ thấyMột danh sách module hiện một lần, kèm dung lượng bộ nhớ mỗi module cần.
- 6
Để dừng, nhấn Ctrl+C trong terminal. Lần sau chỉ cần chạy lại openconstructionerp.
Bạn sẽ thấyMáy chủ dừng. Dữ liệu của bạn nằm lại trong thư mục
.openestimateở thư mục home.
Các lệnh hữu ích
Không tìm thấy lệnh openconstructionerp
python -m openconstructionerpCó gì đó không hoạt động: kiểm tra Python, cổng, thư mục dữ liệu và cơ sở dữ liệu rồi cho biết cần làm gì
openconstructionerp doctorCổng 8080 đang được chương trình khác dùng
openconstructionerp serve --port 8081Các máy tính khác trong mạng của bạn cần truy cập được
openconstructionerp serve --host 0.0.0.0 --port 8080Bạn cần cho chúng tôi biết phiên bản của bạn
openconstructionerp --versionNếu bạn thấy một thông báo
Cài đặtpip báo không tìm thấy bản phân phối phù hợp hoặc cần một Python khác.
Ý nghĩa OpenConstructionERP cần Python 3.12 trở lên.
Cần làm gì Cài Python 3.12 trở lên và chạy python3.12 -m pip install --upgrade openconstructionerp (trên Windows: py -3.12 -m pip install --upgrade openconstructionerp).
Cài đặterror: externally-managed-environment (Ubuntu 23.04+, Debian 12+).Ý nghĩa: hệ thống Linux của bạn bảo vệ Python riêng của nó và từ chối cài đặt gói vào đó.
Ý nghĩa Python của hệ thống không cho pip cài vào trong nó.
Cần làm gì Dùng pipx install openconstructionerp hoặc tạo môi trường ảo trước: python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp.
Khởi động"openconstructionerp" is not recognized hoặc command not found.
Ý nghĩa Thư mục nơi pip đặt các lệnh không nằm trong PATH của bạn (thường gặp trên Windows).
Cần làm gì Hãy chạy python -m openconstructionerp thay thế. Cách này chạy trên mọi hệ thống mà không cần đụng đến PATH.
Khởi động"Port 8080 is already in use. Try: openconstructionerp serve --port 8081"Ý nghĩa: một chương trình khác đang dùng cổng 8080, hãy khởi động ứng dụng trên cổng khác, ví dụ 8081.
Ý nghĩa Một chương trình khác đang dùng cổng 8080.
Cần làm gì Chạy lệnh được gợi ý và mở địa chỉ mà nó in ra.
Khởi động"Embedded PostgreSQL could not start".Ý nghĩa: không thể khởi động cơ sở dữ liệu PostgreSQL tích hợp.
Ý nghĩa Cơ sở dữ liệu tích hợp không khởi động. Thông báo in ra đường dẫn nhật ký của nó.
Cần làm gì Chạy openconstructionerp doctor. Nếu không giúp được, cài lại bằng pip install --upgrade --force-reinstall openconstructionerp và gửi cho chúng tôi nhật ký mà nó nêu.
Nhật ký nằm ở đâu
terminal outputthe terminal window (pip);docker compose logs app(Docker)Với pip và Docker, hãy sao chép những gì terminal đã in ra và kết quả củaopenconstructionerp doctor.
Docker
- 1
Trong một thư mục trống, tải hai tệp 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.ymlBạn sẽ thấyHai tệp trong thư mục.
- 2
Tạo tệp bí mật một lần.
echo "POSTGRES_PASSWORD=$(openssl rand -base64 24)" > .envecho "JWT_SECRET=$(openssl rand -hex 32)" >> .envBạn sẽ thấyMột tệp
.env. Hãy giữ nó cẩn thận: nó chứa mật khẩu cơ sở dữ liệu và khóa bí mật đăng nhập. - 3
Khởi động.
docker compose pull app && docker compose up -dBạn sẽ thấyHai container khởi động: postgres và app.
- 4
Mở http://localhost:8080 và đăng nhập bằng demo@openconstructionerp.com / DemoPass1234!
Bạn sẽ thấyTrang đăng nhập. Lần chạy đầu tiên có thể mất một phút trong lúc cơ sở dữ liệu được chuẩn bị.
- 5
Với bản cài mới, quản trị viên được hỏi một lần bạn sẽ dùng những module nào. Tích những module cần rồi tiếp tục. Sau này bạn có thể đổi bằng nút Background services trên thanh phía trên.
Bạn sẽ thấyMột danh sách module hiện một lần, kèm dung lượng bộ nhớ mỗi module cần.
Các lệnh hữu ích
Kiểm tra cả hai container đang chạy và khỏe
docker compose psXem vì sao ứng dụng không khởi động
docker compose logs appCổng 8080 trên máy bạn đang bận
OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -dCấu hình compose này dành cho đánh giá và dùng cục bộ. Với máy chủ production, xem docs/INSTALL_LINUX.md và docker-compose.prod.yml trong kho mã.
Nếu bạn thấy một thông báo
Khởi độngCompose dừng với "POSTGRES_PASSWORD must be set" hoặc "JWT_SECRET must be set".
Ý nghĩa Tệp .env chứa hai giá trị bí mật bị thiếu hoặc không nằm cùng thư mục.
Cần làm gì Tạo tệp .env như ở bước 2, trong thư mục có docker-compose.yml.
Khởi độnghttp://localhost:8080 không mở được.
Ý nghĩa Container chưa chạy hoặc cổng 8080 đang bận.
Cần làm gì Chạy docker compose ps và docker compose logs app. Để dùng cổng khác: OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d rồi mở http://localhost:8081.
Cài đặtTrên Mac dùng Apple Silicon hoặc máy ARM khác, Docker cảnh báo nền tảng của image linux/amd64 không khớp, hoặc ứng dụng chạy rất chậm.
Ý nghĩa Image đã phát hành chỉ được dựng cho x86-64.
Cần làm gì Dựng từ mã nguồn bằng make quickstart hoặc dùng pip.
Nhật ký nằm ở đâu
terminal outputthe terminal window (pip);docker compose logs app(Docker)Với pip và Docker, hãy sao chép những gì terminal đã in ra và kết quả củaopenconstructionerp doctor.
Dữ liệu của bạn, nâng cấp và gỡ cài đặt
- Windows
C:\Users\<your name>\.openestimateCộng thêmC:\ProgramData\OpenConstructionERP\clusters\<id>\pgdatanếu tên người dùng của bạn có ký tự không phải Latin;pgdata.locationcho biết điều đó. - macOS~/
.openestimate(ẩn; nhấn Cmd+Shift+. trong Finder) - Linux~/
.openestimate - pip~/
.openestimate, cùng thư mục với ứng dụng máy tính để bàn, trừ khi bạn truyền--data-dirhoặc đặtOE_DATA_DIR - DockerCác volume Docker <folder>_pg_data (cơ sở dữ liệu) và <folder>_app_data (tệp), trong đó <folder> là tên thư mục chứa
docker-compose.yml
Nâng cấp
Cài bản mới đè lên bản cũ. Thư mục .openestimate của bạn không thuộc về chương trình, nên dự án, người dùng và cài đặt vẫn còn. Lần chạy đầu tiên sau khi nâng cấp có thể lâu hơn khi cơ sở dữ liệu tự cập nhật.
Gỡ cài đặt
Gỡ cài đặt xóa chương trình và giữ lại dự án của bạn. Trên Windows, trình gỡ cài đặt có lựa chọn "Delete the application data" (theo ngôn ngữ của trình cài đặt): nó chỉ xóa phiên đăng nhập và ngôn ngữ mà cửa sổ ứng dụng đã lưu (trong %APPDATA% và %LOCALAPPDATA%\io.openconstructionerp.desktop), không xóa dự án của bạn. Để làm lại từ đầu, hãy gỡ cài đặt, sao chép .openestimate ra nơi an toàn rồi xóa nó.
Sao lưu
Đóng ứng dụng và sao chép thư mục .openestimate (cùng thư mục ProgramData được nêu trong pgdata.location, nếu có).
Vẫn bị kẹt? Chúng tôi sẽ giúp
Vui lòng kèm theo:
- phiên bản (có trong tên tệp bạn đã tải; pip:
openconstructionerp --version; Docker: thẻ của image) và cách bạn cài đặt (trình cài đặt Windows, .dmg, .deb, .rpm, AppImage, pip hoặc Docker) - hệ thống của bạn (Windows: Start, gõ
winver; macOS: menu Apple, About This Mac; Linux: bản phân phối và phiên bản) - nội dung chính xác của thông báo hoặc một ảnh chụp màn hình
- các tệp nhật ký được liệt kê ở trên
Tệp nhật ký có thể chứa tên người dùng và tên thư mục của bạn. Hãy xem lại trước khi đăng công khai; nếu muốn, tốt hơn là gửi qua email.
Các bước tiếp theo sau khi cài đặt
Bản đầy đủ cũng có trên GitHub bằng English, Deutsch và Русский.