עדכון מופע של Looker באירוח בצד הלקוח

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

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

1. מורידים את הגרסה האחרונה של קובצי ה-JAR של Looker, כפי שמתואר בדף התיעוד הורדת קובצי ה-JAR של Looker.

2. עוצרים את תהליך Looker מהמעטפת, בתור המשתמש looker:

   sudo su - looker
   cd /home/looker/looker
   ./looker stop
   

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

3. מגבים את כל הספרייה של Looker, כולל ספריות מוסתרות (לפרטים נוספים, עיינו בדף התיעוד שחזור גיבויים).

4. אם העברתם את מסד הנתונים שמוגדר כברירת מחדל בזיכרון של Looker למסד נתונים חיצוני של MySQL, או אם אתם מעדכנים אשכול של Looker, אתם צריכים לגבות את מסד הנתונים של MySQL.

5. לפני שמעדכנים את Looker, צריך גם לוודא שהפרמטרים של שרת MySQL וברירת המחדל של השוואת הנתונים במסד הנתונים לקצה העורפי מוגדרים ל-utf8mb4_general_ci. אחרת, יכול להיות שיופיעו שגיאות של חוסר התאמה ב-collation אחרי העדכון.

6. משנים את השם של looker-x.x.x.jar ל-looker.jar ואת השם של looker-dependencies-x.x.x.jar ל-looker-dependencies.jar. מעתיקים את looker.jar ואת looker-dependencies.jar לספריית השרת (/home/looker/looker/looker.jar). שני הקבצים חייבים להיות באותה ספרייה.

7. מפעילים את תהליך Looker מהמעטפת כמשתמש looker:

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

   ./looker start
   

   אפשר גם להשתמש בפקודה java -jar כדי להפעיל את Looker. קובץ ה-JAR הראשי ימצא את קובץ ה-JAR של התלות כל עוד הוא נמצא בספרייה ./looker יחד עם קובץ ה-JAR הראשי.

   בנוסף, אם אתם מעדיפים להשתמש בסקריפט לטעינה בזמן ההפעלה ש-Looker מספקת, תוכלו למצוא סקריפט כזה בכתובת: https://github.com/looker/customer-scripts.

   כשמעדכנים את גרסת Looker, צריך לעדכן גם את מסד הנתונים הפנימי של Looker. עדכון מסד הנתונים נמשך בדרך כלל פחות מחמש דקות, אבל לפעמים הוא יכול להימשך יותר זמן מתהליך ההפעלה של Looker. אם תנסו להפעיל את Looker בזמן שמסד הנתונים הפנימי עדיין מתעדכן, תהליך הדימון (daemon) יסתיים אחרי שש דקות עם ההודעה "Timed out waiting for Looker to start".

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

   ps -f $(pgrep -f -- '-jar looker.jar')
   

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

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