כדי להתקין או לעדכן את אפליקציית Looker לפריסה באירוח בצד הלקוח, צריך להוריד את קובצי ה-JAR של Looker. בדף הזה מתוארות שתי שיטות להורדת קובצי ה-JAR של Looker:
לפני שתוכלו להוריד את קובצי ה-JAR, תצטרכו לאשר הסכם רישיון למשתמש קצה (EULA), שזמין בדף האינטרנט הורדת קובץ JAR של Looker באמצעות המפרטים שבדף הזה. כל משתמש שמוריד את קובצי ה-JAR צריך לאשר את ה-EULA הזה רק פעם אחת. (אם ה-EULA יעודכן בעתיד, כל משתמש יצטרך לאשר גם את הגרסה החדשה).
שימוש בדף האינטרנט Download Looker JAR file
אפשר לגשת לדף האינטרנט Download Looker JAR file בקישור הזה: https://download.looker.com/validate. כדי להוריד את קובצי ה-JAR של Looker:
- מזינים את מספר הרישיון של Looker.
- הוסף את כתובת האימייל שלך. הדומיין צריך להיות דומיין אימייל בשרת פרטי.
בוחרים את גרסת Looker להורדה.
אם בוחרים באפשרות הגרסה האחרונה, מורידים את הגרסה האחרונה של קובצי ה-JAR של Looker לגרסת Looker הנוכחית. אם בוחרים באפשרות גרסה ספציפית, צריך להזין בדיוק את שם קובץ ה-JAR של Looker Core.
לוחצים על קבלת ההורדה.
אם עדיין לא אישרתם את הסכם הרישיון למשתמש קצה, יופיע טופס אישור הסכם הרישיון למשתמש קצה. בוחרים באפשרות קריאת התנאים וההגבלות כדי לראות את הסכם הרישיון למשתמש קצה במלואו. לאחר מכן, מזינים את השם הפרטי ואת שם המשפחה ומסמנים את התיבה לצד אני מסכים/ה לתנאים ולהגבלות. לסיום, לוחצים על קבלת ההורדה.
לוחצים על הורדה 1 מתוך 2 כדי להוריד את קובץ ה-JAR של Looker Core. לאחר מכן, לוחצים על הורדה 2 מתוך 2 כדי להוריד את קובץ ה-JAR של יחסי התלות ב-Looker. התוקף של הקישור יפוג אחרי 10 דקות. אם תוקף הקישור פג, אפשר להפעיל מחדש את תהליך ההורדה.
קריאה ל-API
כדי להוריד את קובצי ה-JAR באמצעות קריאה ל-API, קודם צריך לאשר את הסכם הרישיון למשתמש הקצה דרך דף האינטרנט Download Looker JAR file.
אחרי כן, אפשר לשלוח את קריאה ל-API הנדרשת באמצעות בקשת POST לנקודת הקצה של HTTPS בכל שיטה שרוצים – JavaScript, Java, Ruby, פקודת Shell וכו'. כדי שהבקשות האלה יפעלו, צריך להשתמש בשיטת POST כדי לשלוח את מטען ה-API לכתובת https://apidownload.looker.com/download. מטען ה-API חייב להכיל ערכים עבור lic, email ו-latest.
המאפיין latest מציין את הגרסה של Looker JAR. כדי להוריד את הגרסה האחרונה של קובצי ה-JAR לגרסת Looker הנוכחית (looker-latest.jar), מספיק לציין את "latest". כדי להוריד גרסה ספציפית, מגדירים את latest ל-"specific" וכוללים עוד צמד מפתח/ערך במטען הייעודי (payload) של ה-API שנקרא specific, עם שם קובץ ה-JAR של הליבה כערך.
צריך להתקשר ל-API רק פעם אחת. התגובה הראשונית תכיל את שני קישורי ההורדה ותהיה זמינה למשך 10 דקות. תצטרכו להוריד את שני קובצי ה-JAR בנפרד.
הנה שתי דוגמאות לשליחת בקשה שנכתבה ב-ES6 (JavaScript). כדי לבקש את הגרסה האחרונה:
axios({
url: "https://apidownload.looker.com/download",
method: "post",
data: {
lic: "YOUR-LOOK-ERLI-CENS-EKEY",
email: "contact@email.com",
latest: "latest"
}
}).then(function (response) {
console.log(response.data);
})
כדי לבקש גרסת JAR ספציפית (לדוגמה, Looker 22.2):
none
data: {
lic: "YOUR-LOOK-ERLI-CENS-EKEY",
email: "contact@email.com",
latest: "specific",
specific: "looker-22.2-latest.jar"
}
הנה שתי דוגמאות לפקודות של מעטפת פקודות לשליחת בקשות POST לנקודת הקצה של HTTPS.
כדי לבקש גרסה ספציפית של קובצי JAR באמצעות הפקודה wget (לדוגמה, Looker 22.2):
wget -O- --header=Content-Type:application/json\
--post-data='{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"specific",\
"specific":"looker-22.2-latest.jar"}'\
"https://apidownload.looker.com/download"
wget -O- --header=Content-Type:application/json\
--post-data='{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"specific",\
"specific":"looker-dependencies-22.2-latest.jar"}'\
"https://apidownload.looker.com/download"
כדי לבקש את קובצי ה-JAR העדכניים ביותר באמצעות סדרה של פקודות curl ו-wget להורדה ולשמירה של הקבצים באופן מקומי:
curl -X POST -H 'Content-Type: application/json' -d '{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"latest"}'
https://apidownload.looker.com/download > api_response.json
sed -i 1,12d api_response.json
wget -O "looker-latest.jar" "$(cat api_response.json | jq -r '.url')"
wget -O "looker-dependencies-latest.jar" "$(cat api_response.json | jq -r '.depUrl')"
לחלופין, אם התקנתם את jq ואת wget, אתם יכולים להשתמש בדוגמאות הבאות של פקודות Shell.
כדי לבקש את קובצי ה-JAR העדכניים באמצעות סדרה של פקודות wget:
wget -O "looker-latest.jar" "$(shell curl -s -X POST -H 'Content-Type: application/json'\
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"latest\"}\
"https://apidownload.looker.com/download | jq .url -r)"
wget -O "looker-dependencies-latest.jar" "$(shell curl -s -X POST -H 'Content-Type: application/json'\
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"latest\"}\
"https://apidownload.looker.com/download | jq .depUrl -r)"
אפשר גם להוריד גרסאות אחרות של JAR על ידי הגדרת LOOKER_VERSION ל-latest, ל-22.2-latest או לגרסה נתמכת אחרת בסדרת דוגמאות הפקודות הבאה. לדוגמה, כדי לבקש את קובצי הליבה והתלות של Looker 22.2:
export LOOKER_VERSION="22.2-latest"
wget -O "looker$(LOOKER_VERSION).jar" "$(shell curl -s -X POST -H 'Content-Type: application/json'\
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"specific\",\
\"specific\":\"looker-$(LOOKER_VERSION).jar\"} "https://apidownload.looker.com/download | jq .url -r)"
wget -O "looker-dependencies$(LOOKER_VERSION).jar" "$(shell curl -s -X POST -H\
'Content-Type: application/json' -d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\":\
\"$(contact@email.com)\",\"latest\":\"specific\", \"specific\":\"looker-dependencies-$(LOOKER_VERSION).jar\"}\
"https://apidownload.looker.com/download | jq .depUrl -r)"
שגיאות במטען הייעודי (payload) של ה-API, כמו פרמטרים חסרים או שגויים, גורמות לתגובה 'גוף הבקשה לא תקין'. אם תספקו מפתח רישיון שגוי או תשמיטו את הערך specific כשאתם מבקשים גרסה specific, תקבלו את התשובה Invalid request (בקשה לא תקינה).
אם יש בעיות בהורדה של שני קובצי ה-JAR, יכול להיות שתופיע הודעה בשדה splitJarMessage.
אם לא אישרתם בעבר את הסכם הרישיון למשתמש הקצה העדכני, התגובה תכיל שלושה שדות: eulaMessage, eulaText ו-eulaNeeded. השגיאה eulaMessage תציין שקודם צריך לאשר את הסכם הרישיון למשתמש הקצה דרך דף האינטרנט Download Looker JAR file לפני שה-API יחזיר כתובת URL להורדה.