Орнотуу боюнча жардам
OpenConstructionERP орнотуу
Кантип иштеткиңиз келгенин тандаңыз, номерленген кадамдарды аткарыңыз, а бир нерсе туура эмес көрүнсө, көргөн билдирүүңүздү төмөндөгү маселелер тизмесинен табыңыз. Орнотуу учурундагы эскертүүлөрдүн бири да долбоорлоруңузга коркунуч жаратпайт.
Эмне керек экенин билбей жатасызбы?
- Сиз Windows 10 же 11 колдоносузWindows орноткучу (.exe)
- Сизде M1, M2, M3 же M4 чипи бар Mac барmacOS (.dmg, Apple Silicon)
- Сизде Intel процессору бар Mac барpip же Docker (Intel Mac үчүн колдонмо жок)
- Сиз Ubuntu, Debian же Linux Mint колдоносузLinux .deb
- Сиз Fedora, RHEL же Rocky Linux колдоносузLinux .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жүктөп алыңыз.КөрөсүзDownloads папкасында болжол менен 800 MB файл.
- 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
Демо аккаунт менен кириңиз: email demo@openconstructionerp.com, сырсөз DemoPass1234!. Андан кийин өз аккаунтуңузду жана долбоорлоруңузду түзө аласыз.
КөрөсүзКолдонмо. Демо долбоорлор биринчи ишке киргизүүдө фондо түзүлөт, ошондуктан долбоорлор тизмеси бир аз убакыт алардын жолдо экенин айтышы мүмкүн.
- 8
Жаңы орнотууда администратордон кайсы модулдарды колдонорун бир жолу сурашат. Керектүүлөрүн белгилеп, улантыңыз. Кийин аны жогорку тилкедеги Background services баскычы менен өзгөртө аласыз.
КөрөсүзМодулдардын бир жолку тизмеси жана ар бирине керектүү эс тутум көлөмү.
Эгер билдирүү көрсөңүз
ОрнотууКөк "Windows protected your PC" терезеси.
Мунун мааниси Орноткучка дагы эле код кол тамгасы коюлган эмес, ошондуктан Windows жарыялоочуну тааныбайт. Бул эскертүү, вирус табылганы эмес.
Эмне кылуу керек "More info" баскычын басыңыз, файлдын аты OpenConstructionERPден башталганын текшериңиз, андан соң "Run anyway" баскычын басыңыз.
ОрнотууSmart App Control колдонмону бөгөттөдү, улантуу баскычы жок.
Мунун мааниси Windows 11деги Smart App Control кол тамгасыз программаларды четке кагат.
Эмне кылуу керек Smart App Control бир гана колдонмого уруксат бере албайт. Аны күйгүзүлгөн бойдон калтыруу үчүн OpenConstructionERPти Docker Desktop аркылуу же WSLде (Windowsтун ичиндеги Linux) иштетиңиз, аларды 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тон "Microsoft Edge WebView2 Runtime" орнотуп, андан соң биздин орноткучту дагы бир жолу иштетиңиз.
ОрнотууАнтивирус орнотуу учурунда же биринчи ишке киргизүүдө файлды өчүрөт же карантинге салат.
Мунун мааниси Программа жаңы жана кол тамгасыз, ал эми айрым антивирустар ага шектенип карайт.
Эмне кылуу керек Файлды карантинден калыбына келтирип, төмөндөгү эки папканы өзгөчөлүктөргө кошуңуз: программа папкасы 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гө чейин мындай аккаунттар үчүн колдонмо такыр ишке кире алчу эмес.
Эмне кылуу керек Оңдой турган эч нерсе жок. .openestimate папкаңыздагы pgdata.location файлы маалымат базасынын так папкасын көрсөтөт. Камдык көчүрмө үчүн эки папканы тең көчүрүңүз.
Иштөө учурунда"The application backend stopped, restarting" жана терезе кайра жүктөлөт.
Мунун мааниси Колдонмонун фондогу бөлүгү күтүүсүз токтоду, колдонмо аны кайра иштетти. Сакталган иш калат. Бул 30 мүнөттө көп дегенде эки жолу жасалат.
Эмне кылуу керек Улантыңыз. Кайталанса же "The application backend has stopped" көрсөңүз, бизге desktop-launcher.log жана logs/backend-crash.log жөнөтүңүз.
Ишке киргизүүКолдонмону ар иштеткен сайын аккаунттан чыгып каласыз, ал эми тил англисчеге кайтат.
Мунун мааниси Башка программа колдонмо адатта колдонгон 8732 портун колдонуп жатат. Ошондо 18.5.0 нускасы ар ишке киргизүүдө кокустук бош портту тандайт, ал эми терезе ар бир жаңы портту жаңы сайт деп эсептейт, ошондуктан кирүү жана тил табылбайт.
Эмне кылуу керек 8732 портун колдонгон башка программаны жабыңыз же кайра жөндөңүз (Windowsто анын process ID көрүү үчүн терминалда netstat -ano | findstr :8732 иштетиңиз). Долбоорлоруңузга таасир этпейт, кирүү жана тил тандоого гана.
Ишке киргизүүКолдонмо 5432 портунда мурунтан иштеп турган PostgreSQL менен кагылышат деп санааркап жатасыз.
Мунун мааниси Кагылышпайт. Орнотулган маалымат базасы 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_DIRменен кошо көчөт.database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder frompgdata.location>\log)Орнотулган маалымат базасы эмне үчүн ишке кирген жок.OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log(Explorer дарек сабына%TEMP%териңиз)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
Демо аккаунт менен кириңиз: email 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то анын process ID көрүү үчүн терминалда netstat -ano | findstr :8732 иштетиңиз). Долбоорлоруңузга таасир этпейт, кирүү жана тил тандоого гана.
Ишке киргизүүКолдонмо 5432 портунда мурунтан иштеп турган PostgreSQL менен кагылышат деп санааркап жатасыз.
Мунун мааниси Кагылышпайт. Орнотулган маалымат базасы 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 үчүн чыгарылыш жок.
Эмне кылуу керек Intel Macта pip (Python 3.12 же жаңы) же Docker колдонуңуз.
Логдор кайда
desktop-launcher.log~/.openestimate/desktop-launcher.logИш столу колдонмосу ишке киргенде жасаган бардык иш. Маалымат папкасын жылдырсаңыз да, ар дайым үй папкаңызда.backend-crash.log~/.openestimate/logs/backend-crash.logКүтүүсүз токтоо жөнүндө маалымат. Ал маалымат папкасында турат, ошондуктанOE_DATA_DIRменен кошо көчөт.database 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
Демо аккаунт менен кириңиз: email 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 көз карандылыктарды чечип, орнотот.
- 3
OpenConstructionERPти колдонмолор менюсунан иштетиңиз.
КөрөсүзЖүктөө экраны. Биринчи ишке киргизүү бир-эки мүнөт алат.
- 4
Демо аккаунт менен кириңиз: email 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
Демо аккаунт менен кириңиз: email 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то анын process ID көрүү үчүн терминалда netstat -ano | findstr :8732 иштетиңиз). Долбоорлоруңузга таасир этпейт, кирүү жана тил тандоого гана.
Ишке киргизүүКолдонмо 5432 портунда мурунтан иштеп турган PostgreSQL менен кагылышат деп санааркап жатасыз.
Мунун мааниси Кагылышпайт. Орнотулган маалымат базасы Windowsто кокустук бош жергиликтүү портту алат, ал эми macOS жана Linuxта жергиликтүү socketте гана угат, TCP портунда эмес.
Эмне кылуу керек Эч нерсе кылуунун кереги жок.
Орнотуу.deb libwebkit2gtk-4.1-0 сурайт же dpkg канааттандырылбаган көз карандылыктар жөнүндө кабарлайт.
Мунун мааниси Колдонмого терезесин чийүү үчүн WebKitGTK 4.1 керек. dpkg -i көз карандылыктарды орнотпойт.
Эмне кылуу керек Китепкананы да алып келүүчү sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb менен орнотуңуз. Дистрибутивиңизде libwebkit2gtk-4.1-0 жок болсо (22.04төн эски Ubuntu, 12ден эски Debian), pip колдонуңуз.
ОрнотууAppImage эки жолу чертканда эч нерсе кылбайт.
Мунун мааниси Файл дагы эле программа катары белгиленген эмес.
Эмне кылуу керек chmod +x OpenConstructionERP_18.5.0_amd64.AppImage иштетип, кайра ишке киргизиңиз.
ОрнотууFUSE же libfuse.so.2 аталган AppImage катасы.
Мунун мааниси Жаңы дистрибутивдер AppImage колдонгон FUSE 2 китепканасын мындан ары орнотпойт.
Эмне кылуу керек Аны орнотуңуз (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_DIRменен кошо көчөт.database log folder~/.openestimate/pgdata/logОрнотулган маалымат базасы эмне үчүн ишке кирген жок.
Папканы терминалдан ачуу үчүн:
xdg-open ~/.openestimatepip
- 1
Иштетиңиз.
pip install --upgrade openconstructionerpКөрөсүзpip пакетти жана анын көз карандылыктарын жүктөйт.
- 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 doctor8080 портун башка программа колдонуп жатат
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 колдонуңуз же адегенде виртуалдык чөйрө түзүңүз: 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 конфигурациясы баалоо жана жергиликтүү колдонуу үчүн. Өндүрүштүк сервер үчүн репозиторийдеги 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 ачыңыз.
ОрнотууApple Silicon Macта же башка ARM машинасында Docker image платформасы linux/amd64 дал келбейт деп эскертет, же колдонмо өтө жай иштейт.
Мунун мааниси Жарыяланган image 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(жашыруун; Finderде Cmd+Shift+. басыңыз) - Linux~/
.openestimate - pip~/
.openestimate, иш столу колдонмосу менен бир папка, эгер--data-dirбербесеңиз жеOE_DATA_DIRкойбосоңуз - DockerDocker томдору <folder>_pg_data (маалымат базасы) жана <folder>_app_data (файлдар), мында <folder>
docker-compose.ymlбар папканын аты
Жаңыртуу
Жаңы нускасын эскисинин үстүнөн орнотуңуз. .openestimate папкаңыз программанын бөлүгү эмес, ошондуктан долбоорлор, колдонуучулар жана жөндөөлөр калат. Жаңыртуудан кийинки биринчи ишке киргизүү узагыраак болушу мүмкүн, анткени маалымат базасы өзүн жаңыртат.
Алып салуу
Алып салуу программаны өчүрөт жана долбоорлоруңузду сактайт. Windowsто алып салгыч "Delete the application data" опциясын сунуштайт (орноткуч тилинде): ал колдонмо терезеси сактаган кирүү менен тилди гана өчүрөт (%APPDATA% жана %LOCALAPPDATA%\io.openconstructionerp.desktop ичинде), долбоорлоруңузду эмес. Нөлдөн баштоо үчүн алып салыңыз, .openestimate папкасын коопсуз жерге көчүрүңүз, андан кийин аны өчүрүңүз.
Камдык көчүрмө
Колдонмону жаап, .openestimate папкасын көчүрүңүз (жана pgdata.location ичинде аталган ProgramData папкасын, эгер бар болсо).
Дагы эле тыгырыкка такалдыңызбы? Жардам беребиз
Муну кошуңуз:
- нуска (ал жүктөп алган файлдын атында; pip:
openconstructionerp --version; Docker: image теги) жана кантип орнотконуңуз (Windows орноткучу, .dmg, .deb, .rpm, AppImage, pip же Docker) - тутумуңуз (Windows: Start,
winverтериңиз; macOS: Apple менюсу, About This Mac; Linux: дистрибутив жана нуска) - билдирүүнүн так тексти же скриншот
- жогоруда аталган лог файлдары
Лог файлдарында колдонуучу атыңыз жана папка аттары болушу мүмкүн. Жарыялаардан мурун карап чыгыңыз; кааласаңыз, email аркылуу жөнөтүңүз.