הפעלת ביטול כפילויות של מחרוזות במעבדי הודעות

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

במסמך הזה מוסבר איך מפעילים שכפול מחרוזות במעבדי הודעות של Apigee Edge.

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

מעבד ההודעות של Apigee Edge הוא רכיב מבוסס Java. השימוש בביטול כפילויות של מחרוזות במעבד הודעות יכול לשפר את הביצועים של שרתי ה-proxy של ה-API על ידי צמצום השימוש בזיכרון, במיוחד אם בשרתי ה-API יש שימוש נרחב במחרוזות.

אפשר להשתמש בתכונה 'ביטול כפילויות של מחרוזות' רק ב-G1 Garbage Collector (G1GC) באפליקציות Java. אם רוצים להפעיל את התכונה הזו במעבד ההודעות, צריך כבר להפעיל את G1GC או לאפשר ביטול כפילויות של מחרוזות וגם של G1GC במעבד ההודעות.

לפני שמתחילים

• אם אתם לא מכירים את G1GC, כדאי לקרוא את המאמר תחילת העבודה עם G1 Garbage Collector
• אם זו הפעם הראשונה שאתם משתמשים בשכפול מחרוזות, מומלץ לקרוא את המאמר ביטול כפילויות של מחרוזות של G1 Garbage Collector
• אם אתם לא יודעים איך להפעיל G1GC במעבדי הודעות בקצה, כדאי לקרוא את המאמר הפעלת G1GC במעבדי הודעות.
• אם אתם לא יודעים איך להגדיר מאפיינים ל-Edge ב-Private Cloud, קראו את ההוראות להגדרה של Edge.

הפעלה של ביטול כפילויות של מחרוזות במעבדי הודעות

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

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

1. איתור אסימון לנכס useStringDeduplication
2. הפעלת useStringDeduplication במעבד ההודעות

איתור אסימון לנכס useStringDeduplication

בשלבים הבאים מוסבר איך לאתר את האסימון של useStringDeduplication:

1. מחפשים את המאפיין useStringDeduplication בספריית המקור של מעבד ההודעות /opt/apigee/edge-message-processor/source באמצעות הפקודה הבאה:

   grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/source
   

2. בפלט של הפקודה הזו מוצג האסימון של המאפיין useStringDeduplication של מעבד ההודעות באופן הבא:

   /opt/apigee/edge-message-processor/source/conf/system.properties:useStringDeduplication={T}conf_system_useStringDeduplication{/T}
   

   כאשר המחרוזת בין התגים {T}{/T} היא שם האסימון שניתן להגדיר בקובץ .properties של מעבד ההודעות. לכן, האסימון של הנכס useStringDeduplication הוא:

   conf_system_useStringDeduplication
   

הפעלת שכפול מחרוזות במעבדי הודעות

בשלבים הבאים מתארים איך להפעיל ביטול כפילויות של מחרוזות במעבדי הודעות של Apigee:

1. פותחים את הקובץ /opt/apigee/customer/application/message-processor.properties במחשב שבמעבד ההודעות. אם הקובץ עדיין לא קיים, יוצרים אותו. לדוגמה:

   vi /opt/apigee/customer/application/message-processor.properties
   

2. מוסיפים לקובץ הזה את השורה הבאה:

   conf_system_useStringDeduplication=true
   

3. שומרים את השינויים.
4. צריך לוודא שקובץ המאפיינים הזה הוא בבעלות המשתמש של apigee. לדוגמה:

   chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
   

5. מפעילים מחדש את מעבד ההודעות באמצעות הפקודה הבאה:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
   

6. אם יש לכם יותר ממעבד הודעות אחד, צריך לחזור על השלבים האלה בכל מעבדי ההודעות.

אימות כפילויות של מחרוזות במעבדי ההודעות

בקטע הזה מוסבר איך לוודא שביטול הכפילויות של מחרוזות הופעל בהצלחה אצל מעבדי ההודעות.

למרות שמשתמשים באסימון conf_system_useStringDeduplication כדי להפעיל שכפול מחרוזות במעבד ההודעות, צריך לוודא שהנכס בפועל useStringDeduplication הוגדר עם הערך החדש באופן הבא:

1. מחפשים את הנכס useStringDeduplication בספרייה /opt/apigee/edge-message-processor/conf ובודקים שהוא הוגדר עם הערך החדש. לדוגמה:

   grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/conf
   

2. אם ביטול הכפילויות של מחרוזות הופעל בהצלחה במעבד ההודעות, הפקודה הקודמת תציג את הערך החדש בקובץ system.properties.

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

   /opt/apigee/edge-message-processor/conf/system.properties:useStringDeduplication=true
   

   בפלט לדוגמה, שימו לב שהנכס useStringDeduplication הוגדר עם הערך החדש true ב-system.properties. הסימון הזה מציין שביטול כפילויות של מחרוזות הופעל במעבד ההודעות.

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

מה השלב הבא?

הפעלת G1GC במעבדי הודעות