לאחר ההתקנה

אחרי התקנה מוצלחת של Edge, יש כמה משימות נפוצות שכדאי לבצע כדי לאמת את ההתקנה, לשנות את ההגדרות ולהתאים אישית את ההגדרה. המשימות האלה כוללות:

משימה תיאור
הפעלת פקודות ברכיבי Edge משתמשים בכלי apigee-service כדי להפעיל, לעצור, להפעיל מחדש ולקבל את הסטטוס של כל רכיב Edge.
הגדרת רכיבי Edge משתמשים בקובצי מאפיינים כדי לשנות את הגדרות ברירת המחדל של רכיבי Edge.
הרצת apigee-validate מפעילים את סקריפטי הבדיקה כדי לוודא שההתקנה של כל רכיב בוצעה בהצלחה.
כוונון הגדרות הערימה (heap) של JVM מבצעים אופטימיזציה של הגדרות הזיכרון של Java לכל צומת.
ניהול מדיניות הסיסמאות של LDAP משנים את סיסמת ברירת המחדל של LDAP וקובעים הגדרות אימות שונות.
התקנת apigee-monit בצומת מתקינים כלי שעוקב אחרי הרכיבים בצומת ומנסה להפעיל אותם מחדש אם הם נכשלים, ומשתמשים בו.
שינוי סיסמת ברירת המחדל של PostgreSQL כדי לשמור על אבטחת הנתונים, מומלץ לשנות את סיסמת ברירת המחדל של PostgreSQL אחרי שמתקינים את Edge for Private Cloud.
הגדרת משימות מחיקה ב-PostgreSQL צריך למחוק נתונים עודפים שנאספו על ידי שירות הניתוח.
הגדרת תיקון nodetool של Cassandra תחזוקה תקופתית שצריך לבצע ב-Cassandra ring כדי לוודא שהנתונים עקביים בכל הצמתים.
הפעלת ההתחלה האוטומטית הוראה ל-Edge for Private Cloud להפעיל מחדש באופן אוטומטי במהלך הפעלה מחדש.
הגדרת ממשק המשתמש החדש של Edge הגדרת אימות והגדרות אופציונליות לממשק המשתמש החדש של Edge, ממשק המשתמש לניהול למפתחים ולאדמינים של Apigee Edge for Private Cloud.

חשוב לזכור שאלה רק חלק מהמשימות הנפוצות יותר שבדרך כלל מבצעים אחרי שמתקינים את Edge. לפעולות נוספות ולמשימות ניהול, קראו את המאמרים איך מגדירים את Edge ופעולות.

הפעלת פקודות ברכיבי Edge

כלי ניהול ההתקנה של Edge מותקנים בתיקייה /opt/apigee/apigee-service/bin, ואפשר להשתמש בהם כדי לנהל את ההתקנה של Edge. לדוגמה, אפשר להשתמש בכלי apigee-all כדי להפעיל, לעצור, להפעיל מחדש או לקבוע את הסטטוס של כל רכיבי Edge בצומת:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

משתמשים בכלי apigee-service כדי לשלוט ברכיבים בודדים ולהגדיר אותם. הכלי apigee-service הוא בפורמט הבא:

/opt/apigee/apigee-service/bin/apigee-service component_name action

כאשר component_name הוא המזהה של הרכיב. הרכיב צריך להיות בצומת שבו מריצים את הפקודה apigee-service. בהתאם להגדרה, הערכים של component_name יכולים לכלול:

  • apigee-cassandra (Cassandra)
  • ‫apigee-openldap (OpenLDAP)
  • ‫apigee-postgresql (מסד נתונים של PostgreSQL)
  • apigee-qpidd (Qpidd)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (שרת ניהול)
  • ‫edge-management-ui (ממשק משתמש חדש של Edge)
  • ‫edge-message-processor (מעבד בקשות)
  • edge-postgres-server (שרת Postgres)
  • ‫edge-qpid-server (Qpid Server)
  • edge-router (Edge Router)

בנוסף לרכיבים האלה, אפשר גם להפעיל את apigee-service ברכיבים apigee-provision ו-apigee-validate, בהתאם להגדרות האישיות.

לדוגמה, כדי להפעיל מחדש את Edge Router, מריצים את הפקודה הבאה:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

כדי לראות את רשימת הרכיבים שמותקנים בצומת, בודקים את הספרייה /opt/apigee. הספרייה הזו מכילה ספריית משנה לכל רכיב של Edge שמותקן בצומת. לכל ספריית משנה יש קידומת:

  • ‫apigee: רכיב של צד שלישי שמשמש את Edge. לדוגמה, apigee-cassandra.
  • ‫edge: רכיב Edge מ-Apigee. לדוגמה, edge-management-server.
  • ‫edge-mint: רכיב מונטיזציה. לדוגמה, edge-mint-management-server.

רשימת הפעולות המלאה של רכיב תלויה ברכיב עצמו, אבל כל הרכיבים תומכים בפעולות הבאות:

  • start, stop, restart
  • status, version
  • backup, restore
  • install, uninstall

הגדרת רכיבי Edge

כדי להגדיר את Edge אחרי ההתקנה, משתמשים בשילוב של קובצי .properties וכלי שירות של Edge. לדוגמה, כדי להגדיר TLS/SSL בממשק המשתמש של New Edge, עורכים קובצי .properties כדי להגדיר את המאפיינים הנדרשים. כדי שהשינויים בקובצי .properties ייכנסו לתוקף, צריך להפעיל מחדש את רכיב Edge המושפע.

הקבצים של .properties נמצאים בספרייה /opt/apigee/customer/application. לכל רכיב יש קובץ .properties משלו בספרייה הזו. לדוגמה, router.properties ו-management-server.properties.

כדי להגדיר מאפיין לרכיב, עורכים את קובץ ה-.properties המתאים ואז מפעילים מחדש את הרכיב:

/opt/apigee/apigee-service/bin/apigee-service component restart

לדוגמה:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

כשמעדכנים את Edge, המערכת קוראת את קובצי ה-.properties בספרייה /opt/apigee/customer/application. כלומר, העדכון שומר על כל המאפיינים שהגדרתם ברכיב.

מידע נוסף על הגדרת Edge זמין במאמר איך מגדירים את Edge.

התקנת apigee-monit בצומת

אחרי שמשלימים את התקנת הרכיבים בצומת, אפשר להוסיף את כלי העזר apigee-monit. ‫apigee-monit יעקוב אחרי הרכיבים בצומת וינסה להפעיל אותם מחדש אם הם ייכשלו. מידע נוסף זמין במאמר תיקון עצמי באמצעות apigee-monit.

הגדרת שרת SymasLDAP לקריאה בלבד

אם בהתקנה של Edge יש שרת SymasLDAP שלא צריך להעביר אליו תנועה, מומלץ להגדיר את השרת לקריאה בלבד. לשם כך:

  1. יוצרים קובץ mark_readonly.ldif בשרת עם השורות הבאות:
    dn: olcDatabase={2}mdb,cn=config
      changetype: modify
      replace: olcReadOnly
      olcReadOnly: TRUE
  2. מריצים את הפקודה הבאה בשרת כדי לסמן אותו כקריאה בלבד:
      ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_readonly.ldif

אם השרת הראשי נכשל, אפשר לחזור להשתמש בשרת ההמתנה כשרת הראשי באופן הבא:

  1. יוצרים קובץ mark_writable.ldif בשרת ההמתנה עם השורה הבאה:
      dn: olcDatabase={2}mdb,cn=config
      changetype: modify
      replace: olcReadOnly
      olcReadOnly: FALSE
  2. מריצים את הפקודה הבאה בשרת הגיבוי:
      ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif