Installare l'utilità di configurazione perimetrale di Apigee

Edge per Private Cloud v4.18.01

Per installare Edge su un nodo, devi prima installare l'utilità apigee-setup di Edge. Se ti trovi in un in cui i nodi non hanno una connessione a internet esterna, devi installare anche una copia locale del repository Apigee.

Directory di installazione predefinita: /opt/apigee

Edge installa tutti i file nella directory /opt/apigee. Non puoi modificare questa impostazione . Tuttavia, se vuoi, puoi creare un link simbolico per mappare /opt/apigee su un'altra posizione. Per ulteriori informazioni, consulta la sezione Requisiti di installazione.

Prerequisito: Disattiva SELinux

Devi disabilitare SELinux o impostarlo in modalità permissiva prima di poter installare Edge Utilità apigee-setup o qualsiasi Edge componenti. Se necessario, dopo l'installazione di Edge, puoi riabilitare SELinux.

  • Per impostare temporaneamente SELinux sulla modalità permissiva, esegui il comando seguente :
      .
    1. In un sistema operativo Linux 6.x:
      sudo echo 0 > /selinux/enforce

      Per riattivare SELinux dopo l'installazione di Edge:
      sudo echo 1 > /selinux/enforce
    2. In un sistema operativo Linux 7.x:
      sudo setenforce 0

      Per riattivare SELinux dopo l'installazione di Edge:
      sudo setenforce 1
  • Per disabilitare definitivamente SELinux o impostarlo sulla modalità permissiva:
      .
    1. Apri /etc/sysconfig/selinux in un editor.
    2. Imposta SELINUX=disabled o SELINUX=permissive
    3. Salva le modifiche.
    4. Riavvia il nodo.
    5. Se necessario, riattiva SELinux dopo l'installazione di Edge ripetendo questa procedura per imposta SELINUX=enabled.

Prerequisito: Abilita il repository EPEL

Devi attivare Pacchetti aggiuntivi per Enterprise Linux (o EPEL) per installare o aggiornare Edge oppure per creare un repository locale. La dipende dalla tua versione di RedHat/CentOS:

  • Per RedHat/CentOS/Oracle 7.x:?
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; sudo rpm -ivh epel-release-latest-7.noarch.rpm
  • Per RedHat/CentOS/Oracle 6.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; sudo rpm -ivh epel-release-latest-6.noarch.rpm

Prerequisito: controlla libdb4 libreria su RedHat 7.4 e CentOS 7.4

Su RedHat 7.4 e CentOS 7.4, controlla la versione degli RPM libdb4 prima di eseguire l'installazione. Dispositivi periferici richiede la versione 4.8 e alcune versioni di RedHat 7.4 e CentOS 7.4 dispongono di un una versione più recente. Se hai una versione successiva, disinstallala e il programma di installazione di Edge quindi installa la versione 4.8.

Per verificare la versione, puoi usare il comando seguente:

> rpm -qa | grep libdb4

Se noti che la versione RPM libdb4 è successiva alla versione 4.8, disinstallarlo.

Installa Edge Utilità apigee-setup su un nodo con una connessione a internet esterna

Per installare Edge su un nodo con una connessione a internet esterna:

  1. Recupera da Apigee il nome utente e la password che utilizzi per accedere al repository Apigee. Se hai già una password nomeutente:password per il sito ftp di Apigee, puoi utilizzare quelle e credenziali.
  2. Accedi al tuo nodo come root per installare gli RPM perimetrali
    Nota: anche se l'installazione di RPM richiede l'accesso root, puoi eseguire Edge configurazione senza accesso root.
  3. Installa yum-utils e yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. Disabilita SELinux come descritto sopra.
  5. Attiva il repository EPEL come descritto sopra.
  6. Controlla la tua versione di libdb4 come descritto sopra.
  7. Se esegui l'installazione su Oracle 7.x,esegui questo comando:
    > sudo yum-config-manager --enable ol7_optional_latest
  8. Se esegui l'installazione su AWS, esegui questi comandi yum-configure-manager:
    > aggiornamento gnam rh-amazon-rhui-client.noarch
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  9. Scarica il file Edge bootstrap_4.18.01.sh in /tmp/bootstrap_4.18.01.sh:
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  10. Installa l'utilità e le dipendenze apigee-service Edge:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

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

    Per impostazione predefinita, il programma di installazione verifica che sia installato Java 1.8. In caso contrario, lo installa per te. Utilizza l'opzione JAVA_FIX per specificare come gestire Installazione di Java. JAVA_FIX assume i seguenti valori:

    I = Installa OpenJDK 1.8 (impostazione predefinita)
    C = Continua senza installare Java
    D = Esci. Per questa opzione, devi installare Java personalmente.

    L'installazione dell'utilità apigee-service crea il file /etc/yum.repos.d/apigee.repo che definisce il repository Apigee. Per visualizzare il file di definizione, utilizza il comando:
    > gatto /etc/yum.repos.d/apigee.repo

    Per visualizzare i contenuti del repository, utilizza il comando:
    > sudo yum -v repolist 'apigee*'
  11. Usa apigee-service per installare l'utilità apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  12. Utilizza apigee-setup per installare e configurare i componenti Edge sul nodo. Per ulteriori informazioni, consulta Installare i componenti Edge su un nodo.

Installa Edge Utilità apigee-setup su un nodo senza connessione a internet esterna

Se i nodi Edge sono protetti da un firewall o in qualche altro modo non possono accedere al repository Apigee su internet, occorre creare un repository locale, del repository Apigee. che deve quindi essere accessibile a tutti i nodi. Una volta creati, i nodi potrà quindi accedere al mirroring locale per installare Edge.

Per creare il repository Apigee interno, hai bisogno di un nodo con una connessione internet esterna per poter scaricare gli RPM perimetrali e le dipendenze. Una volta creato il cluster interno un repository, puoi spostarlo in un altro nodo o renderlo accessibile ai nodi periferici dell'installazione.

Nota: Apigee non ospita tutte le dipendenze di terze parti nel pubblico repository. Devi scaricare e installare queste dipendenze da un accesso pubblico repository.

Dopo aver creato un repository Edge locale, in un secondo momento potresti dover aggiornarlo con la versione File di release Edge. Le sezioni seguenti descrivono come creare un repository locale e come aggiornalo.

Crea un repository Apigee locale

Per creare un repository Apigee locale:

  1. Recupera da Apigee il nome utente e la password che utilizzi per accedere al repository Apigee. Se hai già una password nomeutente:password per il sito ftp di Apigee, puoi utilizzare quelle e credenziali.
  2. Accedi al tuo nodo come root per installare gli RPM perimetrali.
    Nota: anche se l'installazione di RPM richiede l'accesso root, puoi eseguire Edge configurazione senza accesso root.
  3. Disabilita SELinux come descritto sopra.
  4. Scarica il file Edge bootstrap_4.18.01.sh in /tmp/bootstrap_4.18.01.sh:
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  5. Installa l'utilità e le dipendenze apigee-service Edge:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    dove uName:pWord sono il nome utente e la password che hai ricevuto Apigee. Se ometti pWord, ti verrà chiesto di inserirlo.
  6. Installa apigee-mirror sul nodo:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

    Nota: se stai aggiornando un repository esistente alla versione 4.18.01, devi solo aggiornare apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  7. Usa l'apigee-mirror per sincronizzare il repository Apigee con /opt/apigee/data/apigee-mirror/repos/ .

    Per ridurre al minimo le dimensioni del repository, includi --only-new-rpms per scaricare solo la versione più recente RPM Per il download sono necessari circa 1,6 GB di spazio su disco:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Se vuoi scaricare l'intero repository, inclusi gli RPM meno recenti, ometti --only-new-rpms. Ti servono circa 6 GB di spazio su disco per il download completo:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

    Ora hai una copia locale del repository Apigee. Nella sezione successiva viene descritto come installare Utilità Edge apigee-setup da il repository locale.
  8. (Facoltativo) Se vuoi installare Edge dal repository locale sullo stesso che ospita il repository locale, devi prima eseguire questi comandi:
      .
    1. Esegui bootstrap_4.18.01.sh dal file locale repository per installare l'utilità apigee-service:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. Usa apigee-service per installa apigee-setup utilità:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. Usa apigee-setup per installare e configurare i componenti Edge sul nodo. Per ulteriori informazioni, consulta Installare i componenti Edge su un nodo.

Installa apigee-setup su un nodo remoto dal repository locale

Hai due opzioni per installare Edge dal repository locale. Puoi:

  • Crea un file .tar del repository, copia il file .tar su un nodo, quindi installa Edge da il file .tar.
  • Installa un server web sul nodo con il repository locale in modo che altri nodi possano accedervi. Apigee ti fornisce il server web Nginx oppure puoi utilizzare server web.

Installa dal file .tar:

  1. Sul nodo con il repository locale, utilizza il comando seguente per pacchettizzare il repository locale in singolo file .tar denominato /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror
  2. Copia il file .tar nel nodo in cui vuoi installare Edge. Ad esempio, copialo /tmp nella nuova nodo.
  3. Sul nuovo nodo, disabilita SELinux come descritto sopra.
  4. Sul nuovo nodo, abilita il repository EPEL come descritto sopra.
  5. Sul nuovo nodo, assicurati di aver disabilitato eventuali repository internet esterni. Quando esegui questo comando, tutti i repository esterni dovrebbero risultare disabilitati ma dovrebbero essere abilitati il repository Apigee locale e tutti i tuoi repository interni:
    > sudo gnam repolist
  6. Sul nuovo nodo, installa yum-utils e yum-plugin-priorities:
    > sudo yum installa yum-utils
    > sudo yum install yum-plugin-priorities
  7. Sul nuovo nodo, controlla la tua versione di libdb4 come descritto in alto.
  8. Se esegui l'installazione su Oracle 7.x,esegui questo comando:
    > sudo yum-config-manager --enable ol7_optional_latest
  9. Se esegui l'installazione su AWS, esegui questo comando yum-configure-manager:
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-facoltativo
  10. Sul nuovo nodo, sposta il file nella directory /tmp:
    > tar -xzf apigee-4.18.01.tar.gz

    Questo comando crea una nuova directory, repository denominati, nella directory contenente il file .tar. Ad esempio: /tmp/repos.
  11. Installa l'utilità apigee-service Edge e le dipendenze da /tmp/repos:
    > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Nota che in questo comando viene incluso il percorso della directory dei repository.
  12. Usa apigee-service per installa apigee-setup utilità:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. Usa apigee-setup per installare e configurare i componenti Edge sul nodo. Per ulteriori informazioni, consulta Installare i componenti Edge su un nodo.

Installa dal repository utilizzando il server web Nginx:

  1. Installa il server web Nginx sul nodo repository:
    > opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. Per impostazione predefinita, Nginx è configurato in modo da utilizzare localhost come nome del server e porta 3939. A modifica questi valori
    1. Apri /opt/apigee/customer/application/mirror.properties in un editor. Crea il file se non esiste.
    2. Imposta i seguenti valori in base alle esigenze:
      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost
    3. Riavvia Nginx:
      ?> /opt/nginx/scripts/apigee-nginx riavvio
  3. Per impostazione predefinita, il repository richiede un valore nomeutente:password di admin:admin. Per modificare queste credenziali, imposta le seguenti variabili di ambiente:
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. Sul nuovo nodo, installa yum-utils e yum-plugin-priorities:
    > sudo yum installa yum-utils
    > sudo yum install yum-plugin-priorities
  5. Sul nuovo nodo, disabilita SELinux come descritto sopra.
  6. Sul nuovo nodo, abilita il repository EPEL come descritto sopra.
  7. Sul nuovo nodo, controlla la tua versione di libdb4 come descritto in alto.
  8. Sul nodo remoto, scarica il file Edge bootstrap_4.18.01.sh in /tmp/bootstrap_4.18.01.sh:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh

    dove uName:pWord sono il nome utente e la password che hai impostato sopra mentre remoteRepo è l'indirizzo IP o il nome DNS del repository nodo.
  9. Sul nodo remoto, installa l'utilità e le dipendenze di apigee-service Edge:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    dove uName:pWord sono il nome utente del repository password.
  10. Sul nodo remoto, utilizza apigee-service per installare l'utilità apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  11. Usa apigee-setup per installare e configurare i componenti Edge sul nodo remoto. Per ulteriori informazioni, consulta Installare i componenti Edge su un nodo.

Aggiorna un repository Apigee locale

Per aggiornare il repository, è necessario scaricare l'ultimo file bootstrap_4.18.01.sh, quindi eseguire un nuovo sysnc:

  1. Scarica il file bootstrap_4.18.01.sh di Edge in /tmp/bootstrap_4.18.01.sh:
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  2. Esegui il file bootstrap_4.18.01.sh Edge:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    dove uName:pWord sono il nome utente e la password ricevute da Apigee. Se ometti pWord, ti verrà chiesto di: inseriscilo.
  3. Aggiorna apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  4. Esegui la sincronizzazione:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  5. Se vuoi eseguire l'intero repository:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Pulisci un repository Apigee locale

La pulizia del repository locale elimina /opt/apigee/data/apigee-mirror e /var/tmp/yum-apigee-*.

Per pulire il repository locale, utilizza:

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

Aggiungere o aggiornare Edge 4.16.0x/4.17.0x in un repository 4.18.01

Se devi mantenere le installazioni per Edge 4.16.0x o 4.17.0x in un repository 4.18.01, puoi un repository che contiene tutte le versioni. Da quel repository potrai installare qualsiasi versione di perimetrali.

Per aggiungere 4.16.0x/4.17.0x a un repository 4.18.01:

  1. Assicurati di aver installato la versione 4.18.01 dell'utilità apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror versione

    Dovresti vedere un risultato nel modulo seguente, dove xyz è la build numero:
    apigee-mirror-4.18.01-0.0.xyz
  2. Usa l'apigee-mirror utility per scaricare Edge 4.16.0x/4.17.0x nel repository. Nota come aggiungi il prefisso al comando la versione desiderata:
    > apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Usa lo stesso comando per aggiornare successivamente i repository 4.16.0x/4.17.0x specificando numeri di versione.
  3. Esamina /opt/apigee/data/apigee-mirror/repos per vedere la struttura del file:
    > ls /opt/apigee/data/apigee-mirror/repos

    Dovresti vedere i file e le directory seguenti:
    apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.sh bootstrap_4.17.01.sh bootstrap_4.17.05.sh bootstrap_4.17.09.sh bootstrap_4.18.01.sh di terze parti

    Nota che esiste un file di bootstrap per tutte le versioni di Edge. La directory apigee contiene anche file per ogni versione di Edge.
  4. Per pacchettizzare il repository in un file .tar, utilizza il seguente comando:
    > apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service Pacchetto apigee-mirror

    Questo comando pacchettizza tutti i repository 4.17.0x e 4.16.0x nello stesso file .tar. Non puoi solo una parte del repository.

Per installare Edge dal repository locale o dal file .tar, assicurati di eseguire il bootstrap corretto utilizzando uno dei seguenti comandi. Questo esempio installa Edge 4.17.01:

  • Se esegui l'installazione da un file .tar, esegui il file di bootstrap corretto dal repository:
    > sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Per completare l'installazione, segui i passaggi rimanenti della sezione "Installazione dal file .tar" in alto.
  • Se l'installazione avviene utilizzando il server web Nginx, scarica ed esegui il file di bootstrap corretto dal repository:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
    > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://


    Per completare l'installazione, segui i passaggi rimanenti della sezione "Eseguire l'installazione dal repository utilizzando server web NGINX in alto.