המאמר יפרט את השלבים הדרושים לפתרון תקלות בהתקנת תוכנה, גם ב-Chocolatey וגם ב-Homebrew.

Chocolatey

כאשר התקנת תוכנה נכשלת במכשירי Windows, תופיע ההודעה הבאה בסרגל ההתראות.

יומני Chocolatey ב-Atera נמצאים בתיקייה הבאה:

עבור x64
"C:\Program Files\ATERA Networks\AteraAgent\Packages\AgentPackageProgramManagement\choco-logs"

עבור x86
"C:\Program Files (x86)\ATERANetworks\AteraAgent\Packages\AgentPackageProgramManagement\choco-logs"

קריאת הלוגים

מלבד קריאת הלוגים של Chocolatey ישירות מהמחשב, ניתן גם לקרוא אותם ישירות מ-Atera באמצעות CMD או Powershell.

1.  בסוכן שבו יש בעיה, עבור אל ניהול ולחץ על שורת פקודה.

2. לאחר ש-CMD נפתח, השתמש בפקודה הבאה כדי להיכנס לתיקייה שבה נמצאים הלוגים.

עבור x64

cd "C:\Program Files\ATERA Networks\AteraAgent\Packages\AgentPackageProgramManagement\choco-logs"

עבור x86

cd "C:\Program Files (x86)\ATERANetworks\AteraAgent\Packages\AgentPackageProgramManagement\choco-logs"

3.  הקלד את הפקודה להצגת קבצים כדי לראות את כל הקבצים בתיקייה.

dir

לאחר שתלחץ על dir, תוכל לראות את כל הלוגים בתיקיית choco-logs.

4. כדי לקרוא את הלוגים, העתק את שם הקובץ והשתמש בפקודת type כדי להציג את הלוגים ב-Atera. יש לוודא ששם הקובץ נמצא במרכאות וכולל את סיומת הקובץ בסוף.

פקודה
type "filename.txt"

דוגמה
type "10-17-2022 10_32_24-log.txt"

הלוגים יוצגו בחלון ה-CMD.

התוכנה כבר מותקנת

שגיאה נפוצה שיכולה להופיע היא "*שם התוכנה* כבר מותקנת." גם אם התוכנה לא מותקנת בפועל על המחשב, קבצים של Chocolatey עלולים למנוע את ההתקנה.

השתמש בפקודות הבאות כדי להסיר קבצים שעשויים למנוע את התקנת התוכנה.

rmdir "C:\ProgramData\chocolatey\lib" /q /s
rmdir "C:\ProgramData\chocolatey\lib-bad" /q /s

לאחר הרצת שתי הפקודות נסה להתקין שוב את התוכנה

ERROR: Checksum

במקרים מסוימים, החבילה שנמצאת במאגר של Chocolatey לא עודכנה כראוי, ועלולה להחזיר את השגיאה הבאה:

ERROR: Checksum for 'xxxxxx' did not meet 'xxxxxx' for checksum type 'sha256'. Consider passing the actual checksums through with --checksum --checksum64 once you validate the checksums are appropriate. A less secure option is to pass --ignore-checksums if necessary.

במקרים כאלה, כאשר התקנת התוכנה מחזירה את השגיאה הזו, אפשר לנסות להשתמש בפרמטר --ignore-checksums, שיתעלם מהבדיקת checksum וינסה להתקין את התוכנה.

הערה: עבור חלק מהחבילות, הפרמטר --ignore-checksums עלול להיכשל, כל עוד אין סעיף "Package parameters" בתיאור התקנת התוכנה.

429 Too Many Requests

שגיאת "429 Too Many Requests" מצביעה על כך שהגעת למגבלת הבקשות. המגבלה תיאכף למשך שעה אחת. אם תחרוג מהמגבלה שוב במהלך אותה תקופה, היא תוארך לעוד שעה. למידע נוסף והסברים, מומלץ לעיין בתיעוד הנוסף.

התקנת תוכנה באמצעות סקריפט

ניתן להעלות את קובץ ההתקנה של התוכנה (.exe או .msi) ל-Atera כסקריפט ולהריץ אותו ישירות מ-Atera. כך אפשר להתקין יישומים שנכשלים בהתקנה דרך Software installation, או שאינם קיימים במאגר של Chocolatey. למידע נוסף, עיין במאמר שלנו יצירה או העלאת סקריפטים.

Homebrew

התקנת תוכנה במכשירי Mac מתבצעת באמצעות Homebrew להתקנת תוכנות.

קריאת לוגים

1. השתמשו בפקודת שינוי תיקיה (Change directory) כדי להיכנס לתיקיה שבה נמצאים הלוגים של Homebrew.

cd "/library/application support/com.atera.ateraagent/packages/AgentPackageProgramManagement/AgentPackageProgramManagementApp.app/Contents/MonoBundle"

2. כדי לקרוא את הלוגים השתמשו בפקודת cat

cat "brew-logs.txt"

הלוגים יציגו את הבעיות שקשורות להתקנה עצמה (בעיות הרשאה, גישה לתיקיות וכדומה).