Installare l'utilità di configurazione perimetrale di Apigee

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 a in 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 dispositivo Edge componenti. Se necessario, dopo l'installazione di Edge, puoi riattivare SELinux.

  • Per impostare temporaneamente SELinux in modalità permissiva, esegui il seguente comando:
    • In un sistema operativo Linux 8.x:
      sudo setenforce 0

      Per riattivare SELinux dopo l'installazione di Edge:

      sudo setenforce 1
    • In un sistema operativo Linux 7.x:
      sudo setenforce 0

      Per riattivare SELinux dopo l'installazione di Edge:

      sudo setenforce 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
  • Per disattivare definitivamente SELinux o impostarlo in 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 Red Hat Enterprise Linux (RHEL) 8.0, consultate Prerequisiti per RHEL 8.

  • Per Red Hat/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 Red Hat/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
  • Per AWS-2:
    sudo amazon-linux-extras install epel -y
    sudo yum-config-manager --enable epel

Prerequisito: controlla libdb4 libreria su RedHat 7.4 e CentOS 7.4

Su RedHat 7.4 e CentOS 7.4, controlla la versione degli libdb4 RPM 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 di libdb4 è successiva alla 4.8, disinstalla li annotino.

Prerequisiti per RHEL 8

Se installi Edge su un server che esegue Red Hat Enterprise Linux (RHEL) 8, procedi nel seguente modo: i seguenti passaggi prima di eseguire l'installazione:

  1. Attiva Extra Packages for Enterprise Linux (EPEL):
    sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
  2. Disabilita Postgres e NGINX:
    sudo dnf module disable postgresql
    sudo dnf module disable nginx
  3. Installa Python 2 e crea un link simbolico:
    sudo dnf install -y python2
    sudo ln -s /usr/bin/python2 /usr/bin/python

Installa l'utilità apigee-setup Edge su un nodo con una rete internet esterna connessione

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à un username:password per il sito ftp di Apigee, puoi usarli e credenziali.
  2. Accedi al tuo nodo come root per installare gli RPM perimetrali
  3. Installa yum-utils e yum-plugin-priorities:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  4. Disattiva SELinux.
  5. Abilita il repository EPEL.
  6. Controllare la versione di libdb4.
  7. Se esegui l'installazione su RHEL 8, segui i passaggi nella Prerequisiti per RHEL 8.
  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 quanto segue Comandi yum-configure-manager:
    yum update rh-amazon-rhui-client.noarch
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. Scarica il file Edge bootstrap_4.51.00.sh in /tmp/bootstrap_4.51.00.sh:
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  11. Installa l'utilità e le dipendenze di apigee-service Edge:
    sudo bash /tmp/bootstrap_4.51.00.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 (predefinito)
    • 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:

    cat /etc/yum.repos.d/apigee.repo

    Per visualizzare i contenuti del repository, utilizza il comando:

    sudo yum -v repolist 'apigee*'
  12. Usa apigee-service per installare l'utilità apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. Utilizza apigee-setup per installare e configurare i componenti Edge sul nodo. Per ulteriori informazioni, consulta Installare i componenti Edge su un nodo.

Risoluzione dei problemi

Quando tenti di eseguire l'installazione su un nodo con una connessione a internet esterna, potresti riscontrare uno o più dei seguenti errori:

Cannot open: https:// : @ software.apigee.com//apigee-repo-version.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

Nella tabella seguente sono elencate alcune possibili soluzioni per questi errori:

Tipo di errore Possibile risoluzione
La password contiene caratteri non validi Non utilizzare caratteri speciali nella password Apigee.
Problemi di connettività

Verifica la tua connettività di rete eseguendo questo comando: ncat :

nc -v software.apigee.com 443

Dovresti ricevere un messaggio simile al seguente:

Connection to software.apigee.com 443 port [tcp/https] succeeded!

Se nc non è installato, puoi eseguire il seguente telnet comando:

telnet software.apigee.com 443

Se i comandi hanno esito positivo, puoi utilizzare CTRL+C per interrompere la connessione aperta.

Se uno dei comandi non va a buon fine, la connettività di rete è limitata o non è presente. Verifica con l'amministratore di rete.

Credenziali non corrette

Assicurati che il nome utente e la password siano corretti.

Ad esempio, controlla se ricevi un errore quando provi a utilizzare il comando seguente con il tuo nome utente e la tua password Apigee:

curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
Problemi relativi al proxy La tua configurazione locale utilizza un proxy HTTP in uscita e non hai esteso la stessa configurazione al gestore dei pacchetti yum. Controlla le variabili di ambiente:
echo $http_proxy
echo $https_proxy

Per un proxy HTTP in uscita, devi utilizzare una delle seguenti opzioni:

  • Aggiungi una configurazione proxy HTTP in /etc/yum.conf
  • Aggiungi la configurazione del proxy HTTP globale in /etc/environment

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 Internet, devi creare diversi repository, o mirror, contenenti file durante l'installazione. Questi mirror devono quindi essere accessibili a tutti i nodi. Una volta creati, i nodi possono accedere a questi mirror locali per installare Edge.

Il processo di installazione di Apigee Edge per i nodi senza connessione a internet richiede l'accesso a i seguenti repository locali:

Crea un repository Apigee locale

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.

Dopo aver creato un repository Apigee locale, in un secondo momento potrebbe essere necessario aggiornarlo con i file della release Edge più recenti. Le sezioni seguenti descrivono come creare un repository Apigee locale come aggiornarlo.

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.
  3. Disabilita SELinux come descritto sopra.
  4. Scarica il file Edge bootstrap_4.51.00.sh in /tmp/bootstrap_4.51.00.sh:
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  5. Installa l'utilità apigee-service di Edge e le dipendenze:
    sudo bash /tmp/bootstrap_4.51.00.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 l'utilità apigee-mirror sul nodo:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  7. Utilizza l'utilità apigee-mirror per sincronizzare il repository Apigee con Directory /opt/apigee/data/apigee-mirror/repos/.

    Per ridurre al minimo le dimensioni del repository, includi --only-new-rpms per scaricare solo RPM più recenti. Per il download è necessario 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, incluse le RPM precedenti, ometti --only-new-rpms. Per il download completo sono necessari circa 6 GB di spazio su disco:

    /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 dal repository locale.

  8. (Facoltativo) Se vuoi installare Edge dal repository locale sullo stesso nodo che ospita il repository locale, devi prima eseguire i seguenti comandi:
    1. Esegui bootstrap_4.51.00.sh dal repository locale per installare Utilità apigee-service:
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. Usa apigee-service per installare l'utilità apigee-setup:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. Utilizza apigee-setup per installare e configurare i componenti Edge sul nodo. Consulta Per ulteriori informazioni, installa 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, copialo in un nodo e installa Edge dal 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

Per eseguire l'installazione 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.51.00.tar.gz:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. Copia il file .tar nel nodo in cui vuoi installare Edge. Ad esempio, copialo Directory /tmp sul nuovo nodo.
  3. Sul nuovo nodo, disabilita SELinux come descritto sopra.
  4. Sul nuovo nodo, assicurati di poter accedere al repository dell'utilità locale Yum e all'EPEL un repository.
  5. Verifica che tutti i repository esterni di internet siano disattivati (dovrebbe essere così perché stai eseguendo l'installazione su un computer senza accesso a internet):
    sudo yum repolist

    Tutti i repository esterni devono essere disabilitati, ma il repository Apigee locale e i repository interni deve essere abilitato.

  6. Sul nuovo nodo, installa yum-utils e yum-plugin-priorities da nel repository locale:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities

    Il team operativo o un altro gruppo all'interno dell'organizzazione deve configurare un repository locale per installare gli strumenti Yum.

  7. Sul nuovo nodo, controlla la tua versione di libdb4 come descritto sopra.
  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 il seguente yum-configure-manager comando:
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. Sul nuovo nodo, sposta il file nella directory /tmp:
    tar -xzf apigee-4.51.00.tar.gz

    Questo comando crea una nuova directory denominata repos nella directory contenente il file .tar. Ad esempio /tmp/repos.

  11. Installa l'utilità e le dipendenze di apigee-service Edge 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.

  12. Usa apigee-service per installare l'utilità apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. Utilizza apigee-setup per installare e configurare i componenti Edge sul nodo. Consulta Per ulteriori informazioni, installa i componenti Edge su un nodo.

Installa dal repository utilizzando il server web NGINX

Per installare il repository utilizzando il server web NGINX:

  1. Installa il server web NGINX sul nodo del repository:
    opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. Per impostazione predefinita, NGINX è configurato per utilizzare localhost come nome del server e la porta 3939. Per modificare questi valori:
    1. Apri /opt/apigee/customer/application/mirror.properties in un editor. Crea il file se non esiste.
    2. Imposta i seguenti valori, se necessario:
      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost
    3. Riavvia NGINX:
      /opt/nginx/scripts/apigee-nginx restart
  3. Per impostazione predefinita, il repository richiede un nome utente: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 install yum-utils
    sudo yum install yum-plugin-priorities
  5. Sul nuovo nodo, disabilita SELinux come descritto sopra.
  6. Sul nuovo nodo, assicurati che il repository EPEL locale sia abilitato.
  7. Sul nuovo nodo, controlla la tua versione di libdb4 come descritto sopra.
  8. Sul nodo remoto, scarica il file Edge bootstrap_4.51.00.sh in /tmp/bootstrap_4.51.00.sh:
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh

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

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

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

  10. Sul nodo remoto, utilizza apigee-service per installare l'utilità apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  11. Utilizza apigee-setup per installare e configurare i componenti Edge sul nodo remoto. Per saperne di più, consulta Installare i componenti Edge su un nodo.

Aggiorna un repository Apigee locale

Per aggiornare il repository, è necessario scaricare l'ultimo file bootstrap_4.51.00.sh e quindi eseguire una nuova sincronizzazione.

Per aggiornare il repository:

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

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

  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.51.00

Se devi mantenere le installazioni per Edge 4.16.0x o 4.17.0x in un repository 4.51.00, 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.51.00:

  1. Assicurati di aver installato la versione 4.51.00 dell'apigee-mirror utility:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

    Dovresti vedere un risultato nel modulo seguente, dove xyz è il numero di build:

    apigee-mirror-4.51.00-0.0.xyz
  2. Usa 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 la directory /opt/apigee/data/apigee-mirror/repos per visualizzare il file struttura:
    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
    bootstrap_4.18.05.sh
    bootstrap_4.19.01.sh
    thirdparty

    Nota che esiste un file di bootstrap per tutte le versioni di Edge. apigee contiene anche directory separate 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 apigee-mirror package

    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 con 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 descritti in "Installa dal repository utilizzando il server web NGINX" sopra.