Ajutor la instalare
Instalarea OpenConstructionERP
Alegeți cum vreți să-l rulați, urmați pașii numerotați și, dacă ceva nu arată bine, găsiți mesajul pe care îl vedeți în lista de probleme de mai jos. Niciunul dintre avertismentele din timpul instalării nu vă pune proiectele în pericol.
Nu știți care vi se potrivește?
- Folosiți Windows 10 sau 11Program de instalare pentru Windows (.exe)
- Aveți un Mac cu cip M1, M2, M3 sau M4macOS (.dmg, Apple Silicon)
- Aveți un Mac cu Intelpip sau Docker (nu există aplicație pentru Mac cu Intel)
- Folosiți Ubuntu, Debian sau Linux MintLinux .deb
- Folosiți Fedora, RHEL sau Rocky LinuxLinux .rpm
- Folosiți o altă distribuție LinuxLinux AppImage
- Aveți deja Python 3.12 sau mai nou, ori îl vreți pe un serverpip
- Folosiți Docker sau îl configurați pentru o echipăDocker
Priviți mai întâi
Cum instalezi OpenConstructionERP
Ghid video pe Windows, înregistrat cu versiunea 17.7.1. Unele ecrane arată altfel în 18.5, iar timpul de așteptare de la instalare este scurtat în video.
Windows
- 1
Descărcați
OpenConstructionERP_18.5.0_x64-setup.exede pe pagina versiunii.Veți vedeaUn fișier de aproximativ 800 MB în folderul Downloads.
- 2
Faceți dublu clic pe el. Dacă o fereastră albastră spune "Windows v-a protejat computerul" ("Windows protected your PC"), faceți clic pe Mai multe informații ("More info"), verificați că numele fișierului începe cu OpenConstructionERP, apoi faceți clic pe Executați oricum ("Run anyway").
Veți vedeaWindows cere permisiune de administrator. Faceți clic pe Da.
- 3
Alegeți limba programului de instalare, acceptați licența și păstrați folderul propus
C:\Program Files\OpenConstructionERP.Veți vedeaO bară de progres, apoi o pagină de final.
- 4
Faceți clic pe Terminare sau porniți OpenConstructionERP din meniul Start.
Veți vedeaUn ecran de încărcare "Se pornește aplicația" cu o listă: se pornește backendul, se pornește baza de date locală, se pregătește baza de date, se pornește serverul aplicației, se deschide aplicația.
- 5
Așteptați la cea mai primă pornire. Nu închideți fereastra.
Veți vedea"Prima rulare configurează baza de date locală. Poate dura un minut sau două, vă rugăm așteptați." Pornirile următoare sunt mult mai rapide.
- 6
Alegeți cum se deschide: ca fereastră de aplicație (recomandat) sau în browserul dvs. obișnuit.
Veți vedea"Cum doriți să deschideți OpenConstructionERP?" și apoi pagina de autentificare.
- 7
Autentificați-vă cu contul demo: e-mail demo@openconstructionerp.com, parola DemoPass1234!. Apoi puteți crea propriul cont și propriile proiecte.
Veți vedeaAplicația. Proiectele demo se creează în fundal la prima pornire, deci lista de proiecte poate spune pentru scurt timp că sunt pe drum.
- 8
La o instalare nouă, administratorul este întrebat o singură dată ce module veți folosi. Bifați ce vă trebuie și continuați. Puteți schimba mai târziu cu butonul Servicii de fundal din bara de sus.
Veți vedeaO listă unică de module, cu memoria de care au nevoie.
Dacă vedeți un mesaj
InstalareO fereastră albastră "Windows v-a protejat computerul" ("Windows protected your PC").
Ce înseamnă Programul de instalare nu este încă semnat cu cod, așa că Windows nu cunoaște editorul. Este un avertisment, nu detectarea unui virus.
Ce faceți Faceți clic pe Mai multe informații ("More info"), verificați că numele fișierului începe cu OpenConstructionERP, apoi faceți clic pe Executați oricum ("Run anyway").
InstalareSmart App Control a blocat aplicația, fără buton pentru a continua.
Ce înseamnă Smart App Control din Windows 11 refuză programele nesemnate.
Ce faceți Smart App Control nu poate permite o singură aplicație. Ca să rămână pornit, rulați OpenConstructionERP cu Docker Desktop sau în WSL (Linuxul integrat în Windows), pe care Smart App Control nu le verifică. Instrucțiuni pas cu pas: docs/desktop/WINDOWS_BLOCKED.md în repository.
Instalare"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" (mesajul există doar în engleză)Semnificație: calea folderului de instalare poate conține doar litere latine, cifre și spații, deoarece baza de date încorporată nu poate porni din nicio altă cale.
Ce înseamnă Folderul ales are în cale litere chirilice, chinezești, cu accente sau alte litere nelatine.
Ce faceți Păstrați folderul propus C:\Program Files\OpenConstructionERP sau alegeți un folder precum C:\OpenConstructionERP. O instalare silențioasă (/S) se termină cu codul 3 și scrie motivul în %TEMP%\OpenConstructionERP-install-error.log.
InstalareProgramul de instalare se oprește cu o eroare despre WebView2.
Ce înseamnă Windows a refuzat să instaleze Microsoft WebView2, componenta care desenează fereastra aplicației. Este inclusă în programul de instalare, deci nu aveți nevoie de internet; eroarea vine de la Windows însuși (politică, o actualizare în așteptare sau un WebView2 anterior deteriorat).
Ce faceți Reporniți calculatorul și rulați din nou programul de instalare. Dacă eșuează iar, instalați "Microsoft Edge WebView2 Runtime" de la Microsoft, apoi rulați încă o dată programul nostru de instalare.
InstalareAntivirusul șterge sau pune în carantină un fișier în timpul instalării sau la prima pornire.
Ce înseamnă Programul este nou și nesemnat, iar unele antivirusuri se uită suspicios la asta.
Ce faceți Restaurați fișierul din carantină și adăugați aceste două foldere la excepții: folderul programului C:\Program Files\OpenConstructionERP și folderul dvs. de date C:\Users\<your name>\.openestimate. Apoi rulați din nou programul de instalare peste instalarea existentă. Dacă nu sunteți sigur că fișierul este autentic, scrieți-ne mai întâi.
ActualizareUn ecran care întreabă dacă să suprascrie versiunea instalată sau să o elimine mai întâi, cu o linie care sugerează eliminarea.
Ce faceți Păstrați opțiunea deja selectată (suprascriere). Proiectele dvs. se păstrează. Prima pornire după o actualizare poate dura mai mult cât timp baza de date se actualizează singură.
ActualizareRulați OpenConstructionERP și din pip sau dintr-un terminal pe același calculator, iar se oprește în timpul actualizării.
Ce înseamnă Ambele folosesc același folder .openestimate și aceeași bază de date. Programul de instalare oprește acea bază de date ca să înlocuiască programul. La actualizarea de la 18.4.0, vechiul program de dezinstalare închide și orice program numit openconstructionerp.exe.
Ce faceți Opriți versiunea din terminal (Ctrl+C) înainte de instalare sau actualizare și porniți-o din nou după aceea.
PornireEcranul de încărcare rămâne un minut sau mai mult la cea mai primă pornire.
Ce înseamnă Aplicația își creează baza de date locală. Se întâmplă o singură dată.
Ce faceți Așteptați și nu închideți fereastra. Pe un disc lent sau aproape plin poate dura mai mult. Pornirile următoare sunt rapide.
PornireO casetă "OpenConstructionERP failed to start" care indică un fișier jurnal.
Ce înseamnă Aplicația nu a putut deschide deloc fereastra.
Ce faceți Porniți-o încă o dată. Dacă apare din nou caseta, trimiteți-ne fișierul jurnal indicat.
Pornire"The backend started, but the local database is not answering, so the app cannot open."Semnificație: partea de server a pornit, dar baza ei de date locală nu răspunde, deci aplicația nu se poate deschide.
Ce înseamnă Baza de date locală nu a pornit, adesea după o rulare care nu s-a închis curat.
Ce faceți Reporniți calculatorul și porniți din nou aplicația. Dacă se repetă, trimiteți-ne desktop-launcher.log și jurnalul bazei de date (vezi Jurnale).
Pornire"The backend started, but this installation is missing the application files it serves"Semnificație: partea de server a pornit, dar instalării îi lipsesc fișierele interfeței cu utilizatorul.
Ce înseamnă Lipsește o parte din folderul programului, de obicei ștearsă de antivirus.
Ce faceți Verificați carantina antivirusului, apoi rulați din nou programul de instalare peste instalarea existentă. Proiectele dvs. nu sunt atinse.
Pornire"The application backend did not start in time" sau "The application backend stopped responding while preparing the local database" (sau la alt pas).
Ce înseamnă Pornirea a durat mai mult decât așteaptă aplicația. Mesajul indică pasul la care era.
Ce faceți Închideți fereastra și porniți din nou. Eliberați mai întâi spațiu pe disc dacă acesta este aproape plin. Dacă se oprește iar la același pas, trimiteți-ne desktop-launcher.log.
Pornire"The drive ran out of space while the application was starting" sau "There is not enough free space to start the application".
Ce înseamnă Exact asta. Mesajul indică folderul și spațiul liber rămas.
Ce faceți Eliberați spațiu pe acea unitate și porniți din nou.
PornireUn mesaj că folderul bazei de date locale "sits too deep in the filesystem", cu două numere.
Ce înseamnă Windows limitează lungimea căii, iar calea folderului dvs. de date este prea lungă pentru fișierele bazei de date. Activarea căilor lungi în Windows nu ajută.
Ce faceți Setați variabila de mediu de utilizator OE_DATA_DIR la o cale scurtă, cum ar fi C:\OpenConstructionERP\data (Start, tastați "variabile de mediu", Editați variabilele de mediu pentru contul dvs., Nouă), apoi porniți din nou.
PornireNumele dvs. de utilizator Windows are litere nelatine (de exemplu chirilice sau chinezești), iar căutați baza de date.
Ce înseamnă Baza de date integrată nu poate rula dintr-o astfel de cale, așa că de la 18.5.0 aplicația ține baza de date în C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata. Înainte de 18.5.0, aplicația nu putea porni deloc pentru astfel de conturi.
Ce faceți Nu e nimic de reparat. Fișierul pgdata.location din folderul dvs. .openestimate indică folderul exact al bazei de date. Pentru copii de siguranță copiați ambele foldere.
În funcțiune"The application backend stopped, restarting" și fereastra se reîncarcă.
Ce înseamnă Partea din fundal a aplicației s-a oprit pe neașteptate, iar aplicația a repornit-o. Munca salvată se păstrează. Face asta de cel mult două ori în 30 de minute.
Ce faceți Continuați. Dacă se repetă sau vedeți "The application backend has stopped", trimiteți-ne desktop-launcher.log și logs/backend-crash.log.
PornireDe fiecare dată când porniți aplicația sunteți deconectat, iar limba revine la engleză.
Ce înseamnă Alt program folosește portul 8732, pe care îl folosește de obicei aplicația. Versiunea 18.5.0 alege atunci la fiecare pornire un port liber aleator, iar fereastra tratează fiecare port nou ca pe un site nou, deci autentificarea și limba nu sunt găsite.
Ce faceți Închideți sau reconfigurați celălalt program care folosește portul 8732 (în Windows, rulați netstat -ano | findstr :8732 într-un terminal ca să vedeți ID-ul procesului). Proiectele dvs. nu sunt afectate, doar autentificarea și alegerea limbii.
PornireVă temeți că aplicația intră în conflict cu un PostgreSQL pe care îl rulați deja pe portul 5432.
Ce înseamnă Nu intră. Baza de date integrată ia în Windows un port local liber aleator, iar în macOS și Linux ascultă doar pe un socket local, nu pe un port TCP.
Ce faceți Nu e nimic de făcut.
Unde sunt jurnalele
desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.logTot ce a făcut aplicația desktop la pornire. Întotdeauna în folderul dvs. home, chiar dacă ați mutat folderul de date.backend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.logDetalii despre o oprire neașteptată. Se află în folderul de date, deci se mută odată cuOE_DATA_DIR.database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder frompgdata.location>\log)De ce nu a pornit baza de date integrată.OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log(tastați%TEMP%în bara de adrese din Explorer)De ce a refuzat programul de instalare Windows folderul de instalare.
Ca să deschideți folderul, lipiți aceasta în bara de adrese din Explorer:
%USERPROFILE%\.openestimatemacOS
- 1
Descărcați
OpenConstructionERP_18.5.0_aarch64.dmgși deschideți-l.Veți vedeaO fereastră cu pictograma aplicației OpenConstructionERP.
- 2
Trageți OpenConstructionERP în Applications.
Veți vedeaAplicația apare în folderul Applications.
- 3
Deschideți Terminal o dată și rulați.
xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.appVeți vedeaFără rezultat. Este corect. Comanda elimină marcajul de descărcare, deoarece aplicația nu este încă notarizată de Apple.
- 4
Deschideți OpenConstructionERP din Applications.
Veți vedeaEcranul de încărcare "Se pornește aplicația". Prima pornire configurează baza de date locală și durează un minut sau două.
- 5
Alegeți fereastră de aplicație sau browser.
Veți vedeaPagina de autentificare.
- 6
Autentificați-vă cu contul demo: e-mail demo@openconstructionerp.com, parola DemoPass1234!. Apoi puteți crea propriul cont și propriile proiecte.
Veți vedeaAplicația. Proiectele demo se creează în fundal la prima pornire, deci lista de proiecte poate spune pentru scurt timp că sunt pe drum.
- 7
La o instalare nouă, administratorul este întrebat o singură dată ce module veți folosi. Bifați ce vă trebuie și continuați. Puteți schimba mai târziu cu butonul Servicii de fundal din bara de sus.
Veți vedeaO listă unică de module, cu memoria de care au nevoie.
Dacă vedeți un mesaj
PornireEcranul de încărcare rămâne un minut sau mai mult la cea mai primă pornire.
Ce înseamnă Aplicația își creează baza de date locală. Se întâmplă o singură dată.
Ce faceți Așteptați și nu închideți fereastra. Pe un disc lent sau aproape plin poate dura mai mult. Pornirile următoare sunt rapide.
Pornire"The backend started, but the local database is not answering, so the app cannot open."Semnificație: partea de server a pornit, dar baza ei de date locală nu răspunde, deci aplicația nu se poate deschide.
Ce înseamnă Baza de date locală nu a pornit, adesea după o rulare care nu s-a închis curat.
Ce faceți Reporniți calculatorul și porniți din nou aplicația. Dacă se repetă, trimiteți-ne desktop-launcher.log și jurnalul bazei de date (vezi Jurnale).
Pornire"The backend started, but this installation is missing the application files it serves"Semnificație: partea de server a pornit, dar instalării îi lipsesc fișierele interfeței cu utilizatorul.
Ce înseamnă Lipsește o parte din folderul programului, de obicei ștearsă de antivirus.
Ce faceți Verificați carantina antivirusului, apoi rulați din nou programul de instalare peste instalarea existentă. Proiectele dvs. nu sunt atinse.
Pornire"The application backend did not start in time" sau "The application backend stopped responding while preparing the local database" (sau la alt pas).
Ce înseamnă Pornirea a durat mai mult decât așteaptă aplicația. Mesajul indică pasul la care era.
Ce faceți Închideți fereastra și porniți din nou. Eliberați mai întâi spațiu pe disc dacă acesta este aproape plin. Dacă se oprește iar la același pas, trimiteți-ne desktop-launcher.log.
Pornire"The application never finished unpacking itself, so its backend never started." sau "The application could not unpack itself into the temporary folder it uses."
Ce înseamnă În macOS și Linux aplicația își despachetează backendul la fiecare pornire. Un disc lent sau plin, ori un antivirus care blochează fișierele, o împiedică. (Aplicația pentru Windows nu se mai despachetează de la 18.5.)
Ce faceți Eliberați spațiu pe unitatea cu folderul temporar sau permiteți aplicația în antivirus, apoi porniți din nou.
Pornire"The drive ran out of space while the application was starting" sau "There is not enough free space to start the application".
Ce înseamnă Exact asta. Mesajul indică folderul și spațiul liber rămas.
Ce faceți Eliberați spațiu pe acea unitate și porniți din nou.
În funcțiune"The application backend stopped, restarting" și fereastra se reîncarcă.
Ce înseamnă Partea din fundal a aplicației s-a oprit pe neașteptate, iar aplicația a repornit-o. Munca salvată se păstrează. Face asta de cel mult două ori în 30 de minute.
Ce faceți Continuați. Dacă se repetă sau vedeți "The application backend has stopped", trimiteți-ne desktop-launcher.log și logs/backend-crash.log.
PornireDe fiecare dată când porniți aplicația sunteți deconectat, iar limba revine la engleză.
Ce înseamnă Alt program folosește portul 8732, pe care îl folosește de obicei aplicația. Versiunea 18.5.0 alege atunci la fiecare pornire un port liber aleator, iar fereastra tratează fiecare port nou ca pe un site nou, deci autentificarea și limba nu sunt găsite.
Ce faceți Închideți sau reconfigurați celălalt program care folosește portul 8732 (în Windows, rulați netstat -ano | findstr :8732 într-un terminal ca să vedeți ID-ul procesului). Proiectele dvs. nu sunt afectate, doar autentificarea și alegerea limbii.
PornireVă temeți că aplicația intră în conflict cu un PostgreSQL pe care îl rulați deja pe portul 5432.
Ce înseamnă Nu intră. Baza de date integrată ia în Windows un port local liber aleator, iar în macOS și Linux ascultă doar pe un socket local, nu pe un port TCP.
Ce faceți Nu e nimic de făcut.
Instalare"OpenConstructionERP is damaged and can't be opened" (textul poate apărea în limba sistemului dvs.).
Ce înseamnă Aplicația nu este încă notarizată de Apple și poartă încă marcajul de descărcare. Aplicația nu este deteriorată.
Ce faceți Doar asta ajută: în Terminal rulați o dată xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app, apoi deschideți aplicația normal.
Instalare"OpenConstructionERP cannot be opened because the developer cannot be verified" (sau Apple nu a putut verifica dacă este lipsită de malware; textul poate apărea în limba sistemului dvs.).
Ce înseamnă Aplicația este semnată ad hoc, dar nu este încă notarizată de Apple.
Ce faceți Rulați aceeași comandă xattr sau deschideți System Settings, Privacy & Security, derulați în jos și faceți clic pe Open Anyway. Faceți asta o singură dată.
InstalareAplicația nu rulează deloc pe Mac-ul dvs.
Ce înseamnă Versiunea pentru Mac este doar pentru Apple Silicon (M1 și mai noi). Nu există versiune pentru Intel.
Ce faceți Pe un Mac cu Intel folosiți pip (Python 3.12 sau mai nou) sau Docker.
Unde sunt jurnalele
desktop-launcher.log~/.openestimate/desktop-launcher.logTot ce a făcut aplicația desktop la pornire. Întotdeauna în folderul dvs. home, chiar dacă ați mutat folderul de date.backend-crash.log~/.openestimate/logs/backend-crash.logDetalii despre o oprire neașteptată. Se află în folderul de date, deci se mută odată cuOE_DATA_DIR.database log folder~/.openestimate/pgdata/logDe ce nu a pornit baza de date integrată.
Ca să deschideți folderul dintr-un terminal:
open ~/.openestimateLinux
Linux: .deb (Ubuntu, Debian, Mint)
- 1
Descărcați
OpenConstructionERP_18.5.0_amd64.deb.Veți vedeaUn fișier de aproximativ 830 MB.
- 2
Într-un terminal, în folderul de descărcare, rulați.
sudo apt install ./OpenConstructionERP_18.5.0_amd64.debVeți vedeaapt listează pachetul și bibliotecile de care are nevoie, apoi le instalează. ./ din fața numelui fișierului contează.
- 3
Porniți OpenConstructionERP din meniul de aplicații.
Veți vedeaEcranul de încărcare. Prima pornire durează un minut sau două.
- 4
Autentificați-vă cu contul demo: e-mail demo@openconstructionerp.com, parola DemoPass1234!. Apoi puteți crea propriul cont și propriile proiecte.
Veți vedeaAplicația. Proiectele demo se creează în fundal la prima pornire, deci lista de proiecte poate spune pentru scurt timp că sunt pe drum.
- 5
La o instalare nouă, administratorul este întrebat o singură dată ce module veți folosi. Bifați ce vă trebuie și continuați. Puteți schimba mai târziu cu butonul Servicii de fundal din bara de sus.
Veți vedeaO listă unică de module, cu memoria de care au nevoie.
Linux: .rpm (Fedora, RHEL, Rocky)
- 1
Descărcați
OpenConstructionERP-18.5.0-1.x86_64.rpm.Veți vedeaUn fișier de aproximativ 850 MB.
- 2
Rulați.
sudo dnf install ./OpenConstructionERP-18.5.0-1.x86_64.rpmVeți vedeadnf rezolvă dependențele și instalează.
- 3
Porniți OpenConstructionERP din meniul de aplicații.
Veți vedeaEcranul de încărcare. Prima pornire durează un minut sau două.
- 4
Autentificați-vă cu contul demo: e-mail demo@openconstructionerp.com, parola DemoPass1234!. Apoi puteți crea propriul cont și propriile proiecte.
Veți vedeaAplicația. Proiectele demo se creează în fundal la prima pornire, deci lista de proiecte poate spune pentru scurt timp că sunt pe drum.
- 5
La o instalare nouă, administratorul este întrebat o singură dată ce module veți folosi. Bifați ce vă trebuie și continuați. Puteți schimba mai târziu cu butonul Servicii de fundal din bara de sus.
Veți vedeaO listă unică de module, cu memoria de care au nevoie.
Linux: AppImage (any distribution)
- 1
Descărcați
OpenConstructionERP_18.5.0_amd64.AppImage.Veți vedeaUn fișier de aproximativ 910 MB.
- 2
Faceți-l executabil.
chmod +x OpenConstructionERP_18.5.0_amd64.AppImageVeți vedeaFără rezultat.
- 3
Rulați-l.
./OpenConstructionERP_18.5.0_amd64.AppImageVeți vedeaEcranul de încărcare. Prima pornire durează un minut sau două.
- 4
Autentificați-vă cu contul demo: e-mail demo@openconstructionerp.com, parola DemoPass1234!. Apoi puteți crea propriul cont și propriile proiecte.
Veți vedeaAplicația. Proiectele demo se creează în fundal la prima pornire, deci lista de proiecte poate spune pentru scurt timp că sunt pe drum.
- 5
La o instalare nouă, administratorul este întrebat o singură dată ce module veți folosi. Bifați ce vă trebuie și continuați. Puteți schimba mai târziu cu butonul Servicii de fundal din bara de sus.
Veți vedeaO listă unică de module, cu memoria de care au nevoie.
Dacă vedeți un mesaj
PornireEcranul de încărcare rămâne un minut sau mai mult la cea mai primă pornire.
Ce înseamnă Aplicația își creează baza de date locală. Se întâmplă o singură dată.
Ce faceți Așteptați și nu închideți fereastra. Pe un disc lent sau aproape plin poate dura mai mult. Pornirile următoare sunt rapide.
Pornire"The backend started, but the local database is not answering, so the app cannot open."Semnificație: partea de server a pornit, dar baza ei de date locală nu răspunde, deci aplicația nu se poate deschide.
Ce înseamnă Baza de date locală nu a pornit, adesea după o rulare care nu s-a închis curat.
Ce faceți Reporniți calculatorul și porniți din nou aplicația. Dacă se repetă, trimiteți-ne desktop-launcher.log și jurnalul bazei de date (vezi Jurnale).
Pornire"The backend started, but this installation is missing the application files it serves"Semnificație: partea de server a pornit, dar instalării îi lipsesc fișierele interfeței cu utilizatorul.
Ce înseamnă Lipsește o parte din folderul programului, de obicei ștearsă de antivirus.
Ce faceți Verificați carantina antivirusului, apoi rulați din nou programul de instalare peste instalarea existentă. Proiectele dvs. nu sunt atinse.
Pornire"The application backend did not start in time" sau "The application backend stopped responding while preparing the local database" (sau la alt pas).
Ce înseamnă Pornirea a durat mai mult decât așteaptă aplicația. Mesajul indică pasul la care era.
Ce faceți Închideți fereastra și porniți din nou. Eliberați mai întâi spațiu pe disc dacă acesta este aproape plin. Dacă se oprește iar la același pas, trimiteți-ne desktop-launcher.log.
Pornire"The application never finished unpacking itself, so its backend never started." sau "The application could not unpack itself into the temporary folder it uses."
Ce înseamnă În macOS și Linux aplicația își despachetează backendul la fiecare pornire. Un disc lent sau plin, ori un antivirus care blochează fișierele, o împiedică. (Aplicația pentru Windows nu se mai despachetează de la 18.5.)
Ce faceți Eliberați spațiu pe unitatea cu folderul temporar sau permiteți aplicația în antivirus, apoi porniți din nou.
Pornire"The drive ran out of space while the application was starting" sau "There is not enough free space to start the application".
Ce înseamnă Exact asta. Mesajul indică folderul și spațiul liber rămas.
Ce faceți Eliberați spațiu pe acea unitate și porniți din nou.
În funcțiune"The application backend stopped, restarting" și fereastra se reîncarcă.
Ce înseamnă Partea din fundal a aplicației s-a oprit pe neașteptate, iar aplicația a repornit-o. Munca salvată se păstrează. Face asta de cel mult două ori în 30 de minute.
Ce faceți Continuați. Dacă se repetă sau vedeți "The application backend has stopped", trimiteți-ne desktop-launcher.log și logs/backend-crash.log.
PornireDe fiecare dată când porniți aplicația sunteți deconectat, iar limba revine la engleză.
Ce înseamnă Alt program folosește portul 8732, pe care îl folosește de obicei aplicația. Versiunea 18.5.0 alege atunci la fiecare pornire un port liber aleator, iar fereastra tratează fiecare port nou ca pe un site nou, deci autentificarea și limba nu sunt găsite.
Ce faceți Închideți sau reconfigurați celălalt program care folosește portul 8732 (în Windows, rulați netstat -ano | findstr :8732 într-un terminal ca să vedeți ID-ul procesului). Proiectele dvs. nu sunt afectate, doar autentificarea și alegerea limbii.
PornireVă temeți că aplicația intră în conflict cu un PostgreSQL pe care îl rulați deja pe portul 5432.
Ce înseamnă Nu intră. Baza de date integrată ia în Windows un port local liber aleator, iar în macOS și Linux ascultă doar pe un socket local, nu pe un port TCP.
Ce faceți Nu e nimic de făcut.
InstalareFișierul .deb cere libwebkit2gtk-4.1-0 sau dpkg raportează dependențe nesatisfăcute.
Ce înseamnă Aplicația are nevoie de WebKitGTK 4.1 ca să-și deseneze fereastra. dpkg -i nu instalează dependențele.
Ce faceți Instalați cu sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb, care aduce și biblioteca. Dacă distribuția dvs. nu are libwebkit2gtk-4.1-0 (Ubuntu mai vechi de 22.04, Debian mai vechi de 12), folosiți pip.
InstalareAppImage nu face nimic la dublu clic.
Ce înseamnă Fișierul nu este încă marcat ca program.
Ce faceți Rulați chmod +x OpenConstructionERP_18.5.0_amd64.AppImage și porniți-l din nou.
InstalareO eroare AppImage care menționează FUSE sau libfuse.so.2.
Ce înseamnă Distribuțiile mai noi nu mai instalează biblioteca FUSE 2 pe care o folosesc AppImage-urile.
Ce faceți Instalați-o (sudo apt install libfuse2, în Ubuntu 24.04 sudo apt install libfuse2t64) sau folosiți .deb, .rpm ori pip.
Unde sunt jurnalele
desktop-launcher.log~/.openestimate/desktop-launcher.logTot ce a făcut aplicația desktop la pornire. Întotdeauna în folderul dvs. home, chiar dacă ați mutat folderul de date.backend-crash.log~/.openestimate/logs/backend-crash.logDetalii despre o oprire neașteptată. Se află în folderul de date, deci se mută odată cuOE_DATA_DIR.database log folder~/.openestimate/pgdata/logDe ce nu a pornit baza de date integrată.
Ca să deschideți folderul dintr-un terminal:
xdg-open ~/.openestimatepip
- 1
Rulați.
pip install --upgrade openconstructionerpVeți vedeapip descarcă pachetul și dependențele lui.
- 2
Rulați.
openconstructionerpVeți vedeaUn scurt mesaj de bun venit. La prima rulare întreabă dacă să încarce proiectele demo și dacă să deschidă browserul.
- 3
Așteptați cât se configurează baza de date locală.
Veți vedea"Database: embedded PostgreSQL 16 (no Docker)" și apoi pornește serverul. Browserul dvs. deschide http://127.0.0.1:8080 (la fel ca http://localhost:8080).
- 4
Autentificați-vă. Cu datele demo puteți folosi demo@openconstructionerp.com / DemoPass1234!
Veți vedeaPanoul de control.
- 5
La o instalare nouă, administratorul este întrebat o singură dată ce module veți folosi. Bifați ce vă trebuie și continuați. Puteți schimba mai târziu cu butonul Servicii de fundal din bara de sus.
Veți vedeaO listă unică de module, cu memoria de care au nevoie.
- 6
Ca să opriți, apăsați Ctrl+C în terminal. Data viitoare rulați din nou openconstructionerp.
Veți vedeaServerul se oprește. Datele dvs. rămân în folderul
.openestimatedin folderul home.
Comenzi utile
Comanda openconstructionerp nu este găsită
python -m openconstructionerpCeva nu funcționează: verifică Python, portul, folderul de date și baza de date și spune ce să faceți
openconstructionerp doctorPortul 8080 este ocupat de alt program
openconstructionerp serve --port 8081Alte calculatoare din rețeaua dvs. trebuie să aibă acces
openconstructionerp serve --host 0.0.0.0 --port 8080Trebuie să ne spuneți versiunea dvs.
openconstructionerp --versionDacă vedeți un mesaj
Instalarepip spune că nu s-a găsit nicio distribuție potrivită sau că este nevoie de alt Python.
Ce înseamnă OpenConstructionERP are nevoie de Python 3.12 sau mai nou.
Ce faceți Instalați Python 3.12 sau mai nou și rulați python3.12 -m pip install --upgrade openconstructionerp (în Windows: py -3.12 -m pip install --upgrade openconstructionerp).
Instalareerror: externally-managed-environment (Ubuntu 23.04+, Debian 12+).Semnificație: sistemul dvs. Linux își protejează propriul Python și refuză să instaleze pachete în el.
Ce înseamnă Python-ul sistemului nu permite pip să instaleze în el.
Ce faceți Folosiți pipx install openconstructionerp sau creați mai întâi un mediu virtual: python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp.
Pornire"openconstructionerp" is not recognized sau command not found.
Ce înseamnă Folderul în care pip pune comenzile nu este în PATH (frecvent în Windows).
Ce faceți Rulați în schimb python -m openconstructionerp. Merge pe orice sistem fără să atingeți PATH.
Pornire"Port 8080 is already in use. Try: openconstructionerp serve --port 8081"Semnificație: un alt program folosește deja portul 8080, așa că porniți aplicația pe alt port, de exemplu 8081.
Ce înseamnă Alt program folosește portul 8080.
Ce faceți Rulați comanda sugerată și deschideți adresa pe care o afișează.
Pornire"Embedded PostgreSQL could not start".Semnificație: baza de date PostgreSQL încorporată nu a putut porni.
Ce înseamnă Baza de date integrată nu a pornit. Mesajul afișează calea jurnalului ei.
Ce faceți Rulați openconstructionerp doctor. Dacă nu ajută, reinstalați cu pip install --upgrade --force-reinstall openconstructionerp și trimiteți-ne jurnalul indicat.
Unde sunt jurnalele
terminal outputthe terminal window (pip);docker compose logs app(Docker)Pentru pip și Docker, copiați ce a afișat terminalul și rezultatul comenziiopenconstructionerp doctor.
Docker
- 1
Într-un folder gol, descărcați cele două fișiere 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.ymlVeți vedeaDouă fișiere în folder.
- 2
Creați o dată fișierul cu secrete.
echo "POSTGRES_PASSWORD=$(openssl rand -base64 24)" > .envecho "JWT_SECRET=$(openssl rand -hex 32)" >> .envVeți vedeaUn fișier
.env. Păstrați-l: conține parola bazei de date și secretul de autentificare. - 3
Porniți-l.
docker compose pull app && docker compose up -dVeți vedeaPornesc două containere: postgres și app.
- 4
Deschideți http://localhost:8080 și autentificați-vă cu demo@openconstructionerp.com / DemoPass1234!
Veți vedeaPagina de autentificare. Prima pornire poate dura un minut cât se pregătește baza de date.
- 5
La o instalare nouă, administratorul este întrebat o singură dată ce module veți folosi. Bifați ce vă trebuie și continuați. Puteți schimba mai târziu cu butonul Servicii de fundal din bara de sus.
Veți vedeaO listă unică de module, cu memoria de care au nevoie.
Comenzi utile
Verificați că ambele containere rulează și sunt sănătoase
docker compose psVedeți de ce nu pornește aplicația
docker compose logs appPortul 8080 de pe calculatorul dvs. este ocupat
OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -dAceastă configurare compose este pentru evaluare și utilizare locală. Pentru un server de producție vedeți docs/INSTALL_LINUX.md și docker-compose.prod.yml în repository.
Dacă vedeți un mesaj
PornireCompose se oprește cu "POSTGRES_PASSWORD must be set" sau "JWT_SECRET must be set".
Ce înseamnă Fișierul .env cu cele două secrete lipsește sau nu este în același folder.
Ce faceți Creați fișierul .env ca la pasul 2, în folderul cu docker-compose.yml.
Pornirehttp://localhost:8080 nu se deschide.
Ce înseamnă Containerul nu rulează încă sau portul 8080 este ocupat.
Ce faceți Rulați docker compose ps și docker compose logs app. Pentru alt port: OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d, apoi deschideți http://localhost:8081.
InstalarePe un Mac cu Apple Silicon sau altă mașină ARM, Docker avertizează că platforma imaginii linux/amd64 nu se potrivește sau aplicația rulează foarte lent.
Ce înseamnă Imaginea publicată este construită doar pentru x86-64.
Ce faceți Construiți din sursă cu make quickstart sau folosiți pip.
Unde sunt jurnalele
terminal outputthe terminal window (pip);docker compose logs app(Docker)Pentru pip și Docker, copiați ce a afișat terminalul și rezultatul comenziiopenconstructionerp doctor.
Datele dvs., actualizările și dezinstalarea
- Windows
C:\Users\<your name>\.openestimatePlusC:\ProgramData\OpenConstructionERP\clusters\<id>\pgdatadacă numele dvs. de utilizator are litere nelatine;pgdata.locationîl indică. - macOS~/
.openestimate(ascuns; apăsați Cmd+Shift+. în Finder) - Linux~/
.openestimate - pip~/
.openestimate, același folder ca la aplicația desktop, dacă nu transmiteți--data-dirsau nu setațiOE_DATA_DIR - Dockervolumele Docker <folder>_pg_data (baza de date) și <folder>_app_data (fișierele), unde <folder> este numele folderului cu
docker-compose.yml
Actualizare
Instalați noua versiune peste cea veche. Folderul dvs. .openestimate nu face parte din program, deci proiectele, utilizatorii și setările rămân. Prima pornire după o actualizare poate dura mai mult cât timp baza de date se actualizează singură.
Dezinstalare
Dezinstalarea elimină programul și păstrează proiectele dvs. În Windows, programul de dezinstalare oferă "Delete the application data" (în limba programului de instalare): aceasta șterge doar autentificarea și limba salvate de fereastra aplicației (în %APPDATA% și %LOCALAPPDATA%\io.openconstructionerp.desktop), nu proiectele dvs. Ca să începeți de la zero, dezinstalați, copiați .openestimate într-un loc sigur și apoi ștergeți-l.
Copie de siguranță
Închideți aplicația și copiați folderul .openestimate (și folderul ProgramData indicat în pgdata.location, dacă există).
Tot nu merge? Vă ajutăm
Vă rugăm să includeți:
- versiunea (este în numele fișierului descărcat; pip:
openconstructionerp --version; Docker: eticheta imaginii) și cum ați instalat (program de instalare Windows, .dmg, .deb, .rpm, AppImage, pip sau Docker) - sistemul dvs. (Windows: Start, tastați
winver; macOS: meniul Apple, About This Mac; Linux: distribuția și versiunea) - textul exact al mesajului sau o captură de ecran
- fișierele jurnal enumerate mai sus
Fișierele jurnal pot conține numele dvs. de utilizator și numele folderelor. Parcurgeți-le înainte de a le posta public; trimiteți-le mai bine prin e-mail, dacă preferați.
Pașii următori după instalare
Textul complet se găsește și pe GitHub în English, Deutsch și Русский.