DocumentazioneCommerceChannel Manager Guide

Installa Channel Manager

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Amministratore
  • Sviluppatore

Rivedi i requisiti e raccogli le informazioni richieste prima di installare Channel Manager.

Installare l’estensione

Le istruzioni di installazione di Channel Manager dipendono dall’implementazione di Adobe Commerce o del Magento Open Source on-premise o dall’infrastruttura cloud.

Entrambi i metodi richiedono l'utilizzo dell'interfaccia CLI (Command Line Interface).

NOTE
Per informazioni sull'installazione del software Commerce tramite CLI, vedere Installare un'estensione.

Eseguire l’installazione in un’istanza locale

Utilizzare queste istruzioni per installare Channel Manager in Adobe Commerce e per eseguire il Magento Open Source a un'istanza locale.

  1. Accedere al server Commerce come utente con autorizzazioni per scrivere nel file system Commerce.

  2. Imposta il tuo sito Web in modalità di manutenzione.

    code language-bash 
    $ bin/magento maintenance:enable

  3. Dalla directory principale del progetto Commerce, aggiungere Channel Manager a composer.json.

    code language-bash 
     composer require magento/channel-manager --no-update

  4. Se richiesto, immettere le chiavi di accesso dall'account Commerce.

    La chiave pubblica è il nome utente; la chiave privata è la password.

  5. Aggiorna le dipendenze e installa l’estensione.

    code language-bash 
    composer update magento/channel-manager

    Il comando composer update aggiorna solo le dipendenze richieste per Channel Manager. Per aggiornare tutte le dipendenze, utilizzare questo comando: composer update.

  6. Attendi che Composer completi l'aggiornamento delle dipendenze del progetto e risolva eventuali errori.

  7. Verificare l'installazione del modulo:

    • Controlla lo stato del modulo.

      code language-bash 
      bin/magento module:status Magento_SalesChannels

      Risposta di esempio:

      code language-none 
      Module is enabled

    • Se il modulo non è abilitato, attivalo.

    code language-bash 
    bin/magento module:enable Magento_SalesChannels

  8. Registra l'estensione.

    code language-bash 
    bin/magento setup:upgrade

  9. Se richiesto, ricompilare il progetto Commerce.

    code language-bash 
    bin/magento setup:di:compile

  10. Pulire la cache.

    code language-bash 
    bin/magento cache:clean

  11. Disattiva la modalità di manutenzione.

    code language-bash 
    bin/magento maintenance:disable

Eseguire l’installazione in un’istanza di Adobe Commerce on Cloud Infrastructure

Lavora in un ramo di sviluppo quando aggiungi un’estensione all’istanza cloud.

Per informazioni sull'utilizzo dei rami, vedere Introduzione alla creazione di rami nella Guida di Commerce sull'infrastruttura cloud.

Durante l'installazione, il nome dell'estensione (magento\channel-manager) viene inserito automaticamente nel file app/etc/config.php. Non è necessario modificare direttamente il file.

  1. Nella workstation locale, passa alla directory principale del progetto Cloud.

  2. Crea o estrai un ramo di sviluppo.

  3. Utilizzando il nome del Compositore, aggiungere l'estensione alla sezione require del file composer.json.

    code language-bash 
    composer require magento/module-sales-channels-extension --no-update

  4. Aggiorna le dipendenze e installa l’estensione.

    code language-bash 
    composer update magento/module-sales-channels-extension

    Il comando composer update aggiorna solo le dipendenze richieste per Channel Manager. Per aggiornare tutte le dipendenze, utilizzare questo comando: composer update.

  5. Aggiungere, eseguire il commit e inviare le modifiche al codice; includere le modifiche al file composer.lock e al file composer.json.

    code language-bash 
    $ git add -A
    code language-bash 
    $ git commit -m "Install channel manager extension"
    code language-bash 
    $ git push origin <branch-name>

  6. Al termine del processo di build e distribuzione, utilizza SSH per accedere all’ambiente remoto e verificare che l’estensione sia installata correttamente.

   bin/magento module:status Magento_SalesChannels

Risposta di esempio:

Module is enabled

Se il modulo è disabilitato, abilitarlo nell'ambiente locale e distribuire le modifiche.

  1. Dopo aver installato l'estensione, accedere a Admin per configurare Commerce Services Connector.

    note note
    NOTE
    Per istruzioni su come aggiornare Channel Manager a una nuova versione, consulta Aggiornare moduli ed estensioni.

Risoluzione dei problemi

Utilizzare le informazioni seguenti per risolvere gli errori che si verificano durante il processo di installazione di Channel Manager.

Tasti composizione errati

Se le chiavi di accesso utilizzate per l'autenticazione nell'archivio del Compositore non sono valide o non sono collegate alle MAGE ID utilizzate per la registrazione al servizio Channel Manager, viene visualizzato il seguente errore.

Could not find a matching version of package magento/channel-manager. Check the package spelling, your version constraint and that the package is available in a stability which matches your minimum-stability (stable).

Controlla la configurazione della chiave:

  1. Trovare il percorso del file auth.json:

    code language-bash 
    $ composer config –global home

  2. Visualizza il file auth.json.

    code language-bash 
    $ cat /path/to/auth.json

  3. Verificare che le credenziali nel file auth.json corrispondano alle chiavi associate all'ID MAGE utilizzato per la registrazione al servizio Channel Manager.

Memoria insufficiente per PHP

Se il sistema non dispone di memoria sufficiente per PHP, viene visualizzato il seguente errore.

Fatal error: Allowed memory size of 2146435072 bytes exhausted (tried to allocate 4096 bytes) in phar:///usr/local/bin/composer/src/Composer/DependencyResolver/RuleWatchGraph.php on line 52

Per risolvere il problema di memoria, utilizzare uno dei metodi seguenti:

  • Aumentare il limite di memoria per PHP nel file dell'ambiente php.ini. Verificare inoltre che l'istanza di Commerce disponga dei valori consigliati per altre impostazioni PHP.

  • Specificare il limite di memoria dalla riga di comando.

    code language-bash 
    $ php -d memory_limit=-1 \[path to composer]/composer require magento/payment-services.

    Ad esempio:

    code language-bash 
    $ php-d memory_limit=-1 vendor/bin/composer require magento/channel-manager

Vista mancante

Se durante l'installazione di Channel Manager viene visualizzato un errore relativo a process_catalog_exporter_view mancante, provare ad aggiornare gli indicizzatori.

php bin/magento indexer:refresh

Errori di distribuzione cloud

Per i problemi relativi alla distribuzione dell'estensione nel cloud, vedere errore di distribuzione dell'estensione.

recommendation-more-help
83c0fcbf-cb46-4844-88e1-421bcdd63f9d