לאחר ההתקנה

אחרי התקנה מוצלחת של 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 כדי להבטיח עקביות בכל הצמתים.
הפעלת ההתחלה האוטומטית להורות ל-Edge for Private Cloud להפעיל מחדש באופן אוטומטי במהלך אתחול.
התקנת ממשק המשתמש החדש של Edge ‫Apigee ממליצה להתקין את ממשק המשתמש החדש של 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 (קסנדרה)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (מסד נתונים של PostgreSQL)
  • apigee-qpidd (קיפוד)
  • apigee-sso (כניסה יחידה (SSO))
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (שרת ניהול)
  • edge-management-ui (ממשק קצה חדש של Edge)
  • edge-message-processor (מעבד הודעות)
  • edge-postgres-server (שרת Postgres)
  • edge-qpid-server (שרת Qpid)
  • edge-router (נתב קצה)
  • edge-ui (ממשק משתמש קלאסי)

בנוסף לרכיבים האלה, אפשר גם להפעיל את 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 בממשק המשתמש של 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.

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

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

  1. יוצרים קובץ mark_readonly.ldif בשרת עם השורות הבאות:
    dn: olcDatabase={2}bdb,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}bdb,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