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 ambiente in cui i nodi non dispongono di 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 directory. Tuttavia, se vuoi, puoi creare un link simbolico per mappare /opt/apigee a un'altra posizione. Per saperne di più, consulta i requisiti di installazione.

Prerequisito: disattiva SELinux

Devi disattivare SELinux o impostarlo in modalità permissiva prima di poter installare l'utilità Edge apigee-setup o qualsiasi componente Edge. Se necessario, dopo aver installato Edge, puoi riattivare SELinux.

  • Per impostare temporaneamente SELinux in modalità permissiva, esegui questo comando:
    • Su un sistema operativo Linux 6.x: 
      sudo echo 0 > /selinux/enforce

      Per riattivare SELinux dopo aver installato Edge:

      sudo echo 1 > /selinux/enforce
    • Su un sistema operativo Linux 7.x: 
      sudo setenforce 0

      Per riattivare SELinux dopo aver installato Edge:

      sudo setenforce 1
  • 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 impostare SELINUX=enabled.

Prerequisito: attiva il repository EPEL

Devi attivare Extra Packages for Enterprise Linux (o EPEL) per installare o aggiornare Edge o per creare un repository locale. Il comando che utilizzi dipende dalla tua versione di RedHat/CentOS:

  • Per Red Hat Enterprise Linux (RHEL) 8.0, vedi 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 la versione della libreria libdb4 su RedHat 7.4 e CentOS 7.4

Su RedHat 7.4 e CentOS 7.4, controlla la versione degli RPM libdb4 prima dell'installazione. Edge richiede la versione 4.8 e alcune versioni di RedHat 7.4 e CentOS 7.4 vengono fornite con una versione successiva. Se hai una versione successiva, disinstallala e il programma di installazione di Edge installerà la versione 4.8.

Puoi utilizzare il seguente comando per controllare la tua versione:

rpm -qa | grep libdb4

Se la versione RPM libdb4 è successiva alla 4.8, disinstallala.

Prerequisiti per RHEL 8

Se stai installando Edge su un server che esegue Red Hat Enterprise Linux (RHEL) 8, segui 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. Disattiva Postgres e Nginx: 
    sudo dnf module disable postgresql
sudo dnf module disable nginx
  3. Installa Python 2: 
    sudo dnf install -y python2

Prerequisiti per Amazon Linux 2023(AL2023)

Se stai installando Edge su un server che esegue Amazon-Linux-2023(AL2023), segui questi passaggi prima di eseguire l'installazione: 

USE_CQLUTIL=y

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

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

  1. Ottieni il nome utente e la password di Apigee che utilizzi per accedere al repository Apigee. Se hai già un username:password per il sito FTP di Apigee, puoi utilizzare queste credenziali.
  2. Accedi al nodo come root per installare gli RPM di Edge
  3. Installa yum-utils e yum-plugin-priorities. 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Disattiva SELinux.
  5. Attiva il repository EPEL.
  6. Controlla la tua versione di libdb4.
  7. Se esegui l'installazione su RHEL 8, segui i passaggi descritti in 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 i seguenti 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 bootstrap_4.52.02.sh di Edge in /tmp/bootstrap_4.52.02.sh: 
    curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  11. Installa l'utilità e le dipendenze del servizio apigee di Edge: 
    sudo bash /tmp/bootstrap_4.52.02.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.

    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 l'installazione di Java. JAVA_FIX accetta i seguenti valori:

    • I: Installa OpenJDK 1.8 (predefinito)
    • C: Continua senza installare Java
    • D: Esci. Per questa opzione, devi installare Java autonomamente.

    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. Utilizza 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 saperne di più, 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

La seguente tabella elenca 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à

Testa la 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 non hai installato nc, puoi eseguire il seguente comando telnet:

telnet software.apigee.com 443

Se i comandi vanno a buon fine, puoi utilizzare CTRL+C per interrompere la connessione aperta.

Se uno dei due comandi non va a buon fine, la connettività di rete è limitata o assente. Rivolgiti al tuo 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 seguente comando con il tuo nome utente e la tua password Apigee:

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

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

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

Installa l'utilità apigee-setup su un nodo senza connessione a internet esterna

Se i nodi Edge si trovano dietro un firewall o non possono accedere a internet per qualche altro motivo, devi creare diversi repository o mirror che contengano i file necessari durante l'installazione. Questi mirror devono poi essere accessibili a tutti i nodi. Una volta creati, i nodi possono accedere a questi mirror locali per installare Edge.

La procedura di installazione di Apigee Edge per i nodi senza connessioni a internet richiede l'accesso ai seguenti repository locali:

Crea un repository Apigee locale

Per creare il repository Apigee interno, è necessario un nodo con accesso a internet esterno per poter scaricare gli RPM Edge e le dipendenze. Una volta creato il repository interno, puoi spostarlo in un altro nodo o rendere quest'ultimo accessibile ai nodi edge per l'installazione.

Dopo aver creato un repository Apigee locale, potresti doverlo aggiornare in un secondo momento con i file dell'ultima release di Edge. Le sezioni seguenti descrivono come creare un repository Apigee locale e come aggiornarlo.

Per creare un repository Apigee locale:

  1. Ottieni il nome utente e la password di Apigee che utilizzi per accedere al repository Apigee. Se hai già un nome utente e una password per il sito FTP Apigee, puoi utilizzare queste credenziali.
  2. Accedi al nodo come root per installare gli RPM Edge.
  3. Disattiva SELinux come descritto sopra.
  4. Scarica il file bootstrap_4.52.02.sh di Edge in /tmp/bootstrap_4.52.02.sh: 
    curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  5. Installa l'utilità e le dipendenze del servizio apigee-service Edge: 
    sudo bash /tmp/bootstrap_4.52.02.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.

  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 la directory /opt/apigee/data/apigee-mirror/repos/.

    Per ridurre al minimo le dimensioni del repository, includi --only-new-rpms per scaricare solo gli RPM più recenti.

  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.52.02.sh dal repository locale per installare l'utilità apigee-service: 
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. Utilizza 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. Per maggiori 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, copialo in un nodo e poi installa Edge dal file .tar.
  • Installa un server web sul nodo con il repository locale in modo che gli altri nodi possano accedervi. Apigee fornisce il server web Nginx da utilizzare oppure puoi utilizzare il tuo server web.

Installare dal file .tar

Per installare dal file .tar:

  1. Sul nodo con il repository locale, utilizza il comando seguente per creare il pacchetto del repository locale in un unico file .tar denominato /opt/apigee/data/apigee-mirror/apigee-4.52.02.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 nella directory /tmp sul nuovo nodo.
  3. Sul nuovo nodo, disattiva SELinux come descritto sopra.
  4. Nel nuovo nodo, assicurati di poter accedere al repository dell'utilità Yum locale e al repository EPEL.
  5. Verifica che tutti i repository internet esterni siano disattivati (dovrebbe essere così perché l'installazione viene eseguita su una macchina senza accesso a internet): 
    sudo yum repolist

    Tutti i repository esterni devono essere disattivati, ma il repository Apigee locale e i repository interni devono essere attivati.

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

    Il tuo team operativo o un altro gruppo all'interno della tua organizzazione deve configurare un repository locale per consentirti di installare gli strumenti Yum.

  7. Nel 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 comando yum-configure-manager: 
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. Sul nuovo nodo, decomprimi il file nella directory /tmp: 
    tar -xzf apigee-4.52.02.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 del servizio apigee di Edge da /tmp/repos: 
    sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Tieni presente che in questo comando includi il percorso della directory dei repository.

  12. Utilizza 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.

Installare dal repository utilizzando il server web Nginx

Per installare dal 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 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 in base alle tue esigenze: 
      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, disattiva SELinux come descritto sopra.
  6. Sul nuovo nodo, assicurati che il repository EPEL locale sia abilitato.
  7. Nel nuovo nodo, controlla la tua versione di libdb4 come descritto sopra.
  8. Sul nodo remoto, scarica il file Edge bootstrap_4.52.02.sh in /tmp/bootstrap_4.52.02.sh: 
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

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

  9. Sul nodo remoto, installa l'utilità e le dipendenze di Edge apigee-service: 
    sudo bash /tmp/bootstrap_4.52.02.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, devi scaricare l'ultimo file bootstrap_4.52.02.sh e poi eseguire una nuova sincronizzazione.

Per aggiornare il repository:

  1. Scarica il file Edge bootstrap_4.52.02.sh in /tmp/bootstrap_4.52.02.sh: 
    curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  2. Esegui il file bootstrap_4.52.02.sh di Edge: 
    sudo bash/tmp/bootstrap_4.52.02.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. Aggiornamento 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 l'intero repository: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Pulire 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.52.02

Se devi gestire le installazioni per Edge 4.16.0x o 4.17.0x in un repository 4.52.02, puoi gestire un repository che contenga tutte le versioni. Da questo repository puoi installare qualsiasi versione di Edge.

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

  1. Assicurati di aver installato la versione 4.52.02 dell'utilità apigee-mirror: 
    /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.52.02-0.0.xyz
  2. Utilizza l'utilità apigee-mirror per scaricare Edge 4.16.0x/4.17.0x nel tuo repository. Nota come il comando è preceduto dalla versione desiderata: 
    apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Utilizza lo stesso comando per aggiornare in un secondo momento i repository 4.16.0x/4.17.0x specificando i numeri di versione richiesti.

  3. Esamina la directory /opt/apigee/data/apigee-mirror/repos per visualizzare la struttura dei file: 
    ls /opt/apigee/data/apigee-mirror/repos

    Dovresti visualizzare i seguenti file e directory:

    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 hai un file bootstrap per tutte le versioni di Edge. La directory apigee contiene anche directory separate per ogni versione di Edge.

  4. Per comprimere 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 comprime tutti i repository 4.17.0x e 4.16.0x nello stesso file .tar. Non puoi creare pacchetti solo per una parte del repository.

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

  • Se l'installazione viene eseguita da un file .tar, esegui il file 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" qui sopra.

  • Se l'installazione viene eseguita utilizzando il server web Nginx, scarica ed esegui il file 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 "Installazione dal repository utilizzando il server web Nginx" riportata sopra.