Konfigurationsinställningar för OSGi osgi-configuration-settings

Last update: Sat Jul 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:
Konfigurering

Skapat för:

Administratör

OSGi är ett grundläggande element i AEM. Det används för att styra de sammansatta AEM och deras konfiguration.

OSGi innehåller standardmallar som gör att program kan skapas från små, återanvändbara och samarbetskomponenter. Dessa komponenter kan sättas samman till ett program och distribueras.

Den här funktionen gör det enkelt att hantera paket när de kan stoppas, installeras och startas individuellt. De inbördes beroendena hanteras automatiskt. Varje OSGi-komponent (se OSGi-specifikationen) finns i ett av de olika paketen. När du arbetar med AEM finns det flera metoder för att hantera konfigurationsinställningarna för sådana paket. Mer information och rekommenderade tillvägagångssätt finns i Konfigurera OSGi.

Följande OSGi-konfigurationsinställningar (listade efter paket) är relevanta för projektimplementeringen. Alla inställningar som visas behöver inte justeras, vissa anges för att du ska förstå hur AEM fungerar.

CAUTION

Förteckningen är avsedd att fungera som riktlinjer och är inte uttömmande. Alla paket visas inte och inte heller alla parametrar för vissa av de paket som ingår.

Den konfiguration som krävs varierar från projekt till projekt.

På webbkonsolen finns värden och detaljerad information om parametrar.

NOTE

Diff-verktyget för OSGi-konfiguration, som ingår i AEM Tools, kan användas för att lista OSGi-standardkonfigurationer.

NOTE

Ytterligare programpaket kan behövas för specifika funktionsområden inom AEM. I dessa fall finns konfigurationsinformation på sidan som rör lämplig funktion.

AEM Replikeringshändelseavlyssnare Konfigurera:

Körningslägen, i vilka replikeringshändelser distribueras till avlyssnare. Om det till exempel definieras som författare är det systemet som"initierar" replikeringen.
Lägg till körningsläget publish om projektkoden bearbetar replikeringshändelser (omvänd replikering) i en publiceringsmiljö. Exempel: när Dispatcher används för att tömma från publiceringsmiljön eller när standardsynkronisering med andra publiceringsinstanser sker.

AEM Databasändringslyssnare Konfigurera:

Sökvägar, platser att avlyssna för databashändelser som är klara för distribution.

CRX Sling-klientdatabas Konfigurera åtkomst till den underliggande innehållsdatabasen.

Administratörslösenordet bör ändras efter installationen för att säkerställa instansens säkerhet.
Andra ändringar bör inte vara nödvändiga och försiktighet måste vidtas eftersom de kan påverka åtkomsten till databasen.

Apache Felix OSGi Management Console Konfigurera:

Plugins, de viktigaste navigeringsobjekten (konsolplugin-program) som ska vara tillgängliga i Apache Felix Web Management Console som menyalternativ på den översta nivån. Inaktivera allt du inte behöver eftersom utrymme och resurser krävs för varje åtgärd.

CAUTION

Var noga med att konfigurera följande:

Användarnamn och lösenord, autentiseringsuppgifter för åtkomst till själva webbhanteringskonsolen för Apache Felix.
Lösenordet måste ändras efter den första installationen för att säkerställa instansens säkerhet.

NOTE

Den här konfigurationen bör göras med Felix Console så som den behövs vid start - innan databasen är tillgänglig.

Loggaren för anpassningsbara begärandedata för Apache Sling Konfigurera:

Loggningsnamn och Loggformat för att konfigurera plats och format för begäran och åtkomstloggning (standard: request.log). Den här loggfilen är viktig när du analyserar prestanda eller felsökningsfunktioner som är relaterade till webbkedjan. Den har parats med Apache Sling Request Logger.

Se AEM Loggning och Sling Logging.

Konfiguration av händelsetrådspool för Apache Sling:

Minsta poolstorlek och Maximal poolstorlek, storleken på poolen som används för att lagra händelsetrådar.
Köstorlek, den maximala storleken för trådkön om poolen är slut.
Det rekommenderade värdet är -1 eftersom kön anges till obegränsad. Om en gräns anges kan förluster uppstå när den överskrids.
Om du ändrar de här inställningarna kan du få bättre prestanda i scenarier med ett stort antal händelser. Till exempel AEM DAM eller arbetsflöde.
Värden som är specifika för ditt scenario bör fastställas med hjälp av tester.
De här inställningarna kan påverka instansens prestanda, så ändra dem inte utan orsak och vederbörlig hänsyn.

Apache Sling GET Server Konfigurera vissa återgivningsaspekter:

Automatiskt index om du vill aktivera/inaktivera katalogåtergivning för bläddring.
Aktivera (eller inaktivera) standardåtergivningar, till exempel HTML, Oformaterad text, JSON eller XML.
Inaktivera inte JSON.

NOTE

Den här inställningen konfigureras automatiskt för produktionsinstanser om du kör AEM i Produktionsklart läge.

Apache Sling JavaScript Handler Konfigurera inställningar för kompilering av Java-filer som skript (serverlets).

Vissa inställningar kan påverka prestanda. Inaktivera de här inställningarna där det är möjligt, särskilt för en produktionsinstans.

Source VM och Mål-VM definierar den JDK-version som används som JVM vid körning
för produktionsenheter:
- inaktivera Generera felsökningsinformation

Installationsprogram för Apache Sling JCR De här parametrarna behöver förmodligen inte konfigureras, men de kan vara användbara att känna till när du utvecklar eller felsöker. Installationsmapparna kan till exempel vara användbara när du vill checka in eller ut eller skapa ett paket.

Installationsmapparnas namn regexp och Maximalt hierarkidjup för installationsmappar - ange var och i vilket djup databasmapparna ska sökas efter resurser som ska installeras. När ett jokertecken används (som i .*/install) alla lämpliga matchningar söks igenom, till exempel /libs/sling/install och /libs/cq/core/install.
Sökväg, en lista med sökvägar som installeras söker efter resurser som ska installeras, tillsammans med en siffra som anger viktningsfaktorn för sökvägen.

Hanterare för jobbhändelser för Apache Sling Konfigurera parametrar som hanterar jobbplanering:

Återförsöksintervall, Maximalt antal försök, maximalt antal parallella jobb, Bekräfta väntetid, bland annat.
Om du ändrar de här inställningarna kan du förbättra prestandan i scenarier med ett stort antal jobb, till exempel stor användning av AEM DAM och arbetsflöden.
Värden som är specifika för ditt scenario bör fastställas med hjälp av tester.
Ändra inte de här inställningarna utan orsak. Ändra bara efter vederbörlig hänsyn.

Apache Sling JSP Script Handler Konfigurera prestandarelevanta inställningar för JSP-skripthanteraren. Om du vill förbättra prestandan bör du inaktivera så mycket som möjligt.

Särskilt för produktionsinstanser:

inaktivera Generera felsökningsinformation
inaktivera Behåll genererad Java™
inaktivera Mappat innehåll
inaktivera Visa Source-fragment

NOTE

Den här inställningen konfigureras automatiskt för produktionsinstanser om du kör AEM i Produktionsklart läge.

Konfiguration för Apache Sling-loggning Konfigurera:

Loggnivå och Loggfil för att definiera platsen och loggnivån för konfigurationen för central loggning (error.log). Nivån kan ställas in på något av DEBUG, INFO, WARN, ERROR och FATAL.
Antal loggfiler och Tröskelvärde för loggfil som definierar loggfilens storlek och versionsrotation.
Meddelandemönster definierar loggmeddelandenas format.

Se AEM Loggning och Sling Logging.

Loggningskonfiguration för Apache Sling (fabrikskonfiguration) Konfigurera:

Loggnivå, Loggfil och Meddelandeformat för att definiera information om loggfilen och meddelanden.
Logger för att definiera kategorin, till exempel bara log för com.day.cq.
Genom att använda Fabrikskonfigurationer kan valfritt antal ytterligare konfigurationer läggas till för att tillgodose de olika loggnivåer och kategorier som behövs.
Sådana konfigurationer är användbara under utvecklingen, till exempel för att logga TRACE-meddelanden för en viss tjänst i en specifik loggfil.
Sådana konfigurationer är användbara i en produktionsmiljö, t.ex. för att få meddelanden om en viss tjänst loggade till en enskild loggfil för enklare övervakning.

Se AEM Loggning och Sling Logging.

Konfiguration av skrivprogram för Apache Sling Logging (fabrikskonfiguration) Konfigurera:

Loggfil för att definiera om det finns en loggfil.
Antal loggfiler som definierar versionsrotationen.
Skrivaren kan användas av en konfiguration för Apache Sling-loggningsloggning.
Sådana konfigurationer är användbara under utvecklingen, till exempel för att logga TRACE-meddelanden för en viss tjänst i en specifik loggfil.
Sådana konfigurationer är användbara i en produktionsmiljö, t.ex. för att få meddelanden om en viss tjänst loggade till en enskild loggfil för enklare övervakning.

Se AEM Loggning och Sling Logging.

Huvudserverkonfiguration för Apache Sling:

Antal anrop per begäran och rekursionsdjup som skyddar datorn mot oändlig rekursion och för många skriptanrop.

Tjänsten Apache Sling MIME Type Konfigurera:

MIME-typer om du vill lägga till typer som krävs för ditt projekt i systemet. Om du gör det kan en GET-begäran för en fil ange rätt innehållstyprubrik för länkning av filtypen och programmet.

Refererarfilter för Apache Sling För att åtgärda kända säkerhetsproblem med CSRF (Cross-Site Request Forgery) i CRX WebDAV och Apache Sling måste du konfigurera referensfiltret.

Refererarfiltertjänsten är en OSGi-tjänst som du kan konfigurera:

vilka http-metoder som ska filtreras
om en tom referensrubrik tillåts
och en lista över servrar som ska tillåtas utöver servervärden.

Mer information finns i Säkerhetschecklistan - Problem med Förfalskning av begäran mellan webbplatser.

NOTE

Refererarfiltret för Apache Sling beror på installationen av ett snabbkorrigeringspaket.

Loggaren för Apache Sling-begäran Konfigurera:

olika parametrar för att definiera hur förfrågningar loggas.
Aktivera begärandeloggen om du vill aktivera eller inaktivera.
Aktivera åtkomstlogg om du vill aktivera eller inaktivera.

Parad med Dataloggningsprogrammet för anpassningsbara begäranden för Apache Sling.

Se AEM Loggning och Sling Logging.

Apache Sling Resource Resolver Factory Konfigurera centrala aspekter av Sling-resursupplösning:

Sökvägar för resurser, lägg till projektspecifika sökvägar (men ta inte bort /libs eller /apps).
Virtuella URL:er för att definiera dina egna URL-mappningar.
URL-mappningar för att definiera alias. Exempel: från /content till /.
Mappningsplats, mappningskonfigurationen har externaliserats i /etc/map.
Använd din lokala installation (använd till exempel https://localhost:4502/system/console/jcrresolver) för att avgöra vilken resurslösare som är aktiv.

Se: https://cwiki.apache.org/confluence/display/SLING/Flexible+Resource+Resolution.

CAUTION

Konfigurera dessa alternativ i databasen.

I annat fall kan ändringar som görs i URL-mappningar med Felix-konsolen skrivas över av AEM vid nästa start.

Hanterare för Apache Sling-server/skript Hanteraren för Sling-servern och skriptlösaren har flera uppgifter:

Den används som ServletResolver för att välja den server eller det skript som ska anropas för att hantera begäran.
Det fungerar som SlingScriptResolver.
Den hanterar felhantering genom att implementera ErrorHandler-gränssnittet med samma algoritm för att välja felhanteringsservrar och skript som används för att matcha servrar och skript för begärandebearbetning.

Du kan ange olika parametrar, bland annat:

Körningssökvägar - Visar sökvägarna för körbara skript. Genom att konfigurera specifika sökvägar kan du begränsa vilka skript som kan köras. Om ingen sökväg är konfigurerad används standardvärdet ( / = root), vilket tillåter körning av alla skript.
Om ett konfigurerat sökvägsvärde avslutas med ett snedstreck genomsöks hela underträdet. Utan ett sådant avslutande snedstreck körs skriptet bara om det är en exakt matchning.
Skriptanvändare - Den här valfria egenskapen kan ange det databasanvändarkonto som används för att läsa skripten. Om inget konto anges används användaren admin som standard.
Standardtillägg - Listan med tillägg som standardbeteendet används för. Det sista sökvägssegmentet i resurstypen kan användas som skriptnamn.

Proxykonfiguration för Apache HTTP Components - Proxykonfigurationen för all kod som använder Apache HTTP-klienten, används när en HTTP görs. Till exempel vid replikering.

När du skapar en konfiguration ska du inte ändra fabrikskonfigurationen. Skapa i stället en fabrikskonfiguration för den här komponenten med konfigurationshanteraren som finns här: https://localhost:4502/system/console/configMgr/. Proxykonfigurationen är tillgänglig i org.apache.http.proxyconfigurator.

NOTE

I AEM 6.0 och tidigare versioner konfigurerades proxy i Day Commons HTTP Client. Från och med AEM 6.1 och senare versioner har proxykonfigurationen flyttats till proxykonfigurationen för Apache HTTP Components i stället för konfigurationen för Day Commons HTTP Client.

Dag CQ Antispam Konfigurera den antispam-tjänst (Akismet) som används. Den här funktionen kräver att du registrerar följande:

Provider
API-nyckel
Registrerad URL

Adobe Granite HTML Library Manager Konfigurera för att styra hanteringen av klientbibliotek (css eller js), inklusive, t.ex., hur den underliggande strukturen visas.

För produktionsinstanser:
- aktivera Minify (för att ta bort CRLF- och whitespace-tecken).
- aktivera Gzip (om du vill tillåta att filer grupperas och nås med en begäran).
- inaktivera Felsök
- inaktivera Timing
För JS-utveckling (särskilt vid felsökning/felsökning):
- inaktivera Minify
- aktivera Debug för att separera filerna för felsökning och använda med brandfel.
- aktivera Timing om du är intresserad av timing.
- aktivera Debug-konsolen för att visa JS-konsolens loggmeddelanden.

CAUTION

När du ändrar inställningen för antingen Minify eller Gzip tar du bort innehållet i cachen för klienter. Mer information finns i kunskapsbasartikeln.

NOTE

Den här inställningen konfigureras automatiskt för produktionsinstanser om du kör AEM i Produktionsklart läge.

Day CQ HTTP Header Authentication Handler Systemomfattande inställningar för den grundläggande autentiseringsmetoden i HTTP-begäran.

När du använder stängda användargrupper kan du bland annat konfigurera följande:

HTTP-sfär
Standardinloggningssidan

Day CQ Link Checker Service Kontrollera och konfigurera vid behov:

Schemaläggarperiod för att definiera intervallet där externa länkar ska kontrolleras automatiskt.
Kontrollera Felaktigt intervall för länktolerans för den period efter vilken en felaktig extern länk anses vara skadad.
Åsidosätt mönster för länkkontroll om du vill definiera sökvägar som ska uteslutas från länkkontroll.

Dagens CQ-länkkontrollsaktivitet Konfigurera inställningar för en enskild länkkontrollsaktivitet (en uppgift som kontrollerar en extern länk):

Kontrollera intervallen som definierats i Testintervall för bra länkar och Testintervall för felaktig länk
De olika parametrar som rör proxy för Internetåtkomst och NTLM som behövs för extern åtkomst när en länk kontrolleras.

Day CQ Mail Service Konfigurera värdnamn och åtkomstinformation för e-postservern. Mer information finns i avsnittet Konfigurera e-posttjänsten.

Day CQ MCM Newsletter Konfigurera de olika inställningar som används i nyhetsbrevet.

Dag CQ-rotmappning Konfigurera:

Målsökväg som definierar var en begäran till / omdirigeras till.

Det finns två gränssnitt i AEM:

det pekaktiverade användargränssnittet är standardgränssnittet
och det inaktuella klassiska användargränssnittet fungerar fortfarande

Med hjälp AEM rotmappning kan du konfigurera det användargränssnitt som du vill använda som standard för din instans:

Målsökvägen bör peka på följande om du vill att det pekaktiverade användargränssnittet ska vara standardgränssnittet:

code language-shell
`/projects.html`

Målsökvägen ska peka på följande om du vill använda det klassiska användargränssnittet som standardgränssnitt:

code language-shell
`/welcome.html`

NOTE

I en standardinstallation är det pekoptimerade användargränssnittet standardgränssnittet.

Adobe Bevilja SSO-autentiseringshanterare - Konfigurera SSO-information (enkel inloggning). Dessa uppgifter behövs ofta i Enterprise Author Setup, ofta med LDAP.

Det finns olika konfigurationsegenskaper:

Sökväg
Sökvägen som den här autentiseringshanteraren är aktiv för. Om den här parametern lämnas tom inaktiveras autentiseringshanteraren. Sökvägen / gör att autentiseringshanteraren används för hela databasen.
Servicerankning
OSGi Framework Service Ranking-värdet används för att ange den order som används för att anropa den här tjänsten. Det här värdet är ett int-värde där högre värden anger högre prioritet.
Standardvärdet är 0.
Rubriknamn
Namnen på rubrikerna som kan innehålla ett användar-ID.
Cookie-namn
Namnen på cookies som kan innehålla ett användar-ID.
Parameternamn
Namnen på parametrarna som kan ge användar-ID.
Användarkarta
För valda användare kan användarnamnet som extraheras från HTTP-begäran ersättas med ett annat i autentiseringsobjektet. Mappningen definieras här. Om användarnamnet admin visas på båda sidor om kartan ignoreras mappningen. Tecknet "=" måste föregås av ett inledande "".
Format
Anger i vilket format användar-ID:t anges. Använd:
- Basic om användar-ID är kodat i HTTP Basic Authentication-format
- AsIs om användar-ID anges i oformaterad text eller om ett reguljärt uttryck använder ett värde som det är eller något reguljärt uttryck

Dag CQ WCM-felsökningsfilter Detta är användbart vid utveckling eftersom det tillåter användning av suffix som ?debug=layout vid åtkomst till en sida. https://localhost:4502/cf#/content/geometrixx/en/support.html?debug=layout innehåller till exempel layoutinformation som kan vara av intresse för utvecklaren.

För att säkerställa prestanda och säkerhet ska du inaktivera på produktionsenheter.

Dag CQ WCM-filter Konfigurera:

WCM-läge för att definiera standardläge.
På en författarinstans kan det här läget vara edit, disable,preview eller analytics.
De andra lägena kan nås från sidosparken eller så kan suffixet ?wcmmode=disabled användas för att emulera en produktionsmiljö.
På en publiceringsinstans måste det här läget anges till disabled för att säkerställa att inget annat läge är tillgängligt.

NOTE

Den här inställningen konfigureras automatiskt för produktionsinstanser om du kör AEM i Produktionsklart läge.

Dagens CQ WCM Link Checker-konfigurator Konfigurera:

Lista över omskrivningskonfigurationer för att ange en lista över platser för innehållsbaserade länkkontrollerarkonfigurationer. Konfigurationerna kan baseras på körningsläge. Detta är viktigt för att skilja mellan skribent- och publiceringsmiljöer, eftersom inställningarna för länkkontroll kan variera.

Day CQ WCM Page Manager Factory Konfigurera:

Aktiveringskontroll för sidunderträd för en användare (utan replikeringsbehörighet) att ta bort eller flytta sidor (även om sidorna inte är aktiverade).

Dagens CQ WCM-sidprocessor Konfigurera:

Banor, en lista över platser där systemet lyssnar efter sidändringar innan en jcr:Event aktiveras.

Spårare för Adobe-sidekomprimering För en författarinstans ska du konfigurera så här:

sling.auth.requirements: ange värdet för den här egenskapen till -/libs/wcm/stats/tracker

CAUTION

Den här konfigurationen tillåter anonyma begäranden till spårningstjänsten.

NOTE

Mer information finns i Sidavbildningar.

Dagens CQ WCM-sidstatistik Konfigurera för en publiceringsinstans:

URL för att skicka data för att konfigurera URL:en som används för att spåra sidstatistik (är viktig om en spårningsbegäran går igenom Dispatcher). Standardvärdet är till exempel https://localhost:4502/libs/wcm/stats/tracker.
Spårningsskript aktiverat för att aktivera ( true) eller inaktivera ( false) inkludering av spårningsskriptet på sidorna. Standardvärdet är false.

NOTE

Mer information finns i Sidavbildningar.

Day CQ WCM Version Manager Kontrollera om och hur versioner hanteras i systemet:

Skapa version vid aktivering, aktiverat i en standardinstallation
Aktivera rensning
Rensa banor, sökvägarna som sökningen igenom.
Implicit versionssökvägar, sökvägarna där implicit versionshantering är aktiv.
Högsta versionsålder, högsta ålder (i dagar) för en version
Max antal versioner, maximalt antal versioner att behålla

Mer information finns i Rensning av version.

Day CQ Workflow Email Notification Service Konfigurera e-postinställningarna för meddelanden som skickas av ett arbetsflöde.

CQ Rewriter HTML Parser Factory

Styr HTML-parsern för CQ-omskrivaren.

Ytterligare taggar att bearbeta - Du kan lägga till eller ta bort HTML-taggar som ska bearbetas av parsern. Som standard bearbetas följande taggar: A,IMG,AREA,FORM,BASE,LINK,SCRIPT,BODY,HEAD.
Bevara kamelskiftläge - Som standard konverterar HTML-tolken attribut i kameraläge (till exempel eBay) till gemener (till exempel ebay). Du kan inaktivera den här inställningen om du vill bevara attributen för kamerans skiftläge. Den här inställningen är användbar när du använder ramverk som t.ex. Angular 2.

Day Commons JDBC Connections Pool Konfigurera åtkomst till en extern databas som används som innehållskälla.

En fabrikskonfiguration, så att flera instanser kan konfigureras.

CDN Rewriter Kommunikation mellan AEM och CDN måste säkerställas så att resurser och binära filer levereras till en slutanvändare på ett säkert sätt. Den här processen omfattar följande två uppgifter:

Åtkomst till resursen från AEM via CDN första gången (eller efter att den har gått ut i cache).
Åtkomst till resursen som cachelagrats i CDN sker på ett säkert sätt. När resursen har cachelagrats i CDN går begäran inte till AEM och alla användare som har åtkomst till resursen på ska hanteras från CDN.

AEM innehåller en omskrivare för att skriva om interna URL:er för resurser till externa CDN-URL:er. Den skriver om länkar som ska skickas vidare till CDN, inklusive en JWS-signatur, och anger att resursen ska kunna nås på ett säkert sätt. Den här funktionen ska användas på författarinstanser.

Det övergripande flödet är följande:

Användaren autentiserar med AEM och begär en sida med resurser.
Den begärda sidan innehåller en resurs som liknar /content/dam/geometrixx-media/articles/paladin_trailer.jpg/jcr:content/renditions/cq5dam.thumbnail.319.319.png
Omskrivare omvandlar länken till en CDN-URL som innehåller en JWS-signatur:
CDN_domain/content/dam/geometrixx-media/articles/paladin_trailer.jpg/_jcr_content/renditions/cq5dam.thumbnail.319.319.png?cdn_sign=JWS_SIGNATURE
Användarens webbläsare vidarebefordrar sedan resursbegäran till CDN-servern
CDN ska konfigureras så att begäran vidarebefordras till AEM med parametern cdn_sign.
En autentiseringshanterare validerar parametern cdn_sign och returnerar resursen till CDN som sedan levereras till användaren

Flödet mellan användarens webbläsare, CDN och AEM kan visualiseras enligt följande.

chlimage_1-8

NOTE

Den här funktionen är bara aktiverad för AEM författarinstanser.

CDNConfigServiceImpl Tillhandahåller CDN-konfigurationer

CDN-omskrivningsfunktionen kan aktiveras genom att CDN-distributionsdomännamnet anges i konfigurationen för com.adobe.cq.cdn.rewriter.impl.CDNConfigServiceImpl.

Tjänsten innehåller även andra konfigurationsalternativ som att aktivera/inaktivera CDN-omskrivning, sökvägsprefix som CDN-omskrivning utförs för, TTL-värden och protokoll (HTTP eller HTTPS).

CDNRewriter En omskrivare för att skriva om interna bild-URL:er till CDN-URL:er

Värdet Taggattribut i com.adobe.cq.cdn.rewriter.impl.CDNRewriter kan definieras så att endast selektiva bildlänkar skrivs om.

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2