התקנה של תוכנת השירות להגדרת קצה

Edge for Private Cloud גרסה 4.16.05

כדי להתקין את Edge בצומת, קודם מתקינים את כלי השירות apigee-setup של Edge. אם אתם נמצאים בסביבה שבה לצמתים אין חיבור חיצוני לאינטרנט, אתם צריכים להתקין גם עותק מקומי של מאגר Apigee.

יצירת קישור סימבולי מ-‎ /opt/apigee

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

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

כדי ליצור את הקישור הסימבולי, מבצעים את השלבים הבאים לפני שמורידים את הקובץ bootstrap_4.16.05.sh. צריך לבצע את כל השלבים האלה כמשתמש root:

1. יוצרים את המשתמש והקבוצה "apigee":
   > groupadd -r apigee
   > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
2. יוצרים קישור סימבולי מ-‎/opt/apigee לתיקיית הבסיס הרצויה להתקנה:
   > ln -Ts /srv/myInstallDir /opt/apigee
   כאשר ‎/srv/myInstallDir הוא המיקום הרצוי של קובצי Edge.
3. משנים את הבעלות על ספריית הבסיס של ההתקנה ועל הקישור הסימבולי למשתמש "apigee":
   > chown -h apigee:apigee /srv/myInstallDir /opt/apigee

דרישה מוקדמת: השבתת SELinux

כדי להתקין את כלי השירות apigee-setup של Edge או רכיבים כלשהם של Edge, צריך להשבית את SELinux או להגדיר אותו למצב permissive. במקרה הצורך, אחרי שמתקינים את Edge, אפשר להפעיל מחדש את SELinux.

• כדי להגדיר באופן זמני את SELinux למצב מתירני, מריצים את הפקודה הבאה:
  1. במערכת הפעלה Linux 6.x:
     echo 0 > /selinux/enforce
     
     כדי להפעיל מחדש את SELinux אחרי התקנת Edge:
     echo 1 > /selinux/enforce
  2. במערכת הפעלה Linux 7.x:
     setenforce 0
     
     כדי להפעיל מחדש את SELinux אחרי התקנת Edge:
     setenforce 1
• כדי להשבית את SELinux באופן סופי או להגדיר אותו למצב permissive:
  1. פותחים את /etc/sysconfig/selinux בכלי לעריכת טקסט.
  2. מגדירים SELINUX=disabled או SELINUX=permissive.
  3. שומרים את השינויים.
  4. מפעילים מחדש את הצומת.
  5. אם צריך, מפעילים מחדש את SELinux אחרי ההתקנה של Edge. כדי לעשות את זה, חוזרים על התהליך ומגדירים את SELINUX=enabled.

התקנת כלי השירות apigee-setup של Edge בצומת עם חיבור חיצוני לאינטרנט

כדי להתקין את Edge בצומת עם חיבור חיצוני לאינטרנט:

1. משיגים מ-Apigee את שם המשתמש והסיסמה שמשמשים לגישה למאגר של Apigee. אם כבר יש לכם שם משתמש וסיסמה לאתר ה-FTP של Apigee, אתם יכולים להשתמש בפרטי הכניסה האלה.
2. מתחברים לצומת כמשתמש root כדי להתקין את חבילות ה-RPM של Edge
   הערה: למרות שהתקנת חבילות RPM דורשת גישת root, אפשר להגדיר את Edge בלי גישת root.
3. משביתים את SELinux כמו שמתואר למעלה.
4. מורידים את הקובץ bootstrap_4.16.05.sh של Edge אל ‎/tmp/bootstrap_4.16.05.sh:
   > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
5. מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות:
   > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
   
   כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלתם מ-Apigee. אם לא תציינו את pWord, תתבקשו להזין אותו.
   
   כברירת מחדל, מנהל ההתקנה בודק אם מותקנת גרסה 1.8 של Java. אם לא, היא תתקין אותה. משתמשים באפשרות JAVA_FIX כדי לציין איך לטפל בהתקנה של Java. JAVA_FIX מקבל את הערכים הבאים:
   
   I = התקנת OpenJDK 1.8 (ברירת מחדל)
   C = המשך בלי להתקין את Java
   Q = יציאה. כדי להשתמש באפשרות הזו, צריך להתקין את Java בעצמכם.
   
   ההתקנה של כלי השירות apigee-service יוצרת את הקובץ ‎ /etc/yum.repos.d/apigee.repo שמגדיר את מאגר Apigee. כדי להציג את קובץ ההגדרה, משתמשים בפקודה:
   > cat /etc/yum.repos.d/apigee.repo
   
   כדי להציג את תוכן המאגר, משתמשים בפקודה:
   > sudo yum -v repolist 'apigee*'
6. משתמשים ב-apigee-service כדי להתקין את כלי השירות apigee-setup:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
7. משתמשים ב-apigee-setup כדי להתקין ולהגדיר רכיבי Edge בצומת. מידע נוסף זמין במאמר התקנת רכיבי Edge בצומת.

התקנת כלי השירות apigee-setup של Edge בצומת ללא חיבור חיצוני לאינטרנט

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

הערה: Apigee לא מארחת את כל יחסי התלות של צד שלישי במאגרים הציבוריים שלנו. צריך להוריד ולהתקין את יחסי התלות האלה ממאגרים שנגישים לכולם.

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

יצירת מאגר Apigee מקומי

כדי ליצור מאגר Apigee מקומי:

1. משיגים מ-Apigee את שם המשתמש והסיסמה שמשמשים לגישה למאגר של Apigee. אם כבר יש לכם שם משתמש וסיסמה לאתר ה-FTP של Apigee, אתם יכולים להשתמש בפרטי הכניסה האלה.
2. כדי להתקין את חבילות ה-RPM של Edge, מתחברים לצומת RedHat או CentOS כמשתמש root.
   הערה: כדי להתקין את RPM נדרשת גישת root, אבל אפשר להגדיר את Edge בלי גישת root.
3. מוודאים שמותקנת הגרסה העדכנית של yum-utils:
   > sudo yum update yum-utils
4. משביתים את SELinux כמו שמתואר למעלה.
5. מורידים את הקובץ bootstrap_4.16.05.sh של Edge אל ‎/tmp/bootstrap_4.16.05.sh:
   > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
6. מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות:
   > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
   
   כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלתם מ-Apigee. אם לא תציינו את pWord, תתבקשו להזין אותו.
7. מתקינים את הכלי apigee-mirror בצומת:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
8. משתמשים בכלי apigee-mirror כדי לסנכרן את מאגר Apigee עם הספרייה ‎/opt/apigee/data/apigee-mirror/repos/‎.
   
   כדי לצמצם את גודל המאגר, מוסיפים את --only-new-rpms כדי להוריד רק את קובצי ה-RPM האחרונים. עבור ההורדה, נדרש מקום בכונן בנפח של כ-1.6GB:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
   
   אם רוצים להוריד את כל המאגר, כולל קובצי RPM ישנים יותר, משמיטים את ‎--only-new-rpms. צריך מקום בכונן של כ-6GB כדי להוריד את כל המאגר:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
   
   עכשיו יש לכם עותק מקומי של מאגר Apigee. בקטע הבא מוסבר איך להתקין את כלי השירות apigee-setup של Edge מהמאגר המקומי.
9. (אופציונלי) אם רוצים להתקין את Edge מהמאגר המקומי באותו צומת שמארח את המאגר המקומי, צריך קודם להריץ את הפקודות הבאות:
   1. מריצים את bootstrap_4.16.05.sh מהמאגר המקומי כדי להתקין את כלי השירות apigee-service:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
   2. ‫משתמשים ב-apigee-service כדי להתקין את הכלי apigee-setup:
      ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
   3. משתמשים ב-apigee-setup כדי להתקין ולהגדיר רכיבי Edge בצומת. מידע נוסף זמין במאמר התקנת רכיבי Edge בצומת.

התקנת apigee-setup בצומת מרוחק מהמאגר המקומי

יש שתי אפשרויות להתקנת Edge מהמאגר המקומי. אתם יכולים:

• יוצרים קובץ ‎ .tar של המאגר, מעתיקים את קובץ ה-‎ .tar לצומת ואז מתקינים את Edge מקובץ ה-‎ .tar.
• מתקינים שרת אינטרנט בצומת עם המאגר המקומי כדי שצמתים אחרים יוכלו לגשת אליו. ב-Apigee אתם יכולים להשתמש בשרת האינטרנט Nginx או בשרת אינטרנט משלכם.

התקנה מקובץ ‎ .tar:

1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי בקובץ ‎ .tar יחיד בשם /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz:
   
   > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. מעתיקים את קובץ ה-‎ .tar לצומת שבו רוצים להתקין את Edge. לדוגמה, מעתיקים אותו לספרייה ‎/tmp בצומת החדש.
3. בצומת החדש, משביתים את SELinux כמו שמתואר למעלה.
4. בצומת החדש, מחלצים את הקובץ לספרייה ‎ /tmp:
   ‎> tar -xzf apigee-4.16.05.tar.gz
   
   הפקודה הזו יוצרת ספרייה חדשה בשם repos בספרייה שמכילה את קובץ ה-‎ .tar. לדוגמה: ‎/tmp/repos.
5. מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות מ-‎/tmp/repos:
   > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
   
   שימו לב שאתם כוללים את הנתיב לספריית המאגרים בפקודה הזו.
6. משתמשים ב-apigee-service כדי להתקין את הכלי apigee-setup:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
7. משתמשים ב-apigee-setup כדי להתקין ולהגדיר רכיבי Edge בצומת. מידע נוסף זמין במאמר התקנת רכיבי Edge בצומת.

מתקינים מהמאגר באמצעות שרת האינטרנט Nginx:

1. מתקינים את שרת האינטרנט Nginx בצומת המאגר:
   > opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
2. כברירת מחדל, Nginx מוגדר להשתמש ב-localhost כשם השרת וביציאה 3939. כדי לשנות את הערכים האלה:
   1. פותחים את הקובץ /opt/apigee/customer/application/mirror.properties בכלי לעריכת קוד. אם הקובץ לא קיים, יוצרים אותו.
   2. מגדירים את הערכים הבאים לפי הצורך:
      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost
   3. מפעילים מחדש את Nginx:
      > /opt/nginx/scripts/apigee-nginx restart
3. כברירת מחדל, המאגר דורש שם משתמש וסיסמה:admin:admin. כדי לשנות את פרטי הכניסה האלה, צריך להגדיר את משתני הסביבה הבאים:
   MIRROR_USERNAME=uName
   MIRROR_PASSWORD=pWord
4. בצומת החדש, משביתים את SELinux כמו שמתואר למעלה.
5. בצומת המרוחק, מורידים את הקובץ Edge bootstrap_4.16.05.sh אל /tmp/bootstrap_4.16.05.sh:
   > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
   
   כאשר uName:pWord הם שם המשתמש והסיסמה שהגדרתם למעלה למאגר, ו-remoteRepo הוא כתובת ה-IP או שם ה-DNS של צומת המאגר.
6. בצומת המרוחק, מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות:
   > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
   
   כאשר uName:pWord הם שם המשתמש והסיסמה של המאגר.
7. בצומת המרוחק, משתמשים ב-apigee-service כדי להתקין את כלי השירות apigee-setup:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
8. משתמשים ב-apigee-setup כדי להתקין ולהגדיר רכיבי Edge בצומת המרוחק. מידע נוסף זמין במאמר התקנת רכיבי Edge בצומת.

עדכון מאגר מקומי של Apigee

כדי לעדכן את המאגר, צריך להוריד את הקובץ bootstrap_4.16.05.sh העדכני ולבצע סנכרון חדש:

1. מורידים את הקובץ bootstrap_4.16.05.sh של Edge אל ‎/tmp/bootstrap_4.16.05.sh:
   > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
2. מבצעים את הסנכרון:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
3. אם רוצים להוריד את כל המאגר:
   > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

ניקוי מאגר מקומי של Apigee

ניקוי המאגר המקומי מוחק את /opt/apigee/data/apigee-mirror ואת /var/tmp/yum-apigee-*.‎

כדי לנקות את המאגר המקומי, משתמשים בפקודה:

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

הוספה או עדכון של Edge 4.16.01 במאגר 4.16.05

אם אתם צריכים לתחזק התקנות גם של Edge 4.16.05 וגם של 4.16.01, אתם יכולים לתחזק מאגר שמכיל את שתי הגרסאות. מהמאגר הזה אפשר להתקין את Edge 4.16.05 ו-4.16.01.

כדי להוסיף את גרסה 4.16.01 למאגר של גרסה 4.15.05:

1. מוודאים שהתקנתם את גרסה 4.16.05 של כלי השירות apigee-mirror:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
   
   התוצאה אמורה להופיע בפורמט הבא, כאשר xyz הוא מספר ה-build:
   apigee-mirror-4.16.05-0.0.xyz
2. משתמשים בכלי apigee-mirror כדי להוריד את Edge 4.16.01 למאגר. שימו לב כיצד אתם מוסיפים קידומת של apigeereleasever=4.16.01 לפקודה:
   > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
   
   השתמשו באותה פקודה כדי לעדכן מאוחר יותר את מאגר 4.16.01.
3. בודקים את הספרייה /opt/apigee/data/apigee-mirror/repos כדי לראות את מבנה הקובץ:
   > ls /opt/apigee/data/apigee-mirror/repos
   
   אמורים להופיע הקבצים והספריות הבאים:
   apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.sh thirdparty
   
   שימו לב שיש קובץ אתחול לשתי הגרסאות של Edge. הספרייה apigee מכילה גם ספריות נפרדות לכל גרסה של Edge.
4. כדי לארוז את המאגר לקובץ ‎ .tar, משתמשים בפקודה הבאה:
   > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
   
   הפקודה הזו אורזת את המאגרים 4.16.05 ו-4.16.01 לאותו קובץ ‎ .tar. אי אפשר לארוז רק חלק מהמאגר.

כדי להתקין את Edge מהמאגר המקומי או מקובץ ‎ .tar, צריך להריץ את קובץ ה-bootstrap הנכון באמצעות אחת מהפקודות הבאות:

• אם מתקינים מקובץ ‎ .tar, מריצים את קובץ ה-bootstrap הנכון מהמאגר:
  > sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  כדי להשלים את ההתקנה, פועלים לפי השלבים שנותרו בקטע "התקנה מקובץ ‎ .tar" למעלה.
• אם מתקינים באמצעות שרת האינטרנט Nginx, מורידים ומריצים את קובץ ה-bootstrap הנכון מהמאגר:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh
  > sudo bash /tmp/bootstrap_4.16.0X.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  כדי להשלים את ההתקנה, פועלים לפי השלבים הנותרים בקטע "התקנה מהמאגר באמצעות שרת האינטרנט Nginx" שלמעלה.