עזרה בהתקנה
התקנת OpenConstructionERP
בחרו איך להריץ אותו, עקבו אחרי השלבים הממוספרים, ואם משהו נראה לא תקין, חפשו את ההודעה שאתם רואים ברשימת הבעיות למטה. אף אחת מהאזהרות בזמן ההתקנה אינה מסכנת את הפרויקטים שלכם.
לא בטוחים מה אתם צריכים?
- אתם משתמשים ב-Windows 10 או 11מתקין Windows (.exe)
- יש לכם Mac עם שבב M1, M2, M3 או M4macOS (.dmg, Apple Silicon)
- יש לכם Mac עם Intelpip או Docker (אין אפליקציה ל-Mac עם Intel)
- אתם משתמשים ב-Ubuntu, Debian או Linux MintLinux .deb
- אתם משתמשים ב-Fedora, RHEL או Rocky LinuxLinux .rpm
- אתם משתמשים בהפצת Linux אחרתLinux AppImage
- כבר יש לכם Python 3.12 ומעלה, או שאתם רוצים אותו על שרתpip
- אתם משתמשים ב-Docker או מגדירים אותו לצוותDocker
צפו קודם
איך מתקינים את OpenConstructionERP
הדרכה בווידאו על Windows, שהוקלטה בגרסה 17.7.1. חלק מהמסכים נראים אחרת ב-18.5, וזמן ההמתנה בזמן ההתקנה קוצר בסרטון.
Windows
- 1
הורידו את
OpenConstructionERP_18.5.0_x64-setup.exeמדף הגרסה.מה תראוקובץ של כ-800 MB בתיקיית ההורדות (Downloads).
- 2
לחצו עליו פעמיים. אם חלון כחול אומר "Windows הגן על המחשב שלך" ("Windows protected your PC"), לחצו "מידע נוסף" ("More info"), ודאו ששם הקובץ מתחיל ב-OpenConstructionERP, ואז לחצו "הפעל בכל זאת" ("Run anyway").
מה תראוWindows מבקש הרשאת מנהל. לחצו "כן".
- 3
בחרו את שפת המתקין, אשרו את הרישיון והשאירו את התיקייה המוצעת
C:\Program Files\OpenConstructionERP.מה תראופס התקדמות ואחריו דף סיום.
- 4
לחצו "סיום" או הפעילו את OpenConstructionERP מתפריט התחל.
מה תראומסך טעינה "מפעיל את האפליקציה" עם רשימה: הפעלת ה-backend, הפעלת מסד הנתונים המקומי, הכנת מסד הנתונים, הפעלת שרת האפליקציה, פתיחת האפליקציה.
- 5
המתינו בהפעלה הראשונה ביותר. אל תסגרו את החלון.
מה תראו"ההפעלה הראשונה מכינה את מסד הנתונים המקומי שלך. זה עשוי לקחת דקה או שתיים, אנא המתן." ההפעלות הבאות מהירות הרבה יותר.
- 6
בחרו איך לפתוח: כחלון אפליקציה (מומלץ) או בדפדפן הרגיל שלכם.
מה תראו"איך תרצו לפתוח את OpenConstructionERP?" ואחר כך דף ההתחברות.
- 7
התחברו עם חשבון ההדגמה: אימייל demo@openconstructionerp.com, סיסמה DemoPass1234!. אחר כך אפשר ליצור חשבון ופרויקטים משלכם.
מה תראוהאפליקציה. פרויקטי ההדגמה נוצרים ברקע בהפעלה הראשונה, ולכן רשימת הפרויקטים עשויה לומר לזמן קצר שהם בדרך.
- 8
בהתקנה חדשה המנהל נשאל פעם אחת אילו מודולים תשתמשו בהם. סמנו מה שצריך והמשיכו. אפשר לשנות זאת אחר כך בכפתור "שירותי רקע" בסרגל העליון.
מה תראורשימת מודולים חד-פעמית עם הזיכרון שהם צריכים.
אם אתם רואים הודעה
התקנהחלון כחול "Windows הגן על המחשב שלך" ("Windows protected your PC").
מה זה אומר המתקין עדיין לא חתום דיגיטלית, ולכן Windows לא מכיר את המפרסם. זו אזהרה, לא זיהוי של וירוס.
מה לעשות לחצו "מידע נוסף" ("More info"), ודאו ששם הקובץ מתחיל ב-OpenConstructionERP, ואז לחצו "הפעל בכל זאת" ("Run anyway").
התקנהSmart App Control חסם את האפליקציה, בלי כפתור להמשך.
מה זה אומר Smart App Control ב-Windows 11 דוחה תוכנות לא חתומות.
מה לעשות Smart App Control לא יכול לאפשר אפליקציה אחת בלבד. כדי להשאיר אותו פעיל, הריצו את OpenConstructionERP עם Docker Desktop או ב-WSL (ה-Linux המובנה של Windows), ש-Smart App Control לא בודק. הוראות שלב אחר שלב: docs/desktop/WINDOWS_BLOCKED.md במאגר.
התקנה"Please choose an installation folder whose path uses only Latin letters, digits and spaces. The built-in database cannot start from a folder with other characters in its path" (ההודעה קיימת באנגלית בלבד)משמעות: נתיב תיקיית ההתקנה יכול להכיל רק אותיות לטיניות, ספרות ורווחים, כי מסד הנתונים המובנה לא יכול לעלות מנתיב אחר.
מה זה אומר בנתיב התיקייה שבחרתם יש אותיות קיריליות, סיניות, אותיות עם סימנים מבחינים או תווים אחרים שאינם לטיניים.
מה לעשות השאירו את C:\Program Files\OpenConstructionERP המוצעת או בחרו תיקייה כמו C:\OpenConstructionERP. התקנה שקטה (/S) מסתיימת בקוד 3 וכותבת את הסיבה אל %TEMP%\OpenConstructionERP-install-error.log.
התקנההמתקין נעצר עם שגיאה על WebView2.
מה זה אומר Windows סירב להתקין את Microsoft WebView2, הרכיב שמצייר את חלון האפליקציה. הוא כלול במתקין ולכן אין צורך באינטרנט; השגיאה מגיעה מ-Windows עצמו (מדיניות, עדכון ממתין או WebView2 ישן ופגום).
מה לעשות הפעילו מחדש את המחשב והריצו את המתקין שוב. אם הוא נכשל שוב, התקינו את "Microsoft Edge WebView2 Runtime" מ-Microsoft ואז הריצו את המתקין שלנו פעם נוספת.
התקנההאנטי-וירוס מוחק קובץ או מעביר אותו להסגר בזמן ההתקנה או בהפעלה הראשונה.
מה זה אומר התוכנה חדשה ולא חתומה, וחלק מתוכנות האנטי-וירוס מסתכלות על זה בחשד.
מה לעשות שחזרו את הקובץ מההסגר והוסיפו את שתי התיקיות האלה לחריגים: תיקיית התוכנה C:\Program Files\OpenConstructionERP ותיקיית הנתונים שלכם C:\Users\<your name>\.openestimate. אחר כך הריצו את המתקין שוב מעל ההתקנה הקיימת. אם אינכם בטוחים שהקובץ אמיתי, כתבו לנו קודם.
שדרוגמסך ששואל אם לדרוס את הגרסה המותקנת או להסיר אותה קודם, עם שורה שמציעה להסיר.
מה לעשות השאירו את האפשרות שכבר נבחרה (דריסה). הפרויקטים שלכם נשמרים. ההפעלה הראשונה אחרי שדרוג עשויה לקחת יותר זמן בזמן שמסד הנתונים מתעדכן בעצמו.
שדרוגאתם מריצים את OpenConstructionERP גם דרך pip או מטרמינל באותו מחשב, והוא נעצר בזמן השדרוג.
מה זה אומר שניהם משתמשים באותה תיקיית .openestimate ובאותו מסד נתונים. המתקין עוצר את המסד הזה כדי להחליף את התוכנה. בשדרוג מ-18.4.0 תוכנית ההסרה הישנה סוגרת גם כל תוכנה בשם openconstructionerp.exe.
מה לעשות עצרו את גרסת הטרמינל (Ctrl+C) לפני ההתקנה או השדרוג והפעילו אותה שוב אחר כך.
הפעלהמסך הטעינה נשאר דקה או יותר בהפעלה הראשונה ביותר.
מה זה אומר האפליקציה יוצרת את מסד הנתונים המקומי שלה. זה קורה פעם אחת בלבד.
מה לעשות המתינו ואל תסגרו את החלון. בדיסק איטי או כמעט מלא זה עשוי לקחת יותר זמן. ההפעלות הבאות מהירות.
הפעלהתיבה "OpenConstructionERP failed to start" שמציינת קובץ יומן.
מה זה אומר האפליקציה לא הצליחה לפתוח את החלון שלה בכלל.
מה לעשות הפעילו אותה פעם נוספת. אם התיבה חוזרת, שלחו לנו את קובץ היומן שהיא מציינת.
הפעלה"The backend started, but the local database is not answering, so the app cannot open."משמעות: חלק השרת עלה, אך מסד הנתונים המקומי שלו אינו מגיב, ולכן לא ניתן לפתוח את האפליקציה.
מה זה אומר מסד הנתונים המקומי לא עלה, לרוב אחרי הפעלה שלא נסגרה כראוי.
מה לעשות הפעילו מחדש את המחשב והפעילו את האפליקציה שוב. אם זה חוזר, שלחו לנו את desktop-launcher.log ואת יומן מסד הנתונים (ראו יומנים).
הפעלה"The backend started, but this installation is missing the application files it serves"משמעות: חלק השרת עלה, אך בהתקנה חסרים קובצי ממשק המשתמש.
מה זה אומר חסר חלק מתיקיית התוכנה, בדרך כלל כי האנטי-וירוס הסיר אותו.
מה לעשות בדקו את ההסגר של האנטי-וירוס ואז הריצו את המתקין שוב מעל ההתקנה הקיימת. הפרויקטים שלכם לא נפגעים.
הפעלה"The application backend did not start in time" או "The application backend stopped responding while preparing the local database" (או בשלב אחר).
מה זה אומר ההפעלה לקחה יותר ממה שהאפליקציה מוכנה לחכות. ההודעה מציינת באיזה שלב היא הייתה.
מה לעשות סגרו את החלון והפעילו שוב. פנו קודם מקום בדיסק אם הוא כמעט מלא. אם היא נעצרת שוב באותו שלב, שלחו לנו את desktop-launcher.log.
הפעלה"The drive ran out of space while the application was starting" או "There is not enough free space to start the application".
מה זה אומר בדיוק זה. ההודעה מציינת את התיקייה ואת המקום הפנוי שנשאר.
מה לעשות פנו מקום בכונן הזה והפעילו שוב.
הפעלההודעה שתיקיית מסד הנתונים המקומי "sits too deep in the filesystem", עם שני מספרים.
מה זה אומר Windows מגביל את אורך הנתיב, והנתיב של תיקיית הנתונים שלכם ארוך מדי עבור קבצי מסד הנתונים. הפעלת נתיבים ארוכים ב-Windows לא עוזרת.
מה לעשות הגדירו את משתנה הסביבה של המשתמש OE_DATA_DIR לנתיב קצר כמו C:\OpenConstructionERP\data (התחל, הקלידו "משתני סביבה", עריכת משתני הסביבה של החשבון שלכם, חדש), ואז הפעילו שוב.
הפעלהשם המשתמש שלכם ב-Windows כולל תווים שאינם לטיניים (למשל קיריליים או סיניים) ואתם מחפשים את מסד הנתונים שלכם.
מה זה אומר מסד הנתונים המובנה לא יכול לעבוד מנתיב כזה, ולכן מאז 18.5.0 האפליקציה שומרת אותו ב-C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata. לפני 18.5.0 האפליקציה לא יכלה לעלות בכלל בחשבונות כאלה.
מה לעשות אין מה לתקן. הקובץ pgdata.location בתיקיית .openestimate שלכם מציין את התיקייה המדויקת של מסד הנתונים. לגיבויים העתיקו את שתי התיקיות.
בזמן עבודה"The application backend stopped, restarting" והחלון נטען מחדש.
מה זה אומר החלק של האפליקציה שרץ ברקע נעצר באופן בלתי צפוי והאפליקציה הפעילה אותו מחדש. עבודה ששמרתם נשמרת. היא עושה זאת עד פעמיים ב-30 דקות.
מה לעשות המשיכו. אם זה חוזר או שאתם רואים "The application backend has stopped", שלחו לנו את desktop-launcher.log ואת logs/backend-crash.log.
הפעלהבכל הפעלה של האפליקציה אתם מנותקים והשפה חוזרת לאנגלית.
מה זה אומר תוכנה אחרת משתמשת בפורט 8732, שבו האפליקציה משתמשת בדרך כלל. אז גרסה 18.5.0 בוחרת בכל הפעלה פורט פנוי אקראי, והחלון מתייחס לכל פורט חדש כאל אתר חדש, ולכן ההתחברות והשפה לא נמצאות.
מה לעשות סגרו או הגדירו מחדש את התוכנה האחרת שמשתמשת בפורט 8732 (ב-Windows הריצו netstat -ano | findstr :8732 בטרמינל כדי לראות את מזהה התהליך שלה). הפרויקטים שלכם לא נפגעים, רק ההתחברות ובחירת השפה.
הפעלהאתם חוששים שהאפליקציה מתנגשת עם PostgreSQL שכבר רץ אצלכם על פורט 5432.
מה זה אומר היא לא מתנגשת. מסד הנתונים המובנה ב-Windows לוקח פורט מקומי פנוי אקראי, וב-macOS וב-Linux הוא מאזין רק על socket מקומי, לא על פורט TCP.
מה לעשות אין צורך לעשות דבר.
איפה היומנים
desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.logכל מה שאפליקציית שולחן העבודה עשתה בהפעלה. תמיד בתיקיית הבית שלכם, גם אם העברתם את תיקיית הנתונים.backend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.logפרטים על עצירה בלתי צפויה. נמצא בתיקיית הנתונים ולכן עובר יחד עםOE_DATA_DIR.database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder frompgdata.location>\log)למה מסד הנתונים המובנה לא עלה.OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log(הקלידו%TEMP%בשורת הכתובת של סייר הקבצים)למה מתקין Windows דחה את תיקיית ההתקנה.
כדי לפתוח את התיקייה, הדביקו את זה בשורת הכתובת של סייר הקבצים:
%USERPROFILE%\.openestimatemacOS
- 1
הורידו את
OpenConstructionERP_18.5.0_aarch64.dmgופתחו אותו.מה תראוחלון עם סמל האפליקציה OpenConstructionERP.
- 2
גררו את OpenConstructionERP אל Applications.
מה תראוהאפליקציה מופיעה בתיקיית Applications.
- 3
פתחו את Terminal פעם אחת והריצו.
xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.appמה תראואין פלט. זה תקין. הפקודה מסירה את סימון ההורדה, כי Apple עדיין לא אישרה (notarize) את האפליקציה.
- 4
פתחו את OpenConstructionERP מתוך Applications.
מה תראומסך הטעינה "מפעיל את האפליקציה". ההפעלה הראשונה מכינה את מסד הנתונים המקומי ולוקחת דקה או שתיים.
- 5
בחרו חלון אפליקציה או דפדפן.
מה תראודף ההתחברות.
- 6
התחברו עם חשבון ההדגמה: אימייל demo@openconstructionerp.com, סיסמה DemoPass1234!. אחר כך אפשר ליצור חשבון ופרויקטים משלכם.
מה תראוהאפליקציה. פרויקטי ההדגמה נוצרים ברקע בהפעלה הראשונה, ולכן רשימת הפרויקטים עשויה לומר לזמן קצר שהם בדרך.
- 7
בהתקנה חדשה המנהל נשאל פעם אחת אילו מודולים תשתמשו בהם. סמנו מה שצריך והמשיכו. אפשר לשנות זאת אחר כך בכפתור "שירותי רקע" בסרגל העליון.
מה תראורשימת מודולים חד-פעמית עם הזיכרון שהם צריכים.
אם אתם רואים הודעה
הפעלהמסך הטעינה נשאר דקה או יותר בהפעלה הראשונה ביותר.
מה זה אומר האפליקציה יוצרת את מסד הנתונים המקומי שלה. זה קורה פעם אחת בלבד.
מה לעשות המתינו ואל תסגרו את החלון. בדיסק איטי או כמעט מלא זה עשוי לקחת יותר זמן. ההפעלות הבאות מהירות.
הפעלה"The backend started, but the local database is not answering, so the app cannot open."משמעות: חלק השרת עלה, אך מסד הנתונים המקומי שלו אינו מגיב, ולכן לא ניתן לפתוח את האפליקציה.
מה זה אומר מסד הנתונים המקומי לא עלה, לרוב אחרי הפעלה שלא נסגרה כראוי.
מה לעשות הפעילו מחדש את המחשב והפעילו את האפליקציה שוב. אם זה חוזר, שלחו לנו את desktop-launcher.log ואת יומן מסד הנתונים (ראו יומנים).
הפעלה"The backend started, but this installation is missing the application files it serves"משמעות: חלק השרת עלה, אך בהתקנה חסרים קובצי ממשק המשתמש.
מה זה אומר חסר חלק מתיקיית התוכנה, בדרך כלל כי האנטי-וירוס הסיר אותו.
מה לעשות בדקו את ההסגר של האנטי-וירוס ואז הריצו את המתקין שוב מעל ההתקנה הקיימת. הפרויקטים שלכם לא נפגעים.
הפעלה"The application backend did not start in time" או "The application backend stopped responding while preparing the local database" (או בשלב אחר).
מה זה אומר ההפעלה לקחה יותר ממה שהאפליקציה מוכנה לחכות. ההודעה מציינת באיזה שלב היא הייתה.
מה לעשות סגרו את החלון והפעילו שוב. פנו קודם מקום בדיסק אם הוא כמעט מלא. אם היא נעצרת שוב באותו שלב, שלחו לנו את desktop-launcher.log.
הפעלה"The application never finished unpacking itself, so its backend never started." או "The application could not unpack itself into the temporary folder it uses."
מה זה אומר ב-macOS וב-Linux האפליקציה פורסת את ה-backend שלה בכל הפעלה. דיסק איטי או מלא, או אנטי-וירוס שנועל קבצים, מונע זאת. (אפליקציית Windows כבר לא נפרסת מאז 18.5.)
מה לעשות פנו מקום בכונן שבו נמצאת התיקייה הזמנית שלכם או התירו את האפליקציה באנטי-וירוס, ואז הפעילו שוב.
הפעלה"The drive ran out of space while the application was starting" או "There is not enough free space to start the application".
מה זה אומר בדיוק זה. ההודעה מציינת את התיקייה ואת המקום הפנוי שנשאר.
מה לעשות פנו מקום בכונן הזה והפעילו שוב.
בזמן עבודה"The application backend stopped, restarting" והחלון נטען מחדש.
מה זה אומר החלק של האפליקציה שרץ ברקע נעצר באופן בלתי צפוי והאפליקציה הפעילה אותו מחדש. עבודה ששמרתם נשמרת. היא עושה זאת עד פעמיים ב-30 דקות.
מה לעשות המשיכו. אם זה חוזר או שאתם רואים "The application backend has stopped", שלחו לנו את desktop-launcher.log ואת logs/backend-crash.log.
הפעלהבכל הפעלה של האפליקציה אתם מנותקים והשפה חוזרת לאנגלית.
מה זה אומר תוכנה אחרת משתמשת בפורט 8732, שבו האפליקציה משתמשת בדרך כלל. אז גרסה 18.5.0 בוחרת בכל הפעלה פורט פנוי אקראי, והחלון מתייחס לכל פורט חדש כאל אתר חדש, ולכן ההתחברות והשפה לא נמצאות.
מה לעשות סגרו או הגדירו מחדש את התוכנה האחרת שמשתמשת בפורט 8732 (ב-Windows הריצו netstat -ano | findstr :8732 בטרמינל כדי לראות את מזהה התהליך שלה). הפרויקטים שלכם לא נפגעים, רק ההתחברות ובחירת השפה.
הפעלהאתם חוששים שהאפליקציה מתנגשת עם PostgreSQL שכבר רץ אצלכם על פורט 5432.
מה זה אומר היא לא מתנגשת. מסד הנתונים המובנה ב-Windows לוקח פורט מקומי פנוי אקראי, וב-macOS וב-Linux הוא מאזין רק על socket מקומי, לא על פורט TCP.
מה לעשות אין צורך לעשות דבר.
התקנה"OpenConstructionERP is damaged and can't be opened" (הטקסט עשוי להופיע בשפת המערכת שלכם).
מה זה אומר Apple עדיין לא אישרה (notarize) את האפליקציה והיא עדיין נושאת את סימון ההורדה. האפליקציה אינה פגומה.
מה לעשות רק זה עוזר: ב-Terminal הריצו פעם אחת xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app ואז פתחו את האפליקציה כרגיל.
התקנה"OpenConstructionERP cannot be opened because the developer cannot be verified" (או ש-Apple לא הצליחה לוודא שאין בה תוכנה זדונית; הטקסט עשוי להופיע בשפת המערכת שלכם).
מה זה אומר האפליקציה חתומה ad hoc אבל Apple עדיין לא אישרה אותה (notarize).
מה לעשות הריצו את אותה פקודת xattr או פתחו System Settings, Privacy & Security, גללו למטה ולחצו Open Anyway. עושים זאת פעם אחת בלבד.
התקנההאפליקציה בכלל לא רצה ב-Mac שלכם.
מה זה אומר גרסת ה-Mac היא ל-Apple Silicon בלבד (M1 ומעלה). אין גרסה ל-Intel.
מה לעשות ב-Mac עם Intel השתמשו ב-pip (Python 3.12 ומעלה) או ב-Docker.
איפה היומנים
desktop-launcher.log~/.openestimate/desktop-launcher.logכל מה שאפליקציית שולחן העבודה עשתה בהפעלה. תמיד בתיקיית הבית שלכם, גם אם העברתם את תיקיית הנתונים.backend-crash.log~/.openestimate/logs/backend-crash.logפרטים על עצירה בלתי צפויה. נמצא בתיקיית הנתונים ולכן עובר יחד עםOE_DATA_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
התחברו עם חשבון ההדגמה: אימייל demo@openconstructionerp.com, סיסמה DemoPass1234!. אחר כך אפשר ליצור חשבון ופרויקטים משלכם.
מה תראוהאפליקציה. פרויקטי ההדגמה נוצרים ברקע בהפעלה הראשונה, ולכן רשימת הפרויקטים עשויה לומר לזמן קצר שהם בדרך.
- 5
בהתקנה חדשה המנהל נשאל פעם אחת אילו מודולים תשתמשו בהם. סמנו מה שצריך והמשיכו. אפשר לשנות זאת אחר כך בכפתור "שירותי רקע" בסרגל העליון.
מה תראורשימת מודולים חד-פעמית עם הזיכרון שהם צריכים.
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
התחברו עם חשבון ההדגמה: אימייל demo@openconstructionerp.com, סיסמה DemoPass1234!. אחר כך אפשר ליצור חשבון ופרויקטים משלכם.
מה תראוהאפליקציה. פרויקטי ההדגמה נוצרים ברקע בהפעלה הראשונה, ולכן רשימת הפרויקטים עשויה לומר לזמן קצר שהם בדרך.
- 5
בהתקנה חדשה המנהל נשאל פעם אחת אילו מודולים תשתמשו בהם. סמנו מה שצריך והמשיכו. אפשר לשנות זאת אחר כך בכפתור "שירותי רקע" בסרגל העליון.
מה תראורשימת מודולים חד-פעמית עם הזיכרון שהם צריכים.
Linux: AppImage (any distribution)
- 1
הורידו את
OpenConstructionERP_18.5.0_amd64.AppImage.מה תראוקובץ של כ-910 MB.
- 2
הפכו אותו להרצה.
chmod +x OpenConstructionERP_18.5.0_amd64.AppImageמה תראואין פלט.
- 3
הריצו אותו.
./OpenConstructionERP_18.5.0_amd64.AppImageמה תראומסך הטעינה. ההפעלה הראשונה לוקחת דקה או שתיים.
- 4
התחברו עם חשבון ההדגמה: אימייל demo@openconstructionerp.com, סיסמה DemoPass1234!. אחר כך אפשר ליצור חשבון ופרויקטים משלכם.
מה תראוהאפליקציה. פרויקטי ההדגמה נוצרים ברקע בהפעלה הראשונה, ולכן רשימת הפרויקטים עשויה לומר לזמן קצר שהם בדרך.
- 5
בהתקנה חדשה המנהל נשאל פעם אחת אילו מודולים תשתמשו בהם. סמנו מה שצריך והמשיכו. אפשר לשנות זאת אחר כך בכפתור "שירותי רקע" בסרגל העליון.
מה תראורשימת מודולים חד-פעמית עם הזיכרון שהם צריכים.
אם אתם רואים הודעה
הפעלהמסך הטעינה נשאר דקה או יותר בהפעלה הראשונה ביותר.
מה זה אומר האפליקציה יוצרת את מסד הנתונים המקומי שלה. זה קורה פעם אחת בלבד.
מה לעשות המתינו ואל תסגרו את החלון. בדיסק איטי או כמעט מלא זה עשוי לקחת יותר זמן. ההפעלות הבאות מהירות.
הפעלה"The backend started, but the local database is not answering, so the app cannot open."משמעות: חלק השרת עלה, אך מסד הנתונים המקומי שלו אינו מגיב, ולכן לא ניתן לפתוח את האפליקציה.
מה זה אומר מסד הנתונים המקומי לא עלה, לרוב אחרי הפעלה שלא נסגרה כראוי.
מה לעשות הפעילו מחדש את המחשב והפעילו את האפליקציה שוב. אם זה חוזר, שלחו לנו את desktop-launcher.log ואת יומן מסד הנתונים (ראו יומנים).
הפעלה"The backend started, but this installation is missing the application files it serves"משמעות: חלק השרת עלה, אך בהתקנה חסרים קובצי ממשק המשתמש.
מה זה אומר חסר חלק מתיקיית התוכנה, בדרך כלל כי האנטי-וירוס הסיר אותו.
מה לעשות בדקו את ההסגר של האנטי-וירוס ואז הריצו את המתקין שוב מעל ההתקנה הקיימת. הפרויקטים שלכם לא נפגעים.
הפעלה"The application backend did not start in time" או "The application backend stopped responding while preparing the local database" (או בשלב אחר).
מה זה אומר ההפעלה לקחה יותר ממה שהאפליקציה מוכנה לחכות. ההודעה מציינת באיזה שלב היא הייתה.
מה לעשות סגרו את החלון והפעילו שוב. פנו קודם מקום בדיסק אם הוא כמעט מלא. אם היא נעצרת שוב באותו שלב, שלחו לנו את desktop-launcher.log.
הפעלה"The application never finished unpacking itself, so its backend never started." או "The application could not unpack itself into the temporary folder it uses."
מה זה אומר ב-macOS וב-Linux האפליקציה פורסת את ה-backend שלה בכל הפעלה. דיסק איטי או מלא, או אנטי-וירוס שנועל קבצים, מונע זאת. (אפליקציית Windows כבר לא נפרסת מאז 18.5.)
מה לעשות פנו מקום בכונן שבו נמצאת התיקייה הזמנית שלכם או התירו את האפליקציה באנטי-וירוס, ואז הפעילו שוב.
הפעלה"The drive ran out of space while the application was starting" או "There is not enough free space to start the application".
מה זה אומר בדיוק זה. ההודעה מציינת את התיקייה ואת המקום הפנוי שנשאר.
מה לעשות פנו מקום בכונן הזה והפעילו שוב.
בזמן עבודה"The application backend stopped, restarting" והחלון נטען מחדש.
מה זה אומר החלק של האפליקציה שרץ ברקע נעצר באופן בלתי צפוי והאפליקציה הפעילה אותו מחדש. עבודה ששמרתם נשמרת. היא עושה זאת עד פעמיים ב-30 דקות.
מה לעשות המשיכו. אם זה חוזר או שאתם רואים "The application backend has stopped", שלחו לנו את desktop-launcher.log ואת logs/backend-crash.log.
הפעלהבכל הפעלה של האפליקציה אתם מנותקים והשפה חוזרת לאנגלית.
מה זה אומר תוכנה אחרת משתמשת בפורט 8732, שבו האפליקציה משתמשת בדרך כלל. אז גרסה 18.5.0 בוחרת בכל הפעלה פורט פנוי אקראי, והחלון מתייחס לכל פורט חדש כאל אתר חדש, ולכן ההתחברות והשפה לא נמצאות.
מה לעשות סגרו או הגדירו מחדש את התוכנה האחרת שמשתמשת בפורט 8732 (ב-Windows הריצו netstat -ano | findstr :8732 בטרמינל כדי לראות את מזהה התהליך שלה). הפרויקטים שלכם לא נפגעים, רק ההתחברות ובחירת השפה.
הפעלהאתם חוששים שהאפליקציה מתנגשת עם PostgreSQL שכבר רץ אצלכם על פורט 5432.
מה זה אומר היא לא מתנגשת. מסד הנתונים המובנה ב-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 (Ubuntu ישן מ-22.04, Debian ישן מ-12), השתמשו ב-pip.
התקנהAppImage לא עושה כלום בלחיצה כפולה.
מה זה אומר הקובץ עדיין לא סומן כתוכנה.
מה לעשות הריצו chmod +x OpenConstructionERP_18.5.0_amd64.AppImage והפעילו אותו שוב.
התקנהשגיאת AppImage שמזכירה FUSE או libfuse.so.2.
מה זה אומר הפצות חדשות יותר כבר לא מתקינות את ספריית FUSE 2 שקובצי AppImage משתמשים בה.
מה לעשות התקינו אותה (sudo apt install libfuse2, וב-Ubuntu 24.04 sudo apt install libfuse2t64) או השתמשו ב-.deb, ב-.rpm או ב-pip.
איפה היומנים
desktop-launcher.log~/.openestimate/desktop-launcher.logכל מה שאפליקציית שולחן העבודה עשתה בהפעלה. תמיד בתיקיית הבית שלכם, גם אם העברתם את תיקיית הנתונים.backend-crash.log~/.openestimate/logs/backend-crash.logפרטים על עצירה בלתי צפויה. נמצא בתיקיית הנתונים ולכן עובר יחד עםOE_DATA_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
בהתקנה חדשה המנהל נשאל פעם אחת אילו מודולים תשתמשו בהם. סמנו מה שצריך והמשיכו. אפשר לשנות זאת אחר כך בכפתור "שירותי רקע" בסרגל העליון.
מה תראורשימת מודולים חד-פעמית עם הזיכרון שהם צריכים.
- 6
כדי לעצור, לחצו Ctrl+C בטרמינל. בפעם הבאה פשוט הריצו שוב openconstructionerp.
מה תראוהשרת נעצר. הנתונים שלכם נשארים בתיקיית
.openestimateבתיקיית הבית.
פקודות שימושיות
הפקודה openconstructionerp לא נמצאה
python -m openconstructionerpמשהו לא עובד: בודק את Python, הפורט, תיקיית הנתונים ומסד הנתונים ואומר מה לעשות
openconstructionerp doctorפורט 8080 תפוס על ידי תוכנה אחרת
openconstructionerp serve --port 8081מחשבים אחרים ברשת שלכם צריכים גישה
openconstructionerp serve --host 0.0.0.0 --port 8080צריך לומר לנו מהי הגרסה שלכם
openconstructionerp --versionאם אתם רואים הודעה
התקנהpip אומר שלא נמצאה הפצה מתאימה או שנדרש Python אחר.
מה זה אומר OpenConstructionERP דורש Python 3.12 ומעלה.
מה לעשות התקינו Python 3.12 ומעלה והריצו python3.12 -m pip install --upgrade openconstructionerp (ב-Windows: py -3.12 -m pip install --upgrade openconstructionerp).
התקנהerror: externally-managed-environment (Ubuntu 23.04+, Debian 12+).משמעות: מערכת ה-Linux שלך מגנה על ה-Python שלה ומסרבת להתקין בו חבילות.
מה זה אומר ה-Python של המערכת לא מרשה ל-pip להתקין לתוכו.
מה לעשות השתמשו ב-pipx install openconstructionerp או צרו קודם סביבה וירטואלית: 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
בהתקנה חדשה המנהל נשאל פעם אחת אילו מודולים תשתמשו בהם. סמנו מה שצריך והמשיכו. אפשר לשנות זאת אחר כך בכפתור "שירותי רקע" בסרגל העליון.
מה תראורשימת מודולים חד-פעמית עם הזיכרון שהם צריכים.
פקודות שימושיות
ודאו ששני הקונטיינרים רצים ותקינים
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.
התקנהב-Mac עם Apple Silicon או במכונת ARM אחרת, Docker מזהיר שפלטפורמת האימג' linux/amd64 אינה תואמת, או שהאפליקציה רצה לאט מאוד.
מה זה אומר האימג' שפורסם נבנה רק ל-x86-64.
מה לעשות בנו מקוד המקור עם make quickstart או השתמשו ב-pip.
איפה היומנים
terminal outputthe terminal window (pip);docker compose logs app(Docker)ב-pip וב-Docker, העתיקו את מה שהטרמינל הדפיס ואת הפלט שלopenconstructionerp doctor.
הנתונים שלכם, שדרוגים והסרה
- Windows
C:\Users\<your name>\.openestimateבנוסףC:\ProgramData\OpenConstructionERP\clusters\<id>\pgdataאם שם המשתמש שלכם כולל תווים שאינם לטיניים;pgdata.locationמציין אותה. - macOS~/
.openestimate(מוסתרת; לחצו Cmd+Shift+. ב-Finder) - Linux~/
.openestimate - pip~/
.openestimate, אותה תיקייה כמו באפליקציית שולחן העבודה, אלא אם תעבירו--data-dirאו תגדירוOE_DATA_DIR - Dockerכרכי Docker בשם <folder>_pg_data (מסד נתונים) ו-<folder>_app_data (קבצים), כאשר <folder> הוא שם התיקייה שבה נמצא
docker-compose.yml
שדרוג
התקינו את הגרסה החדשה מעל הישנה. תיקיית .openestimate שלכם אינה חלק מהתוכנה, ולכן פרויקטים, משתמשים והגדרות נשארים. ההפעלה הראשונה אחרי שדרוג עשויה לקחת יותר זמן בזמן שמסד הנתונים מתעדכן בעצמו.
הסרה
ההסרה מסירה את התוכנה ומשאירה את הפרויקטים שלכם. ב-Windows תוכנית ההסרה מציעה את האפשרות "Delete the application data" (בשפת המתקין): היא מוחקת רק את ההתחברות והשפה ששמר חלון האפליקציה (ב-%APPDATA% וב-%LOCALAPPDATA%\io.openconstructionerp.desktop), לא את הפרויקטים שלכם. כדי להתחיל מאפס, הסירו את התוכנה, העתיקו את .openestimate למקום בטוח ואז מחקו אותה.
גיבוי
סגרו את האפליקציה והעתיקו את תיקיית .openestimate (ואת תיקיית ProgramData שמצוינת ב-pgdata.location, אם יש).
עדיין תקועים? נעזור
אנא צרפו:
- את הגרסה (היא בשם הקובץ שהורדתם; pip:
openconstructionerp --version; Docker: תגית האימג') ואיך התקנתם (מתקין Windows, .dmg, .deb, .rpm, AppImage, pip או Docker) - את המערכת שלכם (Windows: התחל, הקלידו
winver; macOS: תפריט Apple, About This Mac; Linux: ההפצה והגרסה) - את הטקסט המדויק של ההודעה או צילום מסך
- את קובצי היומן שמופיעים למעלה
קובצי יומן עשויים להכיל את שם המשתמש שלכם ושמות תיקיות. עברו עליהם לפני הפרסום; עדיף לשלוח אותם באימייל, אם אתם מעדיפים.
השלבים הבאים אחרי ההתקנה
הטקסט המלא זמין גם ב-GitHub ב-English, ב-Deutsch וב-Русский.