DocumentazioneAEM 6.4Guida all’amministrazione

Come lavorare con i pacchetti

Ultimo aggiornamento: 4 maggio 2023
  • Argomenti:
  • Administering

Creato per:

  • Admin
CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

I pacchetti consentono l'importazione e l'esportazione del contenuto del repository. Ad esempio, puoi utilizzare i pacchetti per installare nuove funzionalità, trasferire contenuti tra le istanze e eseguire il backup del contenuto dell’archivio.

I pacchetti sono accessibili e/o mantenuti dalle pagine seguenti:

  • Gestione pacchetti, che consente di gestire i pacchetti nell’istanza AEM locale.

  • Condivisione pacchetti, un server centralizzato che contiene sia i pacchetti disponibili al pubblico che quelli privati per la tua azienda. I pacchetti pubblici possono contenere hotfix, nuove funzionalità, documentazione, ecc.

Puoi trasferire i pacchetti tra Gestione pacchetti, Condivisione pacchetti e il file system.

Cosa sono i pacchetti?

Un pacchetto è un file zip che tiene il contenuto dell’archivio sotto forma di una serializzazione del file system (chiamata serializzazione "vault"). Questo fornisce una rappresentazione semplice da usare e modificare di file e cartelle.

I pacchetti includono contenuto, sia contenuto di pagina che contenuto relativo al progetto, selezionato utilizzando i filtri.

Un pacchetto contiene anche metadati vault, incluse le definizioni del filtro e le informazioni di configurazione dell'importazione. Nel pacchetto possono essere incluse ulteriori proprietà di contenuto (non utilizzate per l’estrazione del pacchetto), ad esempio una descrizione, un’immagine visiva o un’icona; queste proprietà sono riservate al consumatore del pacchetto di contenuti e solo a scopo informativo.

NOTE
I pacchetti rappresentano la versione corrente del contenuto al momento della creazione del pacchetto. Non includono versioni precedenti del contenuto AEM conservato nell’archivio.

Puoi eseguire le seguenti azioni su o con i pacchetti:

  • Creare nuovi pacchetti; definizione delle impostazioni del pacchetto e dei filtri in base alle esigenze
  • Anteprima del contenuto del pacchetto (prima della generazione)
  • Creare pacchetti
  • Visualizza informazioni sul pacchetto
  • Visualizza il contenuto del pacchetto (dopo la creazione)
  • Modificare la definizione dei pacchetti esistenti
  • Rigenera i pacchetti esistenti
  • Riavvolgere i pacchetti
  • Scarica i pacchetti da AEM al tuo file system
  • Caricare pacchetti dal file system nell'istanza AEM locale
  • Convalida il contenuto del pacchetto prima dell’installazione
  • Eseguire un'installazione a secco
  • Installa i pacchetti (AEM non installa automaticamente i pacchetti dopo il caricamento)
  • Elimina pacchetti
  • Scarica pacchetti, come hotfix, dalla libreria Condivisione pacchetti
  • Carica i pacchetti nella sezione interna dell'azienda della libreria Condivisione pacchetti

Informazioni sul pacchetto

Una definizione del pacchetto è composta da vari tipi di informazioni:

  • Impostazioni pacchetto
  • Filtri del pacchetto
  • Schermate del pacchetto
  • Icone del pacchetto

Impostazioni pacchetto

Puoi modificare diverse impostazioni del pacchetto per definire aspetti quali la descrizione del pacchetto, i bug correlati, le dipendenze e le informazioni sul provider.

La Impostazioni pacchetto la finestra di dialogo è disponibile tramite Modifica quando creazione o modifica un pacchetto e fornisce tre schede per la configurazione. Dopo aver apportato le modifiche, fai clic su OK per salvarli.

packagesedit

Campo
Descrizione
Nome
Nome del pacchetto.
Gruppo
Nome del gruppo a cui aggiungere il pacchetto, per organizzare i pacchetti. Digitare il nome di un nuovo gruppo o selezionare un gruppo esistente.
Versione
Testo da utilizzare per la versione personalizzata.
Descrizione
Breve descrizione del pacchetto. Il markup HTML può essere utilizzato per la formattazione.
Miniatura
Icona visualizzata con l’elenco dei pacchetti. Fare clic su Sfoglia per selezionare un file locale.

chlimage_1-344

Campo
Descrizione
Formato/Esempio
Nome
Nome del provider.
Geometrixx AEM
URL
URL del provider.
https://www.aem-geometrixx.com
Collegamento
Collegamento specifico per il pacchetto a una pagina del provider.
https://www.aem-geometrixx.com/mypackage.html
Richiede
  • Amministratore: Seleziona quando il pacchetto può essere installato solo da un account con privilegi di amministratore.
  • Riavvia: Seleziona quando il server deve essere riavviato dopo l'installazione del pacchetto.
Gestione AC

Specifica come vengono gestite le informazioni sul controllo di accesso definite nel pacchetto quando il pacchetto viene importato:

  • Ignora
  • Sovrascrivi
  • Unisci
  • Cancella
  • MergePreserve

Il valore predefinito è Ignora.

  • Ignora - Mantieni ACL nell'archivio
  • Sovrascrittura - sovrascrittura delle ACL nel repository
  • Unisci - unire entrambi i set di ACL
  • Cancella - cancella ACL
  • MergePreserve - unire il controllo di accesso nel contenuto con quello fornito con il pacchetto aggiungendo le voci di controllo di accesso delle entità principali non presenti nel contenuto

packagesdipendenze

Campo
Descrizione
Formato/Esempio
Testato con
Il nome e la versione del prodotto a cui è destinato il pacchetto o con cui è compatibile.
AEM6
Bug/problemi risolti
Campo di testo che consente di elencare i dettagli dei bug corretti con questo pacchetto. Elenca ogni bug su una riga separata.
riepilogo bug-nr
Dipende da
Elenca le informazioni di dipendenza che devono essere rispettate ogni volta che altri pacchetti sono necessari per consentire l'esecuzione del pacchetto corrente come previsto. Questo campo è importante quando si utilizzano gli hotfix.
groupIdversion
Sostituisce
Elenco dei pacchetti obsoleti che questo pacchetto sostituisce. Prima di eseguire l'installazione, controlla che questo pacchetto includa tutti i contenuti necessari dai pacchetti obsoleti in modo che nessun contenuto venga sovrascritto.
groupIdversion

Filtri del pacchetto

I filtri identificano i nodi del repository da includere nel pacchetto. A Definizione del filtro specifica le seguenti informazioni:

  • La Percorso radice del contenuto da includere.
  • Regole che includono o escludono nodi specifici sotto il percorso principale.

I filtri possono includere zero o più regole. Quando non sono definite regole, il pacchetto contiene tutto il contenuto presente nel percorso principale.

Puoi definire una o più definizioni di filtro per un pacchetto. Utilizza più di un filtro per includere il contenuto di più percorsi principali.

chlimage_1-345

La tabella seguente descrive queste regole e fornisce esempi:

Tipo di regola
Descrizione
Esempio
include

È possibile definire un percorso o utilizzare un'espressione regolare per specificare tutti i nodi che si desidera includere.

L’inclusione di una directory comporta le seguenti operazioni:

  • includi la directory e tutti i file e le cartelle presenti in tale directory (ovvero l'intero sottoalbero)
  • not includere altri file o cartelle dal percorso principale specificato
/libs/sling/install(https://experienceleague.adobe.com/.*?lang=it)?
escludi
Puoi specificare un percorso o utilizzare un'espressione regolare per specificare tutti i nodi da escludere.

L’esclusione di una directory esclude tale directory e tutti i file e le cartelle presenti in tale directory (ovvero l’intero sottoalbero).
/libs/wcm/foundation/components(https://experienceleague.adobe.com/.*?lang=it)?
NOTE
Un pacchetto può contenere più definizioni di filtro, in modo che i nodi da posizioni diverse possano essere facilmente combinati in un unico pacchetto.

I filtri dei pacchetti sono definiti più spesso al primo momento crea il pacchetto, ma possono essere modificati anche in un secondo momento (dopo di che il pacchetto deve essere ricostruito).

Schermate del pacchetto

Puoi allegare le schermate al pacchetto per fornire una rappresentazione visiva dell’aspetto del contenuto; ad esempio, fornendo schermate di nuove funzionalità.

Icone del pacchetto

Puoi anche allegare un’icona al pacchetto per fornire una rappresentazione visiva di riferimento rapido di ciò che contiene il pacchetto. Questo viene quindi mostrato nell'elenco dei pacchetti e può aiutarti a identificare facilmente il pacchetto, o la classe del pacchetto.

Poiché un pacchetto può contenere un’icona, le seguenti convenzioni vengono utilizzate per i pacchetti ufficiali:

NOTE
Per evitare confusione, utilizza un’icona descrittiva per il pacchetto e non utilizzare una delle icone ufficiali.

Pacchetto Hotfix ufficiale:

Pacchetto di installazione o estensione AEM ufficiale:

Feature pack ufficiale:

Gestione pacchetti

Gestione pacchetti gestisce i pacchetti nell’installazione AEM locale. Dopo aver assegnate le autorizzazioni necessarie puoi utilizzare Gestione pacchetti per diverse azioni, tra cui configurazione, creazione, download e installazione dei pacchetti. Gli elementi chiave da configurare sono:

  • Impostazioni pacchetto
  • Filtri del pacchetto

Autorizzazioni necessarie per l’utilizzo di Gestione pacchetti

Per concedere agli utenti il diritto di creare, modificare, caricare e installare pacchetti, devi assegnare loro le autorizzazioni appropriate nelle seguenti posizioni:

  • /etc/packages (diritti completi, esclusa la cancellazione)
  • il nodo che contiene il contenuto del pacchetto

Vedi Impostazione delle autorizzazioni per istruzioni sulla modifica delle autorizzazioni.

Creazione di un nuovo pacchetto

Per creare una nuova definizione di pacchetto:

  1. Nella schermata di benvenuto AEM, fai clic su Pacchetti o dal Strumenti console fare doppio clic su Pacchetti).

  2. Quindi seleziona Gestione pacchetti.

  3. Fai clic su Crea pacchetto.

    NOTE
    Se l’istanza dispone di molti pacchetti, potrebbe essere presente una struttura di cartelle, in modo da poter passare alla cartella di destinazione richiesta prima di creare il nuovo pacchetto.

  4. Nella finestra di dialogo:

    pacchetti nuovi

    Inserisci:

    • Nome gruppo

      Nome del gruppo di destinazione (o della cartella). I gruppi sono destinati ad essere utilizzati per organizzare i pacchetti.

      Se non esiste già, verrà creata una cartella per il gruppo. Se lasci vuoto il nome del gruppo, verrà creato il pacchetto nell'elenco dei pacchetti principali (Home > Pacchetti).

    • Nome pacchetto

      Nome del nuovo pacchetto. Seleziona un nome descrittivo per identificare facilmente il contenuto del pacchetto.

    • Versione

      Campo di testo per indicare una versione. Questo verrà aggiunto al nome del pacchetto per formare il nome del file zip.
      Fai clic su OK per creare il pacchetto.

  5. AEM elenca il nuovo pacchetto nella cartella di gruppo appropriata.

    packagesitem

    Fai clic sull'icona o sul nome del pacchetto da aprire.

    packagesitemcliccato

    NOTE
    Se necessario, puoi tornare a questa pagina in un secondo momento.

  6. Fai clic su Modifica per modificare impostazioni del pacchetto.

    Qui puoi aggiungere informazioni e/o definire determinate impostazioni; ad esempio, includono una descrizione, il icona, bug correlati e aggiungere dettagli sul provider.

    Fai clic su OK al termine della modifica delle impostazioni.

  7. Aggiungi Schermate al pacchetto come necessario. È disponibile un’istanza quando il pacchetto viene creato, aggiungi di più se necessario utilizzando Schermata del pacchetto dalla barra laterale.

    Aggiungi l’immagine effettiva facendo doppio clic sul componente immagine nel Schermate area, aggiunta di un’immagine e clic OK.

  8. Definisci la Filtri del pacchetto trascinando le istanze Definizione del filtro dalla barra laterale, fate doppio clic per aprire la modifica:

    packagesfilter

    Specifica:

    • Percorso radice
      il contenuto da imballare; può essere la radice di un sottoalbero.

    • Regole
      Le regole sono facoltative; per le semplici definizioni dei pacchetti, non è necessario specificare regole di inclusione o esclusione.

      Se necessario, puoi definire Includi o Escludi regole per definire esattamente il contenuto del pacchetto.

      Aggiungi regole utilizzando + simbolo, in alternativa rimuovere le regole utilizzando - simbolo. Le regole vengono applicate in base al loro ordine in modo da posizionarle come richiesto utilizzando Su e Giù pulsanti.
      Quindi fai clic su OK per salvare il filtro.

    NOTE
    È possibile utilizzare tutte le definizioni di filtro necessarie, anche se è necessario fare attenzione a non creare conflitti. Utilizzo Anteprima per confermare quale sarà il contenuto del pacchetto.

  9. Per confermare ciò che il pacchetto contiene, puoi utilizzare Anteprima. Questo esegue una prova del processo di compilazione ed elenca tutti gli elementi che verranno aggiunti al pacchetto quando viene effettivamente generato.

  10. Ora puoi Crea il tuo pacchetto.

    NOTE
    Non è obbligatorio costruire il pacchetto a questo punto, può essere fatto in un momento successivo.

Creazione di un pacchetto

Un pacchetto viene spesso generato contemporaneamente a te crea la definizione del pacchetto, ma puoi tornare in un secondo momento per generare o ricreare il pacchetto. Questo può essere utile se il contenuto all’interno dell’archivio è stato modificato.

NOTE
Prima di costruire il pacchetto può essere utile visualizzare in anteprima il contenuto del pacchetto. Fai clic su Anteprima.

  1. Apri la definizione del pacchetto da Gestione pacchetti (fai clic sull'icona o sul nome del pacchetto).

  2. Fai clic su Crea. Una finestra di dialogo richiede la conferma che desideri creare il pacchetto.

    NOTE
    Questo è di particolare importanza quando si sta ricostruendo un pacchetto in quanto il contenuto del pacchetto verrà sovrascritto.

  3. Fai clic su OK. AEM il pacchetto, elencando tutti i contenuti aggiunti al pacchetto così come lo fa. Quando completato AEM visualizza una conferma della generazione del pacchetto e (quando chiudi la finestra di dialogo) aggiorna le informazioni sull’elenco dei pacchetti.

Ritorno a capo di un pacchetto

Una volta costruito un pacchetto, è possibile riavvolgerlo, se necessario.

Il rewrapping modifica le informazioni del pacchetto - senza modifica del contenuto del pacchetto. Le informazioni sul pacchetto sono la miniatura, la descrizione, ecc., in altre parole tutto ciò che è possibile modificare con il Impostazioni pacchetto (per aprire questo clic) Modifica).

Un caso d'uso importante per il ritorno a capo è quando si prepara un pacchetto per la condivisione del pacchetto. Ad esempio, potresti avere un pacchetto esistente e decidere di condividerlo con altri. Per aggiungere una miniatura e una descrizione. Invece di ricreare l'intero pacchetto con tutte le sue funzionalità (che potrebbero richiedere un po' di tempo e correre il rischio che il pacchetto non sia più identico all'originale) puoi racchiuderlo e aggiungere semplicemente la miniatura e la descrizione.

  1. Apri la definizione del pacchetto da Gestione pacchetti (fai clic sull'icona o sul nome del pacchetto).

  2. Fai clic su Modifica e aggiorna Impostazioni pacchetto se necessario. Fai clic su OK da salvare.

  3. Fai clic su Riavvolgere, viene visualizzata una finestra di dialogo che richiede una conferma.

Visualizzazione e modifica delle informazioni sui pacchetti

Per visualizzare o modificare le informazioni sulla definizione di un pacchetto:

  1. In Gestione pacchetti individua il pacchetto da visualizzare.

  2. Fai clic sull’icona del pacchetto che desideri visualizzare. Verrà aperta la pagina del pacchetto in cui sono elencate le informazioni sulla definizione del pacchetto:

    packagesitemclicked-1

    NOTE
    Puoi anche modificare ed eseguire determinate azioni sul pacchetto da questa pagina.
    I pulsanti disponibili dipendono dal fatto che il pacchetto sia già stato creato o meno.

  3. Se il pacchetto è già stato generato, fai clic su Contenuto, viene aperta una finestra in cui sono elencati tutti i contenuti del pacchetto:

Visualizzazione del contenuto del pacchetto e verifica dell’installazione

Dopo aver creato un pacchetto puoi visualizzarne il contenuto:

  1. In Gestione pacchetti individua il pacchetto da visualizzare.

  2. Fai clic sull’icona del pacchetto che desideri visualizzare. Verrà aperta la pagina del pacchetto contenente informazioni sulla definizione del pacchetto.

  3. Per visualizzare il contenuto, fai clic su Contenuto, viene aperta una finestra in cui sono elencati tutti i contenuti del pacchetto:

    contenuto

  4. Per eseguire una prova dell'installazione, fare clic su Installazione di prova. Dopo aver confermato l’azione, viene aperta una finestra in cui sono elencati i risultati come se l’installazione fosse stata eseguita:

    packagestestinstall

Download dei pacchetti nel file system

Questa sezione descrive come scaricare un pacchetto da AEM al file system utilizzando Gestione pacchetti.

NOTE
Vedi Condivisione pacchetti per informazioni sul download di hotfix, feature pack e pacchetti dall'area pubblica e sull'area interna di condivisione dei pacchetti della tua azienda.
Da Condivisione pacchetti puoi:

  • scarica pacchetti da Condivisione pacchetti direttamente nell’istanza AEM locale.
    Al momento del download, il pacchetto viene importato nell’archivio, dopodiché puoi installarlo immediatamente nell’istanza locale utilizzando Gestione pacchetti. Questi pacchetti includono hotfix e altri pacchetti condivisi.

  • scarica pacchetti da Condivisione pacchetti nel file system.

  1. Nella schermata di benvenuto AEM, fai clic su Pacchetti, quindi seleziona Gestione pacchetti.

  2. Passa al pacchetto da scaricare.

    packagesdownload

  3. Fare clic sul collegamento formato dal nome del file zip (sottolineato) per il pacchetto che si desidera scaricare; per esempio export-for-offline.zip.

    AEM scaricare il pacchetto sul computer (utilizzando una finestra di dialogo standard per il download del browser).

Caricamento dei pacchetti dal file system

Il caricamento di un pacchetto consente di caricare un pacchetto dal file system in Gestione pacchetti AEM.

NOTE
Vedi Caricamento dei pacchetti nella condivisione dei pacchetti interna dell'azienda per caricare un pacchetto nell’area privata della tua azienda di Package Share.

Per caricare un pacchetto:

  1. Passa a Gestione pacchetti. Quindi nella cartella del gruppo in cui desideri caricare il pacchetto.

    packagesuploadbutton

  2. Fai clic su Carica pacchetto.

    packagesuploaddialog

    • File

      È possibile digitare direttamente il nome del file oppure utilizzare il Sfoglia… finestra di dialogo per selezionare il pacchetto richiesto dal file system locale (dopo la selezione fare clic su OK).

    • Forza caricamento

      Se esiste già un pacchetto con questo nome, puoi fare clic su di esso per forzare il caricamento (e sovrascrivere il pacchetto esistente).
      Fai clic su OK in modo che il nuovo pacchetto venga caricato ed elencato nell’elenco Gestione pacchetti .

    NOTE
    Per rendere il contenuto disponibile a AEM, assicurati di: installa il pacchetto.

Convalida dei pacchetti

Prima di installare un pacchetto, potrebbe essere utile verificarne il contenuto. Perché i pacchetti possono modificare i file sovrapposti sotto /apps e/o aggiungere, modificare e rimuovere ACL, spesso è utile convalidare queste modifiche prima dell'installazione.

Opzioni di convalida

Il meccanismo di convalida può controllare le seguenti caratteristiche del pacchetto:

  • Importazioni dei pacchetti OSGi
  • Sovrapposizioni
  • ACL

Queste opzioni sono descritte di seguito.

  • Convalida importazioni di pacchetti OSGi

    Elementi controllati

    Questa convalida esamina il pacchetto per tutti i file JAR (bundle OSGi), ne estrae manifest.xml (che contiene le dipendenze con versione su cui si basa il bundle OSGi) e verifica le esportazioni dell'istanza AEM con le versioni corrette.

    Come viene segnalato

    Tutte le dipendenze con versione che non possono essere soddisfatte dall'istanza AEM sono elencate nella Registro attività della Gestione pacchetti.

    Stati di errore

    Se le dipendenze non sono soddisfatte, i bundle OSGi nel pacchetto con quelle dipendenze non si avvieranno. Questo si traduce in un'implementazione non funzionante, in quanto tutto ciò che si basa sul bundle OSGi non avviato non funzionerà a sua volta correttamente.

    Risoluzione degli errori

    Per risolvere gli errori dovuti ai bundle OSGi non soddisfatti, è necessario modificare la versione della dipendenza nel bundle con importazioni non soddisfatte.

  • Convalida sovrapposizioni

    Elementi controllati

    Questa convalida determina se il pacchetto installato contiene un file già sovrapposto nell'istanza AEM di destinazione.

    Ad esempio, se hai impostato una sovrapposizione esistente in /apps/sling/servlet/errorhandler/404.jsp, un pacchetto che contiene /libs/sling/servlet/errorhandler/404.jsp, in modo da modificare il file esistente in /libs/sling/servlet/errorhandler/404.jsp.

    Come viene segnalato

    Tali sovrapposizioni sono descritte nella sezione Registro attività della Gestione pacchetti.

    Stati di errore

    Uno stato di errore indica che il pacchetto sta tentando di distribuire un file già sovrapposto, pertanto le modifiche nel pacchetto verranno sostituite (e quindi "nascoste") dalla sovrapposizione e non avranno effetto.

    Risoluzione degli errori

    Per risolvere questo problema, il gestore del del file di sovrapposizione in /apps deve esaminare le modifiche apportate al file sovrapposto in /libs e incorpora le modifiche necessarie nella sovrapposizione ( /apps) e ridistribuisci il file sovrapposto.

    NOTE
    Il meccanismo di convalida non consente di eseguire la riconciliazione se il contenuto sovrapposto è stato correttamente incorporato nel file di sovrapposizione. Pertanto questa convalida continuerà a segnalare i conflitti anche dopo aver apportato le modifiche necessarie.

  • Convalida ACL

    Elementi controllati

    Questa convalida verifica quali autorizzazioni vengono aggiunte, come verranno gestite (unione/sostituzione) e se le autorizzazioni correnti saranno interessate.

    Come viene segnalato

    Le autorizzazioni sono descritte nella sezione Registro attività della Gestione pacchetti.

    Stati di errore

    Non è possibile fornire errori espliciti. La convalida indica semplicemente se eventuali nuove autorizzazioni ACL verranno aggiunte o influenzate dall'installazione del pacchetto.

    Risoluzione degli errori

    Utilizzando le informazioni fornite dalla convalida, i nodi interessati possono essere rivisti in CRXDE e le ACL possono essere regolate nel pacchetto come necessario.

    CAUTION
    Come best practice, si consiglia di non influenzare gli ACL forniti da AEM, in quanto ciò potrebbe causare un comportamento imprevisto del prodotto.

Esecuzione della convalida

La convalida dei pacchetti può essere eseguita in due modi diversi:

  • Tramite l’interfaccia utente di Gestione pacchetti
  • Tramite richiesta HTTP POST, ad esempio con cURL
NOTE
La convalida deve sempre verificarsi dopo il caricamento del pacchetto ma prima di installarlo.

Convalida del pacchetto tramite Gestione pacchetti

  1. Apri Gestione pacchetti in https://<server>:<port>/crx/packmgr

  2. Seleziona il pacchetto nell’elenco, quindi seleziona Altro dall’intestazione e quindi Convalida dal menu a discesa.

    NOTE
    Questa operazione deve essere eseguita dopo il caricamento del pacchetto di contenuti, ma prima di installare il pacchetto.

  3. Nella finestra di dialogo modale visualizzata, utilizzare le caselle di controllo per selezionare i tipi di convalida e iniziare la convalida facendo clic su Convalida. In alternativa, fai clic su Annulla.

  4. Vengono quindi eseguite le convalide selezionate. I risultati vengono visualizzati nel registro attività di Gestione pacchetti.

Convalida Del Pacchetto Tramite Richiesta HTTP POST

La richiesta di POST si presenta come segue.

https://<host>:<port>/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls
NOTE
La type può essere un qualsiasi elenco non ordinato separato da virgole composto da:
  • osgiPackageImports
  • overlays
  • acls
Il valore di type impostazioni predefinite osgiPackageImports se non è passato.

Di seguito è riportato un esempio di utilizzo di cURL per eseguire una convalida del pacchetto.

  1. Se utilizzi cURL, esegui un’istruzione simile alla seguente:

    curl -v -X POST --user admin:admin -F file=@/Users/SomeGuy/Desktop/core.wcm.components.all-1.1.0.zip 'http://localhost:4502/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls'

  2. La convalida richiesta viene eseguita e la risposta viene inviata nuovamente come oggetto JSON.

NOTE
La risposta a una richiesta HTTP POST di convalida sarà un oggetto JSON con i risultati della convalida.

Installazione dei pacchetti

Dopo aver caricato un pacchetto, devi installare il contenuto. Per avere installato e funzionante il contenuto del pacchetto, è necessario che sia:

  • caricato in AEM (o caricato dal file system o scaricato da Package Share)

  • installato

CAUTION
L’installazione di un pacchetto può sovrascrivere o eliminare il contenuto esistente. Carica un pacchetto solo se sei sicuro che non elimini o sovrascrivi il contenuto necessario.
Per visualizzare il contenuto o l’impatto di un pacchetto puoi:

  • Esegui un'installazione di prova del pacchetto senza modificare nessuno dei contenuti:
    Apri il pacchetto (fai clic sull'icona o sul nome del pacchetto) e fai clic su Test installazione.

  • Vedi un elenco dei contenuti del pacchetto:
    Apri il pacchetto e fai clic su Contenuto.

NOTE
Immediatamente prima dell'installazione del pacchetto, viene creato un pacchetto di snapshot che contiene il contenuto che verrà sovrascritto.
Questa istantanea verrà reinstallata se/quando disinstalli il pacchetto.
CAUTION
Se stai installando risorse digitali, devi:

  • Per prima cosa, disattiva WorkflowLauncher.
    Per disattivare, utilizza l’opzione di menu Componenti della console OSGi com.day.cq.workflow.launcher.impl.WorkflowLauncherImpl.

  • Al termine dell’installazione, riattiva WorkflowLauncher.

La disattivazione di WorkflowLauncher assicura che il framework di Importazione risorse non manipoli (involontariamente) le risorse al momento dell’installazione.

  1. In Gestione pacchetti individua il pacchetto da installare.

    Un Installa viene visualizzato sul lato dei pacchetti non ancora installati.

    NOTE
    In alternativa, puoi aprire il pacchetto facendo clic sulla relativa icona per accedere al Installa pulsante lì.

  2. Fai clic su Installa per avviare l'installazione. Viene visualizzata una finestra di dialogo per richiedere conferma ed elencare tutte le modifiche in corso. Al termine, fai clic su Chiudi nella finestra di dialogo.

    La parola Installato viene visualizzato accanto al pacchetto dopo l'installazione.

Caricamento e installazione basati su file system

Esiste un modo alternativo per caricare e installare i pacchetti nell’istanza. Nel tuo file system hai crx-quicksart accanto al tuo jar e license.properties file. È necessario creare una cartella denominata install sotto crx-quickstart. Avrete quindi qualcosa come questo: <aem_home>/crx-quickstart/install

In questa cartella di installazione, puoi aggiungere direttamente i tuoi pacchetti. Vengono caricati e installati automaticamente nell’istanza. Al termine, puoi visualizzare i pacchetti in Gestione pacchetti.

Se l'istanza è in esecuzione, aggiungi un pacchetto al install avvierà direttamente il caricamento e l’installazione sull’istanza. Se la tua istanza non è in esecuzione, i pacchetti inseriti nella install La cartella verrà installata all'avvio in ordine alfabetico.

NOTE
Puoi anche farlo prima di avviare l’istanza per la prima volta. A questo scopo, devi creare la variabile crx-quickstart creare manualmente la cartella install sotto la cartella e mettere i pacchetti lì. Quindi, quando avvii la tua istanza per la prima volta, i pacchetti verranno installati in ordine alfabetico.

Disinstallazione dei pacchetti

AEM consente di disinstallare i pacchetti. Questa azione ripristina il contenuto dell’archivio interessato allo snapshot effettuato immediatamente prima dell’installazione del pacchetto.

NOTE
Al momento dell’installazione, viene creato un pacchetto di snapshot contenente il contenuto che verrà sovrascritto.
Questo pacchetto verrà reinstallato quando disinstallerai il pacchetto.
  1. In Gestione pacchetti individua il pacchetto da disinstallare.
  2. Fai clic sull'icona del pacchetto da disinstallare.
  3. Fai clic su Disinstalla per rimuovere il contenuto di questo pacchetto dall'archivio. Viene visualizzata una finestra di dialogo per richiedere conferma ed elencare tutte le modifiche in corso. Al termine, fai clic su Chiudi nella finestra di dialogo.

Eliminazione dei pacchetti

Per eliminare un pacchetto dall’elenco Gestione pacchetti:

NOTE
I file/nodi installati dal pacchetto sono not soppresso.

  1. In Strumenti espandi la console Pacchetti per visualizzare il pacchetto nel riquadro di destra.

  2. Fai clic sul pacchetto da eliminare in modo che sia evidenziato e quindi:

    • Fai clic su Elimina nel menu della barra degli strumenti.
    • Fai clic con il pulsante destro del mouse e seleziona Elimina.

    packagesdelete

  3. AEM richiede la conferma di voler eliminare il pacchetto. Fai clic su OK per confermare l’eliminazione.

CAUTION
Se questo pacchetto è già stato installato, il installato il contenuto not essere soppressa.

Replica dei pacchetti

Replicare il contenuto di un pacchetto per installarlo nell'istanza di pubblicazione:

  1. In Gestione pacchetti, individua il pacchetto da replicare.

  2. Fai clic sull’icona o sul nome del pacchetto da replicare per espanderlo.

  3. In Altro menu a discesa sulla barra degli strumenti, seleziona Replicare.

Condivisione pacchetti

Package Share era un server centralizzato reso disponibile pubblicamente per la condivisione di pacchetti di contenuti.

È stato sostituito da Distribuzione di software.

Distribuzione di software

Distribuzione di software è la nuova interfaccia utente progettata per semplificare la ricerca e il download di pacchetti AEM.

Per ulteriori informazioni, consulta la sezione Documentazione sulla distribuzione software.

CAUTION
AEM gestione dei pacchetti non è attualmente utilizzabile con Distribuzione di software. Scarica i pacchetti sul disco locale.
recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8