הגדרת רישיון
היכן Doconut מחפש את קובץ הרישיון שלך תחת IIS
בלי רישיון, Doconut עדיין מציג מסמכים — כל דף מציג סימן מים של הערכה. דף זה מסביר את ארבעת הדרכים לספק רישיון בGlobal.asax, היכן ש‑Doconut מחפש כאשר אינך מספק רישיון, ומה קורה כאשר רישיון של תוסף חסר.
ארבע דרכים לספק רישיון
יש שלושה מקורות מפורשים בDoconutOptions — נתיב קובץ, זרם, או תוכן גולמי — בנוסף לגילוי אוטומטי כאשר אף אחד מהם לא מוגדר. כולם נקראים פעם אחת, בDoconutHost.Initialize. כאשר מוגדרים יותר מאחד, סדר העדיפויות הוא מדויק:
LicenseStream גובר על LicenseContent גובר על LicensePath גובר על גילוי אוטומטי.
לפי נתיב
תן לLicensePath נתיב מלא. נתיב יחסי נפתר ביחס לתיקיית העבודה של התהליך, וב‑IIS זו תיקיית תהליך העובד עצמו, ולא האתר שלך. HostingEnvironment.MapPath ממיר נתיב יחסי לאתר לנתיב מלא:
Doconut.DoconutHost.Initialize(options =>
{
options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
});אם הקובץ אינו קיים, Doconut לא זורק חריגה ולא חוזר לגילוי אוטומטי: הוא לא טוען רישיון, והצופה מציג סימני מים. קבצי הרישיון לכל תוסף באותה תיקייה (Doconut.Viewer.<Capability>.lic) נקראים יחד איתו, ולכן LicensePath ו‑AddPlugin<...>() פועלים יחד כאשר רישיונות התוספים נמצאים לצד רישיון הבסיס.
לפי זרם
LicenseStream נקרא פעם אחת, בעת האתחול — שימושי כאשר הרישיון מגיע ממשאב משובץ או מחנות סודית במקום קובץ על הדיסק.
// קדימות: LicenseStream > LicenseContent > LicensePath > חיפוש אוטומטי.
Doconut.DoconutHost.Initialize(options =>
{
options.LicenseStream = licenseStream;
});לפי תוכן
LicenseContent מקבל את טקסט הרישיון עצמו — ממשתנה סביבתי, ממסד נתונים, או מחנות סודית — ולכן אין צורך לפרוס קובץ רישיון עם האתר.
// קובץ XML של רישיון ממסד נתונים, משתנה סביבתי או מחסן סודות -
// אין קובץ על הדיסק. רק LicenseStream מתעלה עליו.
Doconut.DoconutHost.Initialize(options =>
{
options.LicenseContent = Environment.GetEnvironmentVariable("DOCONUT_LICENSE") ?? "";
});גילוי אוטומטי
אל תגדיר אף אחד משלושת האפשרויות, ו‑Doconut יחפש את הרישיון בעצמו:
// אל תגדיר דבר, ו‑Doconut יחפש את הרישיון בעצמו, לפי הסדר הבא:
// 1. {CurrentDirectory}\wwwroot
// 2. {AppContext.BaseDirectory}\wwwroot (תחת IIS: תיקיית השורש של האתר)
// הוא מחפש תחילה את Doconut.lic; אם הוא חסר, אז Doconut.Viewer.lic ועוד
// קבצי Doconut.Viewer.<Capability>.lic לכל תוסף.
Doconut.DoconutHost.Initialize();שתי התיקיות, לפי סדר, והקבצים שמחפשים:
1. {CurrentDirectory}\wwwroot
2. {AppContext.BaseDirectory}\wwwroot
Filenames, in order (each one looked for in folder 1, then folder 2):
Doconut.lic — legacy all-in-one license; if found, nothing else is read
Doconut.Viewer.lic — base viewer license
Doconut.Viewer.<Capability>.lic — per-plugin licenses, read only when Doconut.Viewer.lic was foundב‑IIS וב‑IIS Express, AppContext.BaseDirectory הוא תיקיית השורש של האתר — התיקייה שמכילה את Web.config — ולא תיקיית bin שלו. לכן הרישיון צריך להיות בwwwroot תחת שורש האתר:
MySite\
Web.config
Global.asax
bin\
wwwroot\
Doconut.Viewer.lic
Doconut.Viewer.Converter.licבפרויקט, שמור את wwwroot\*.lic ליד Web.config ופרוס את התיקייה עם האתר. אין צורך שלב בנייה שיתעתק אותו לשום מקום. .lic במיקום אחר — בbin\, ליד Web.config, או בתת‑תיקייה של wwwroot — לעולם לא נקרא.
שמור קבצי
.licמחוץ לבקרת גרסאות. פרוס אותם לצד האתר, או ספק את הרישיון דרךLicenseContentאוLicenseStreamמהחנות הסודית שלך.
מה קורה ללא רישיון
חוסר רישיון אינו גורם לשגיאה. DoconutHost.Initialize מצליח, האתר מתחיל, והצופה פועל, אך כל דף מציג סימן מים של הערכה ואין שום יכולת אופציונלית המוענקת.
קובץ רישיון שנמצא אך נדחה הוא שונה. חתימה לא תקפה, שינוי, או בנייה מחוץ לחלון הגרסה של הרישיון גורמים לOpenDocumentAsync לזרוק LicenseException עם הסיבה. רישיון זמני שפג תוקפו ממשיך במצב סימן מים. רישיון בתשלום שהתאריך המנוי שלו עבר ממשיך לעבוד, נקי ועם היכולות שלו, על כל בנייה שפורסמה לפני תאריך זה.
תוספים זקוקים לרישיון שלהם בעת ההפעלה
רישום תוסף שהיכולת שלו אינה ניתנת על ידי רישיון עוצר את היישום בעת ההפעלה. DoconutHost.Initialize זורק בApplication_Start:
InvalidOperationException: The Converter plugin is registered via AddPlugin but no active
license grants Converter. Remove the AddPlugin<...>() call or install a license (or
trial/demo) that includes Converter.ב‑System.Web, אינך רואה את ההודעה הזאת בדפדפן. כל בקשה לאתר משיבה 500 ריק — ללא דף שגיאה, ללא עקבות מחסנית, ללא דבר ביומן IIS. החריגה נרשמת רק ביומן אירועי Windows (יומן יישום, מקור ASP.NET). אם כל האתר מפסיק להגיב מיד אחרי שהוספת שורת AddPlugin, בדוק את קבצי הרישיון בwwwroot לפני הקוד: הDoconut.Viewer.<Capability>.lic של התוסף צריך להיות ליד Doconut.Viewer.lic, וללא רישיון בסיסי קבצי התוסף אינם נקראים כלל.
אמת את הרישיון הטעון
IDoconutLicenseService הוא אותו מקור אמת שה‑SDK משתמש בו. פתר אותו מDoconutHost.Services כדי לחשוף נקודת קצה אבחונית מאומתת או לנהל דגלי תכונה — לעולם אל תחזיר את תוכן הרישיון:
// GET /License/Status
public ActionResult Status()
{
var license = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
return Json(new
{
viewer = license.IsViewerLicensed || license.IsTemporary,
temporary = license.IsTemporary,
search = license.IsCapabilityGranted(LicenseCapability.Search),
annotation = license.IsCapabilityGranted(LicenseCapability.Annotation),
converter = license.HasConverter,
dicom = license.HasDicom
}, JsonRequestBehavior.AllowGet);
}הרישיון נקרא פעם אחת, בDoconutHost.Initialize. לאחר החלפת קובץ רישיון, מחזיר את בריכת היישומים (או משגע את Web.config) כך שApplication_Start ירוץ שוב.
פתרון בעיות
| תסמין | סיבה משוערת | בדיקה |
|---|---|---|
| הצופה עובד אך כל דף מסומן במים | לא נמצא רישיון | האם .lic ב<site root>\wwwroot? קרא את נקודת הקצה של הסטטוס למעלה |
כל בקשה משיבה 500 ריק מיד אחרי הוספת תוסף | תוסף רשום אין לו רישיון המעניק לו | יומן אירועי Windows, מקור ASP.NET; ה.lic של התוסף ליד Doconut.Viewer.lic |
LicensePath עובד במכונה שלך אך לא בשרת | נתיב יחסי שנפתר ביחס לתיקיית תהליך העובד | בנה זאת עם HostingEnvironment.MapPath("~/wwwroot/...") |
קובץ .lic שהוחלף אינו משפיע | הרישיון נקרא כאשר היישום התחיל | החזר את בריכת היישומים |
OpenDocumentAsync זורק LicenseException | הרישיון נמצא אך נדחה | קרא את הודעת החריגה; אל תציג אותה ללקוחות לא מהימנים |
צעדים הבאים
- Licensing — יכולות, וכיצד לבדוק אותן בזמן ריצה.
- Troubleshooting — סימני מים, כשלי הפעלה, ותסמינים אחרים.
האם דף זה היה מועיל?