Esegui l'upgrade del portale

Questa procedura descrive come eseguire l'upgrade di un portale esistente Apigee Developer Services (o semplicemente il portale) on-premise dell'installazione.

di Gemini Advanced.

Determinare la procedura di aggiornamento corretta

La procedura che utilizzi per aggiornare il portale si basa sull'installazione corrente:

Determina il tipo di installazione attuale

Se hai dubbi sul tipo di installazione attuale, usa il comando seguente per determinare Questo:

  • ls /opt

    Se utilizzi NGINX/Postgres, vedrai le seguenti directory: /opt/apigee e /opt/nginx.

    Se utilizzi Apache/MySQL o Apache/MariaDB, queste directory non devono essere presenti.

  • /opt/apigee/apigee-service/bin/apigee-all status

    Se utilizzi NGINX/Postgres, l'output sarà il seguente:

    + apigee-service
apigee-drupal-devportal status
OK: apigee-drupal-devportal is up and running
+ apigee-service apigee-lb status
apigee-service: apigee-lb: OK
+ apigee-service apigee-postgresql status
apigee-service: apigee-postgresql: OK
     
  • apachectl -S

    Se usi Apache/MySQL o Apache/MariaDB, questo comando dovrebbe restituire directory root del portale, nel formato:

    *:80
192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)

Directory di installazione predefinita

Il processo di upgrade presuppone che il portale sia stato installato all'indirizzo:

  • 4.17.05 e versioni successive: /opt/apigee/apigee-drupal/wwwroot
  • Prima della versione 4.17.05: /opt/apigee/apigee-drupal (NGINX) o /var/www/html (Apache)

Se non hai installato il portale nella directory predefinita, modifica i percorsi nella procedura di seguito per utilizzare la directory di installazione.

Versioni di upgrade supportate

Questa procedura di upgrade è supportata sulle versioni del portale OPDK-17-01.x e successive.

Per determinare la versione del tuo portale, apri il seguente URL in un browser:

http://yourportal.com/buildInfo

Prima di eseguire l'aggiornamento

Per le installazioni esistenti, se hai modificato un qualsiasi codice nel core Drupal o in qualsiasi moduli, le modifiche verranno sovrascritte. Sono incluse, tra le altre cose, eventuali modifiche che potresti aver inviato a .htaccess. Dovresti presumere che tutti gli elementi esterni alla directory /sites siano di proprietà di Drupal. Un l'eccezione a questa regola è robots.txt; se questo file esiste nella directory radice web, verranno conservati.

Prima di procedere con l'installazione, esegui un backup dell'intera directory radice web di Drupal . Dopo aver eseguito la procedura di installazione descritta di seguito, puoi ripristinare personalizzazioni dal backup.

Eseguire l'upgrade di un portale usando gli RPM

Per aggiornare l'RPM del portale su un nodo:

  1. Passa alla directory Drupal, /opt/apigee/apigee-drupal per impostazione predefinita: 
    cd /opt/apigee/apigee-drupal
  2. Esegui il backup dell'istanza del database Drupal. Il comando pg_dump crea una copia database: 
    pg_dump --dbname=devportal --host=host_IP_address --username=drupaladmin
  --password --format=c > /tmp/portal.dmp

    Dove:

    • devportal è il nome del database come specificato dal Proprietà PG_NAME nel file di configurazione dell'installazione del portale.
    • host_IP_address è l'indirizzo IP del nodo del portale.
    • drupaladmin è il nome utente Postgres utilizzato dal portale per accedere come specificato dalla proprietà DRUPAL_PG_USER nell'installazione del portale di configurazione del deployment.

    Ti viene chiesta la password utente di Postgres, come definito Proprietà DRUPAL_PG_PASS nel file di configurazione dell'installazione del portale.

    Se in un secondo momento vuoi eseguire il ripristino dal backup, utilizza il seguente comando:

    pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp
  3. Esegui un backup dell'intera directory root web di Drupal. Il percorso di installazione predefinito è /opt/apigee/apigee-drupal, ma potresti averlo modificato.

    Se non conosci con esattezza la posizione di questa directory, usa il comando drush status o Configurazione > Media > Voce File nel menu Drupal per determinare la posizione del file system pubblico e il percorso del file system privato (per le passaggio).

  4. Esegui un backup dei file in /opt/apigee/data/apigee-drupal-devportal/private.
  5. Imposta Drupal in modalità di manutenzione:
    1. Seleziona Configuration (Configurazione) nel menu Drupal.
    2. Nella pagina Configurazione, seleziona Modalità di manutenzione. in Sviluppo.
    3. Seleziona la casella Attiva la modalità di manutenzione del sito.
    4. Inserisci un messaggio che gli utenti visualizzeranno durante la manutenzione.
    5. Seleziona Salva configurazione.
  6. Disabilita SELinux come descritto in Installa l'utilità apigee-setup Edge.
  7. Passa alla directory /opt: 
    cd /opt
  8. Per un upgrade su un server con una connessione a internet:
      .
    1. Scarica il file Edge 4.51.00 bootstrap_4.51.00.sh su /tmp/bootstrap_4.51.00.sh: 
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
    2. Installa l'utilità e le dipendenze Edge 4.51.00 apigee-service: 
      sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

      Dove uName e pWord sono il nome utente e la password che hai ricevuto di Apigee. Se ometti pWord, ti verrà chiesto di inserirlo.

      Per impostazione predefinita, il programma di installazione verifica che sia installato Java 1.8. Puoi utilizzare lo "C" per continuare senza installare Java.

  9. Per un upgrade su un server senza connessione a internet:
      .
    1. Crea un repository 4.51.00 locale come descritto in Crea un repository Apigee locale.
    2. Per installare apigee-service da un file .tar:
        .
      1. Sul nodo con il repository locale, utilizza il comando seguente per pacchettizzare il repository locale repository in un singolo file .tar denominato /opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
      2. Copia il file .tar nel nodo in cui vuoi aggiornare Edge. Ad esempio, copialo alla directory /tmp sul nuovo nodo.
      3. Sul nuovo nodo, sposta il file nella directory /tmp: 
        tar -xzf apigee-4.51.00.tar.gz

        Questo comando crea una nuova directory, denominata repository, nella directory contenente il file . ad esempio /tmp/repos.

      4. Installa l'utilità e le dipendenze Edge apigee-service da /tmp/repos: 
        sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        Nota che in questo comando viene incluso il percorso della directory dei repository.

    3. Per installare apigee-service utilizzando il server web NGINX:
        .
      1. Configura il server web NGINX come descritto in "Eseguire l'installazione dal repository utilizzando server web NGINX" alla pagina Installare Edge Utilità apigee-setup.
      2. Sul nodo remoto, scarica il file Edge bootstrap_4.51.00.sh su /tmp/bootstrap_4.51.00.sh: 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh
  -o /tmp/bootstrap_4.51.00.sh

        Dove uName e pWord sono il nome utente e la password che hai impostato qui sopra per il repository e remoteRepo è l'indirizzo IP o il nome DNS del il nodo repo.

      3. Sul nodo remoto, installa l'utilità Edge apigee-service e delle dipendenze: 
        sudo bash /tmp/bootstrap_4.51.00.sh apigeerepohost=remoteRepo:3939
  apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        Dove uName e pWord sono il nome utente e la password del repository.

  10. Usa apigee-service per aggiornare l'utilità apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Esegui l'utilità update sul tuo nodo Postgres: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    Dove configFile è il file di configurazione che hai utilizzato per installare il database Postgres. L'unico requisito del file di configurazione è che il file deve essere accessibile o leggibile da "apigee" utente.