Installare l'utilità di configurazione perimetrale di Apigee

Per installare Edge su un nodo, devi prima installare l'utilità di configurazione di Edge apigee-setup. Se ti trovi in un ambiente in cui i nodi non hanno una connessione a internet esterna, devi anche installare 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 lo desideri, puoi creare un collegamento simbolico per mappare /opt/apigee a un'altra località. Per saperne di più, consulta Requisiti di installazione.

Prerequisito: disattivare SELinux

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

  • Per disattivare in modo permanente 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: attivare il repository EPEL

    Per installare o aggiornare Edge o per creare un repository locale, devi attivare Extra Packages for Enterprise Linux (o EPEL). Per Red Hat Enterprise Linux (RHEL) 9.x, Rocky Linux 9.x o Oracle Linux 9.x, esegui i seguenti comandi:

    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm

    Prerequisito per RHEL 9/Rocky 9/Oracle 9

    Se stai installando Edge su un server che esegue Red Hat Enterprise Linux (RHEL) 9, Rocky 9 o Oracle 9, completa 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-9.noarch.rpm
    2. Disattiva Postgres e Nginx: 
      sudo dnf module disable postgresql
sudo dnf module disable nginx

    Per le modifiche di preinstallazione per PostgreSQL e LDAP, consulta Requisiti di preinstallazione del database PostgreSQL e Modifiche di preinstallazione di SymasLDAP 2.6.10, rispettivamente.

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

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

    1. Ottieni il nome utente e la password da 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. Disattiva SELinux.
    4. Attiva il repository EPEL.
    5. Se stai eseguendo l'installazione su RHEL 9/Rocky 9/Oracle 9, segui i passaggi descritti in Prerequisiti per RHEL 9/Rocky 9/Oracle 9.
    6. Scarica il file bootstrap_4.54.00.sh di Edge in /tmp/bootstrap_4.54.00.sh: 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    7. Installa l'utilità apigee-service di Edge e le dipendenze: 
      sudo bash /tmp/bootstrap_4.54.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 inserirla.

      Apigee Edge for Private Cloud 4.54.00 richiede il supporto duale di Java con Java 17 e Java 21 installati sul nodo. Prima di eseguire lo script di bootstrap, devi installare sia Java 17 che Java 21. Il programma di installazione verifica solo che entrambe le versioni di JDK siano installate; non installa Java automaticamente.

      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*'
    8. Utilizza apigee-service per installare l'utilità apigee-setup:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    9. Utilizza apigee-setup per installare e configurare i componenti di Edge sul nodo. Per saperne di più, consulta Installare i componenti di 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://username@software.apigee.com/apigee-repo-4.53.00.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

    La tabella seguente elenca alcune possibili soluzioni per questi errori:

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

    Verifica la connettività di rete eseguendo il seguente ncat comando:

    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 telnet comando:

    telnet software.apigee.com 443

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

    Se uno dei comandi non va a buon fine, la connettività di rete è limitata o inesistente. Rivolgiti all'amministratore di rete.
    Credenziali errate

    Assicurati che il nome utente e la password siano corretti.

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

    curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
    Problemi del proxy La configurazione locale utilizza un proxy HTTP in 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 in 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

    Installare l'utilità di configurazione di Edge apigee-setup su un nodo senza connessione a internet esterna

    Se i nodi Edge si trovano dietro un firewall o in qualche modo non possono accedere a internet, devi creare diversi repository o mirror che contengano i file necessari durante l'installazione. Questi mirror devono 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 connessione a internet richiede l'accesso a seguenti repository locali:

    Creare un repository Apigee locale

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

    Dopo aver creato un repository Apigee locale, potresti doverlo aggiornare in un secondo momento con i file della release di Edge più recente. 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 da Apigee che utilizzi per accedere al repository Apigee. Se hai già un nome utente:password per il sito FTP di Apigee, puoi utilizzare queste credenziali.
    2. Accedi al nodo come root per installare gli RPM di Edge.
    3. Disattiva SELinux come descritto sopra.
    4. Scarica il file bootstrap_4.54.00.sh di Edge in /tmp/bootstrap_4.54.00.sh: 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    5. Installa l'utilità apigee-service di Edge e le dipendenze: 
      sudo bash /tmp/bootstrap_4.54.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 inserirla.

    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.54.00.sh dal repository locale per installare l' apigee-service utilità: 
        sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.00.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 di Edge sul nodo. Per saperne di più, consulta Installare i componenti di Edge su un nodo.

    Installare 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 e poi installa Edge da il file .tar.
    • Installa un server web sul nodo con il repository locale in modo che 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 seguente comando per comprimere il repository locale in un unico file .tar denominato /opt/apigee/data/apigee-mirror/apigee-4.54.00.tar.gz: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Copia il file .tar sul nodo in cui vuoi installare Edge. Ad esempio, copialo nella /tmp directory del nuovo nodo.
    3. Sul nuovo nodo, disattiva SELinux come descritto sopra.
    4. Sul nuovo nodo, assicurati di poter accedere al repository dell'utilità Yum locale e al repository EPEL repo.
    5. Verifica che tutti i repository internet esterni siano disattivati (dovrebbe essere così perché stai eseguendo l'installazione 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. Utilizza apigee-service per installare l'utilità apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    7. Utilizza apigee-setup per installare e configurare i componenti di Edge sul nodo. Per saperne di più, consulta Installare i componenti di 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 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 in base alle 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 admin:admin. Per modificare queste credenziali, imposta le seguenti variabili di ambiente: 
      MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
    4. Sul nuovo nodo, assicurati che il repository EPEL sia attivato localmente.
    5. Sul nuovo nodo, controlla la versione di libdb4 come descritto sopra.
    6. Sul nodo remoto, installa l'utilità apigee-service di Edge e le dipendenze: 
      sudo bash /tmp/bootstrap_4.54.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

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

    Aggiornare un repository Apigee locale

    Per aggiornare il repository, devi scaricare il file bootstrap_4.54.00.sh più recente ed eseguire una nuova sincronizzazione.

    Per aggiornare il repository:

    1. Scarica il file bootstrap_4.54.00.sh di Edge in /tmp/bootstrap_4.54.00.sh: 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    2. Esegui il file bootstrap_4.54.00.sh di Edge: 
      sudo bash/tmp/bootstrap_4.54.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 inserirla.

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