Per installare Edge su un nodo, devi prima installare l'utilità apigee-setup di Edge. Se ti trovi in un ambiente in cui i tuoi 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 ulteriori informazioni, consulta la sezione Requisiti di installazione.
Prerequisito: disattiva SELinux
Devi disattivare SELinux o impostarlo in modalità permissiva prima di poter installare l'utilità apigee-setup
di Edge o eventuali componenti di Edge. Se necessario, dopo aver installato Edge puoi riattivare SELinux.
- Apri
/etc/sysconfig/selinux
in un editor. - Imposta
SELINUX=disabled
oSELINUX=permissive
- Salva le modifiche.
- Riavvia il nodo.
- Se necessario, riattiva SELinux dopo l'installazione di Edge ripetendo questa procedura per impostare
SELINUX=enabled
.
Prerequisito: attiva il repository EPEL
Devi abilitare Pacchetti aggiuntivi per Enterprise Linux (o EPEL) per installare o aggiornare Edge oppure per creare un repository locale. Il comando da utilizzare dipende dalla versione di RedHat/CentOS:
- Per Red Hat/CentOS/Oracle 8.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo rpm -ivh epel-release-latest-8.noarch.rpm
- Per Red Hat/CentOS/Oracle 9.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm
- Attiva Extra Packages for
Enterprise Linux (EPEL):
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
- Disattiva Postgres e Nginx:
sudo dnf module disable postgresql
sudo dnf module disable nginx
- Attiva Extra Packages for Enterprise Linux (EPEL):
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
- Disattiva Postgres e Nginx:
sudo dnf module disable postgresql
sudo dnf module disable nginx
- Ottieni 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 utilizzare queste credenziali.
- Accedi al tuo nodo come utente root per installare gli RPM di Edge
- Disabilita SELinux.
- Attiva il repository EPEL.
- Se esegui l'installazione su RHEL 9/Rocky 9/Oracle 9, segui i passaggi descritti in Prerequisiti per RHEL 9/Rocky 9/Oracle 9.
- Scarica il file
bootstrap_4.53.00.sh
di Edge in/tmp/bootstrap_4.53.00.sh
:curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- Installa l'utilità e le dipendenze del servizio apigee-service Edge:
sudo bash /tmp/bootstrap_4.53.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.
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
può assumere i seguenti valori:- I: installa OpenJDK 1.8 (valore 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*'
- Usa apigee-service per installare l'utilità apigee-setup:
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Utilizza apigee-setup per installare e configurare i componenti Edge sul nodo. Per ulteriori informazioni, consulta Installare i componenti Edge su un nodo.
- Aggiungere una configurazione del proxy HTTP in
/etc/yum.conf
- Aggiungi la configurazione del proxy HTTP globale in
/etc/environment
- Repository Apigee Edge: come descritto in Creare un repository Apigee locale.
- Pacchetti extra per Enterprise Linux (o EPEL): il team di operazioni dovrebbe essere in grado di configurarli per te.
- Ottieni da Apigee il nome utente e la password che utilizzi per accedere al repository Apigee. Se hai già un nome utente:password per il sito ftp di Apigee, puoi utilizzare queste credenziali.
- Accedi al tuo nodo come utente root per installare gli RPM di Edge.
- Disattiva SELinux come descritto sopra.
- Scarica il file
bootstrap_4.53.00.sh
di Edge in/tmp/bootstrap_4.53.00.sh
:curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- Installa l'utilità apigee-service di Edge e le dipendenze:
sudo bash /tmp/bootstrap_4.53.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.
- Installa l'utilità
apigee-mirror
sul nodo:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
- 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 le RPM più recenti. -
(Facoltativo) Se vuoi installare Edge dal repository locale sullo stesso nodo che ospita il repository locale, devi prima eseguire i comandi seguenti:
- Esegui
bootstrap_4.53.00.sh
dal repository locale per installare l'utilitàapigee-service
:sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
- Usa
apigee-service
per installare l'utilitàapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Utilizza
apigee-setup
per installare e configurare i componenti Edge sul nodo. Per saperne di più, consulta Installare i componenti Edge su un nodo.
- Esegui
- 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 gli altri nodi possano accedervi. Apigee fornisce il server web Nginx da utilizzare oppure puoi utilizzare il tuo server web.
- Sul nodo con il repository locale, utilizza il comando seguente per pacchettizzare il repository locale in un
singolo file .tar denominato
/opt/apigee/data/apigee-mirror/apigee-4.53.00.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Copia il file .tar nel nodo in cui vuoi installare Edge. Ad esempio, copialo nella directory
/tmp
del nuovo nodo. - Sul nuovo nodo, disattiva SELinux come descritto sopra.
- Sul nuovo nodo, assicurati di poter accedere al repository dell'utilità locale Yum e al repository EPEL.
- Verifica che tutti i repository di 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 dovrebbero essere disabilitati, ma il repository Apigee locale e i tuoi repository interni dovrebbero essere abilitati.
- Utilizza
apigee-service
per installare l'utilitàapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Utilizza
apigee-setup
per installare e configurare i componenti Edge sul nodo. Per ulteriori informazioni, consulta Installare i componenti Edge su un nodo. - Installa il server web Nginx sul nodo del repository:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
- Per impostazione predefinita, Nginx è configurato per utilizzare localhost come nome del server e la porta 3939. Per
modificare questi valori:
- Apri
/opt/apigee/customer/application/mirror.properties
in un editor. Crea il file se non esiste. - Imposta i seguenti valori in base alle esigenze:
conf_apigee_mirror_listen_port=3939 conf_apigee_mirror_server_name=localhost
- Riavvia Nginx:
/opt/nginx/scripts/apigee-nginx restart
- Apri
- 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
- Sul nuovo nodo, assicurati che il repository EPEL sia abilitato localmente.
- Sul nuovo nodo, controlla la tua versione di
libdb4
come descritto sopra. - Sul nodo remoto, installa l'utilità
apigee-service
di Edge e le dipendenze:sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
Dove uName:pWord sono il nome utente e la password del repository.
- Sul nodo remoto, utilizza
apigee-service
per installare l'utilitàapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 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. - Scarica il file bootstrap_4.53.00.sh di Edge in
/tmp/bootstrap_4.53.00.sh
:curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- Esegui il file
bootstrap_4.53.00.sh
di Edge:sudo bash/tmp/bootstrap_4.53.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.
- Aggiornamento
apigee-mirror
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
- Esegui la sincronizzazione:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
- Se vuoi eseguire l'intero repo:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
Prerequisiti per RHEL 8/Rocky 8/Oracle 8
Se stai installando Edge su un server che esegue Red Hat Enterprise Linux (RHEL) 8, segui i passaggi riportati di seguito prima di eseguire l'installazione:
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:
Per le modifiche di preinstallazione di PostgreSQL e LDAP, consulta rispettivamente i Requisiti di preinstallazione del database PostgreSQL e le modifiche di preinstallazione di OpenLDAP 2.4.
Installa l'utilità apigee-setup di Edge su un nodo con una connessione internet esterna
Per installare Edge su un nodo con una connessione a internet esterna:
Risoluzione dei problemi
Quando provi a 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 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à | Verifica la connettività di rete eseguendo questo 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 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 non è presente. Rivolgiti al tuo amministratore di rete. |
Credenziali errate | 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 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
Per un proxy HTTP in uscita, devi utilizzare una delle seguenti opzioni: |
Installa l'utilità apigee-setup Edge su un nodo senza connessione a internet esterna
Se i nodi Edge sono protetti da un firewall o in altri modi non possono accedere a internet, devi creare diversi repository, o mirror, contenenti i file di cui avrai bisogno 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 connessioni a internet richiede l'accesso ai seguenti repository locali:
Crea un repository Apigee locale
Per creare il repository Apigee interno, hai bisogno di un nodo con accesso esterno a internet per poter scaricare gli RPM e le dipendenze perimetrali. Dopo aver creato il repo interno, puoi spostarlo su un altro nodo o renderlo accessibile ai nodi Edge per l'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 e come aggiornarlo.
Per creare un repository Apigee locale:
Installa apigee-setup su un nodo remoto dal repository locale
Hai due opzioni per installare Edge dal repository locale. Puoi:
Installazione dal file .tar
Per l'installazione dal file .tar:
Installa dal repository utilizzando il server web Nginx
Per installare il repository utilizzando il server web Nginx:
Aggiornare un repository Apigee locale
Per aggiornare il repository, devi scaricare il file bootstrap_4.53.00.sh più recente, quindi eseguire una nuova sincronizzazione.
Per aggiornare il repository:
Ripulire 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