יצירת תוכנית מיגרציה

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

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

יצירת תוכנית מיגרציה לקונטיינר של מכונה וירטואלית של Linux

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

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p linux-vm-container \
  -o ANALYSIS_OUTPUT_PATH \
  [ -r skip_size_checks=SKIP_SIZE_CHECKS  ] \
  [ -r big_files_threshold_mb=SIZE_IN_MB ]

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PATH_TO_COPIED_FILESYSTEM: הנתיב לספרייה של מערכת הקבצים שהועתקה.
  • ‫ANALYSIS_OUTPUT_PATH: הנתיב לתיקייה שבה רוצים ליצור את פלט הניתוח.
  • ‫SKIP_SIZE_CHECKS: זהו פרמטר אופציונלי. כברירת מחדל, הערך הזה מוגדר ל-false, והכלי Migrate to Containers CLI בודק את שכבות התמונה כדי לוודא שהגודל לא חורג מ-15GB. אם הגודל הכולל של שכבות התמונה גדול מ-15GB, יצירת הארטיפקט תיכשל ויוצג ב-Migrate to Containers CLI הודעת שגיאה. כדי לדלג על בדיקת הגודל הזו, מגדירים את הפרמטר הזה לערך true.
  • ‫SIZE_IN_MB: זהו פרמטר אופציונלי. מציינים סף לגודל הקובץ ב-MB כדי לבדוק אם יש קבצים שחורגים מגודל מסוים. אם Migrate to Containers CLI מזהה קובץ שהגודל שלו חורג מסף הגודל שצוין, הוא מוסיף הערה בתוכנית ההעברה שנוצרה עם הצעה להחריג את הקובץ שזוהה מקובץ האימג' של הקונטיינר.

אחרי שהניתוח מסתיים, נוצרת ספרייה חדשה בנתיב הפלט שצוין, שמכילה את תוכנית ההעברה, config.yaml.

יצירת תוכנית העברה לעומסי עבודה של Tomcat

עבור רכיבי אפליקציית Tomcat, התהליך הזה דורש את הנתיבים catalina-home ו-catalina-base כקלט.

כדי לאחזר את הערכים האלה, בודקים את התהליך של שרת Tomcat שפועל:

ps aux | grep catalina

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

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p tomcat-container \
  -o ANALYSIS_OUTPUT_PATH \
  -r catalina-home=PATH_TO_CATALINA_HOME \
  -r catalina-base=PATH_TO_CATALINA_BASE \
  -r java-version=JAVA_VERSION

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PATH_TO_COPIED_FILESYSTEM: הנתיב לספרייה של מערכת הקבצים שהועתקה
  • ‫ANALYSIS_OUTPUT_PATH: הנתיב לתיקייה שבה רוצים ליצור את פלט הניתוח
  • ‫PATH_TO_CATALINA_HOME: הנתיב אל שורש ההתקנה של Tomcat
  • ‫PATH_TO_CATALINA_BASE: הנתיב אל שורש תצורת זמן הריצה של מופע Tomcat שמעבירים. אם יש כמה בסיסים, צריך להפריד ביניהם באמצעות נקודתיים.
  • ‫JAVA_VERSION: גרסת Java של הקונטיינר בפורמט X.Y. גרסת ברירת המחדל של Java היא 11.0.

אחרי שהניתוח מסתיים, נוצרת ספרייה חדשה בנתיב הפלט שצוין, שמכילה את תוכנית ההעברה, config.yaml.

יצירת תוכנית העברה לעומסי עבודה של WebSphere

אופציונלי: הגדרת binaryAppScanner.jar

אם רוצים להעביר עומסי עבודה של WebSphere traditional או לבצע העברה בין סביבות Java שונות, אפשר להגדיר את binaryAppScanner.jar. ‫Migrate to Containers CLI מבצע אוטומציה של השימוש ב-binaryAppScanner.jar כדי ליצור תצורות חדשות של WebSphere ולסייע במודרניזציה של זמן הריצה של Java.

כדי להגדיר את binaryAppScanner.jar:

  1. מורידים את קובץ ההתקנה, binaryAppScannerInstaller.jar, מIBM Support. כדי להוריד את התוכנה, צריך לאשר את הסכם הרישיון.

  2. מחץ את הקובץ binaryAppScanner.jar ומאשרים את הסכם הרישיון:

    java -jar binaryAppScannerInstaller.jar --acceptLicense --verbose INSTALL_LOCATION

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫INSTALL_LOCATION: ספריית היעד לחילוץ. לדוגמה, אם מציינים את /tmp כספריית היעד, אחרי שההתקנה מסתיימת, binaryAppScanner.jar זמין ב-/tmp/wamt/binaryAppScanner.jar.

ביצוע הניתוח

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

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p websphere-container \
  -o ANALYSIS_OUTPUT_PATH \
  -r websphere-profile=WEBSPHERE_PROFILE \
  -r websphere-home=WEBSPHERE_HOME \
  -r websphere-java-home=WEBSPHERE_JAVA_HOME \
  -r target-profile=TARGET_PROFILE \
  -r target-version=TARGET_VERSION \
  -r target-edition=TARGET_EDITION \
  -r target-se=TARGET_SE \
  -r target-ee=TARGET_EE \
  -r target-vendor=TARGET_VENDOR \
  -r target-base-image=TARGET_BASE_IMAGE \
  --volume PATH_TO_BINARYAPPSCANNER:/binaryAppScanner.jar

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PATH_TO_COPIED_FILESYSTEM: הנתיב לספריית מערכת של קובץ שהועתק.
  • ‫ANALYSIS_OUTPUT_PATH: הנתיב לתיקייה שבה רוצים ליצור את פלט הניתוח.
  • ‫WEBSPHERE_PROFILE: זהו פרמטר אופציונלי. מציינים את פרופיל WebSphere שבו נעשה שימוש במכונה הווירטואלית של המקור. פורמט: [Liberty|Traditional].
  • ‫WEBSPHERE_HOME: זהו פרמטר אופציונלי. מציינים את הנתיב להתקנת שרת האפליקציות במכונה הווירטואלית של המקור.
  • ‫WEBSPHERE_JAVA_HOME: זהו פרמטר אופציונלי. מציינים את הנתיב להתקנת Java במכונה הווירטואלית של המקור.
  • ‫TARGET_PROFILE: זהו פרמטר אופציונלי. מציינים את פרופיל WebSphere שבו רוצים להשתמש בקונטיינר היעד. פורמט: [Liberty|Traditional]. ברירת המחדל היא פרופיל המקור.
  • ‫TARGET_VERSION: זהו פרמטר אופציונלי. מציינים את הגרסה של WebSphere שבה רוצים להשתמש בקונטיינר היעד. ברירת המחדל היא גרסת המקור.
  • ‫TARGET_EDITION: זהו פרמטר אופציונלי. מציינים את מהדורת WebSphere שבה רוצים להשתמש בקונטיינר היעד. פורמט: [Base|Core|Open|ND]. ברירת המחדל היא המהדורה של המקור.
  • ‫TARGET_SE: זהו פרמטר אופציונלי. מציינים את גרסת Java SE שבה רוצים להשתמש בקונטיינר היעד. פורמט: [SE8|SE11|SE17]. ברירת המחדל היא Java SE.
  • ‫TARGET_EE: זהו פרמטר אופציונלי. מציינים את הגרסה של Java EE או Jakarta EE שבה רוצים להשתמש בקונטיינר היעד. פורמט: [EE7|EE8|EE9|EE10]. ברירת המחדל היא Java EE או Jakarta EE.
  • ‫TARGET_VENDOR: זהו פרמטר אופציונלי. מציינים את ספק Java שבו רוצים להשתמש בקונטיינר היעד. פורמט: [IBM Corporation|Oracle Corporation]. ברירת המחדל היא ספק Java המקורי.
  • ‫TARGET_BASE_IMAGE: זהו פרמטר אופציונלי. מציינים קובץ אימג' בסיסי לשימוש בקונטיינר היעד.
  • ‫PATH_TO_BINARYAPPSCANNER: זהו פרמטר אופציונלי. מציינים את הנתיב לקובץ binaryAppScanner.jar במחשב המקומי.

אחרי שהניתוח מסתיים, נוצרת ספרייה חדשה בנתיב הפלט שצוין, שמכילה את תוכנית ההעברה, config.yaml.

יצירת תוכנית להעברת עומסי עבודה של WebSphere Traditional

הגדרת הקובץ binaryAppScanner.jar

מורידים את הגרסה האחרונה של קובץ binaryAppScanner.jar.

אם כבר התקנתם את קובץ binaryAppScanner.jar, בודקים את הגרסה הנוכחית:

java -jar binaryAppScanner.jar --version

לאחר מכן, משווים את הגרסה הנוכחית לגרסה שמוצגת ברישיון של IBM שמופיע כשלוחצים על Migration Toolkit for Application Binaries כדי להוריד את הקובץ. אם הם שונים, מורידים את הגרסה האחרונה של הקובץ binaryAppScanner.jar.

הכלי Migrate to Containers CLI מאפשר להשתמש באופן אוטומטי ב-binaryAppScanner.jar, שזמין כחלק מ-IBM WebSphere Application Server Migration Toolkit for Application Binaries, כדי לחלץ קובצי הגדרות ומידע לגבי אפליקציות של WebSphere Application Server במכונה הווירטואלית של המקור.

לפני שמבצעים העברה, צריך לאשר את הסכם הרישיון ולהוריד את IBM WebSphere Application Server Migration Toolkit for Application Binaries, ואז לחלץ את קובץ binaryAppScanner.jar.

כדי להגדיר את binaryAppScanner.jar:

  1. מורידים את קובץ ההתקנה, binaryAppScannerInstaller.jar, מIBM Support. כדי להוריד את התוכנה, צריך לאשר את הסכם הרישיון.

  2. מריצים את הפקודה הבאה כדי לחלץ את הקובץ binaryAppScanner.jar ולאשר את הסכם הרישיון:

    java -jar binaryAppScannerInstaller.jar --acceptLicense --verbose

  3. מציינים את ספריית היעד לחילוץ. לדוגמה, אם מציינים את /tmp כספריית היעד, אחרי שההתקנה מסתיימת, binaryAppScanner.jar זמין ב-/tmp/wamt/binaryAppScanner.jar.

אחזור WAS_HOME

משתנה הסביבה WAS_HOME מציין איפה מותקן WebSphere Application Server traditional, למשל /opt/IBM/WebSphere/AppServer/. הכלי Migrate to Containers CLI משתמש בערך הזה כדי לאתר ולנתח בצורה נכונה את ההגדרה של WebSphere traditional.

כדי לאחזר את הערך הזה, בודקים את התהליך הפועל של WebSphere Application Server traditional:

ps aux | grep WAS_HOME

הרצת הניתוח

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

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p websphere-traditional-container -o ANALYSIS_OUTPUT_PATH \
  -r was-home=PATH_TO_WAS_HOME \
  --volume PATH_TO_BINARYAPPSCANNER:/binaryAppScanner.jar

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PATH_TO_COPIED_FILESYSTEM: הנתיב לספרייה של מערכת הקבצים שהועתקה.
  • ‫ANALYSIS_OUTPUT_PATH: הנתיב לתיקייה שבה רוצים ליצור את פלט הניתוח.
  • ‫PATH_TO_WAS_HOME: הנתיב להתקנה של WebSphere Application Server traditional.
  • ‫PATH_TO_BINARYAPPSCANNER: הנתיב לקובץ binaryAppScanner.jar. לדוגמה, אם ציינתם את /tmp בתור ספריית היעד, אז binaryAppScanner.jar זמין בכתובת /tmp/wamt/binaryAppScanner.jar.

אחרי שהניתוח מסתיים, נוצרת ספרייה חדשה בנתיב הפלט שצוין, שמכילה את תוכנית ההעברה, config.yaml.

יצירת תוכנית העברה לעומסי עבודה של JBoss

כדי ליצור תוכנית העברה לרכיבי אפליקציה של JBoss, צריך להזין את המשתנה JBOSS_HOME כקלט.

כדי לאחזר את הערך הזה, בודקים את התהליך של שרת JBoss שפועל:

ps aux | grep jboss.home.dir

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

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p jboss-container \
  -o ANALYSIS_OUTPUT_PATH \
  -r jboss-home=PATH_TO_JBOSS_HOME

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PATH_TO_COPIED_FILESYSTEM: הנתיב לספרייה של מערכת הקבצים שהועתקה
  • ‫ANALYSIS_OUTPUT_PATH: הנתיב לתיקייה שבה רוצים ליצור את פלט הניתוח
  • ‫PATH_TO_JBOSS_HOME: הנתיב להתקנת JBoss

אחרי שהניתוח מסתיים, נוצרת ספרייה חדשה בנתיב הפלט שצוין, שמכילה את תוכנית ההעברה, config.yaml.

יצירת תוכנית מיגרציה לעומסי עבודה של Apache

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

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p apache-container \
  -o ANALYSIS_OUTPUT_PATH

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PATH_TO_COPIED_FILESYSTEM: הנתיב לספרייה של מערכת הקבצים שהועתקה
  • ‫ANALYSIS_OUTPUT_PATH: הנתיב לתיקייה שבה רוצים ליצור את פלט הניתוח

אחרי שהניתוח מסתיים, נוצרת ספרייה חדשה בנתיב הפלט שצוין, שמכילה את תוכנית ההעברה, config.yaml.

יצירת תוכנית העברה לעומסי עבודה של WordPress

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

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p wordpress-container \
  -o ANALYSIS_OUTPUT_PATH

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PATH_TO_COPIED_FILESYSTEM: הנתיב לספרייה של מערכת הקבצים שהועתקה
  • ‫ANALYSIS_OUTPUT_PATH: הנתיב לתיקייה שבה רוצים ליצור את פלט הניתוח

אחרי שהניתוח מסתיים, נוצרת ספרייה חדשה בנתיב הפלט שצוין, שמכילה את תוכנית ההעברה, config.yaml.

יצירת תוכנית העברה לשירותי Windows IIS

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

./m2c analyze -s PATH_TO_IMAGE -p windows-iis-container -o ANALYSIS_OUTPUT_PATH

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PATH_TO_IMAGE: הנתיב לתמונת הדיסק של מכונת המקור. אפשר לציין יותר מקובץ תמונה אחד של דיסק בכל פעם באמצעות כמה דגלים -s לדוגמה, -s PATH_TO_IMAGE_1 -s PATH_TO_IMAGE_2...-s PATH_TO_IMAGE_N.
  • ‫ANALYSIS_OUTPUT_PATH: הנתיב לתיקייה שבה רוצים ליצור את פלט הניתוח.

אחרי שהניתוח מסתיים, נוצרת ספרייה חדשה בנתיב הפלט שצוין, שמכילה את תוכנית ההעברה, config.yaml.

המאמרים הבאים