Edge per Private Cloud v. 4.17.09
Per installare Edge su un nodo, devi prima installare l'utilità Edge apigee-setup. Se ti trovi in un ambiente 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 presenti 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 i requisiti di installazione.
Prerequisiti: disabilitazione di SELinux
Devi disattivare SELinux o impostarlo in modalità permissiva prima di poter installare l'utilità apigee-setup
Edge o qualsiasi componente Edge. Se necessario, dopo l'installazione di 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 l'installazione di Edge:
> sudo echo 1 > /selinux/enforce
- Su un sistema operativo Linux 7.x:
> sudo setenforce 0
Per riattivare SELinux dopo l'installazione di Edge:
> sudo setenforce 1
- Su un sistema operativo Linux 6.x:
- Per disabilitare definitivamente SELinux o impostarlo in modalità permissiva:
- 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
.
- Apri
Prerequisito: attivazione del repository EPEL
Devi abilitare Extra Packages for 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 in uso:
- 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: verifica 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 di installarla. Edge richiede la versione 4.8 e alcune versioni di RedHat 7.4 e CentOS 7.4 vengono fornite con una versione successiva.
Puoi utilizzare il seguente comando per verificare la tua versione:
> rpm -qa | grep libdb
Se noti che la versione RPM di libdb4
è successiva alla versione 4.8, utilizza il seguente comando per sostituire gli RPM:
> rpm -Uvh --oldpackage libdb4-cxx-4.8.30-13.el7.x86_64.rpm libdb4-4.8.30-13.el7.x86_64.rpm
Se devi scaricare questi RPM, puoi ottenerli da:
- http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-cxx-4.8.30-13.el7.x86_64.rpm
- http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-4.8.30-13.el7.x86_64.rpm
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 a internet esterna:
- 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 nodo come root per installare gli RPM Edge
- Installa
yum-utils
eyum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- Disabilita SELinux come descritto sopra.
- Abilita il repository EPEL come descritto sopra.
- Se l'installazione avviene su AWS, esegui il seguente comando
yum-configure-manager
:> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- Scarica il file di Edge
bootstrap_4.17.09.sh
su/tmp/bootstrap_4.17.09.sh
:> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- Installa l'utilità e le dipendenze apigee-service Edge:
> sudo bash /tmp/bootstrap_4.17.09.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 Java 1.8 sia installato. Se non lo fai, lo installa. Utilizza l'opzione
JAVA_FIX
per specificare come gestire l'installazione 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*'
- 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 saperne di più, consulta Installare i componenti Edge su un nodo.
Installa l'utilità Edge apigee-setup su un nodo senza connessione a internet esterna
Se i nodi perimetrali sono protetti da un firewall o in qualche altro modo non possono accedere al repository Apigee su internet, devi creare un repository locale, o mirroring, del repository Apigee. Quel mirror deve essere accessibile a tutti i nodi. Una volta creati, i nodi possono accedere al mirror locale per installare Edge.
Per creare il repository Apigee interno, hai bisogno di un nodo con accesso a internet esterno per poter scaricare gli RPM e le dipendenze perimetrali. Dopo aver creato il repository interno, puoi spostarlo in un altro nodo o renderlo accessibile ai nodi Edge per l'installazione.
Dopo aver creato un repository Edge locale, potresti dover aggiornarlo con i file di release Edge più recenti. Le seguenti sezioni descrivono come creare un repository locale e come aggiornarlo.
Crea un repository Apigee locale
Per creare un repository Apigee locale:
- 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 nodo come root per installare gli RPM Edge.
- Installa
yum-utils
eyum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- Disabilita SELinux come descritto sopra.
- Abilita il repository EPEL come descritto sopra.
- 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
- Scarica il file di Edge
bootstrap_4.17.09.sh
su/tmp/bootstrap_4.17.09.sh
:> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- Installa l'utilità e le dipendenze Edge
apigee-service
:> sudo bash /tmp/bootstrap_4.17.09.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 gli RPM più recenti. 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
. 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. La sezione successiva descrive come installare l'utilità Edge
apigee-setup
dal repository locale. -
(Facoltativo) Se vuoi installare Edge dal repository locale sullo stesso nodo che ospita il repository locale, devi prima eseguire i seguenti comandi:
- Esegui
bootstrap_4.17.09.sh
dal repository locale per installare l'utilitàapigee-service
:> sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
- 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 saperne di più, consulta Installare i componenti Edge su un nodo.
- Esegui
Installa apigee-setup su un nodo remoto dal repository locale
Hai a disposizione 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 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 da utilizzare oppure puoi utilizzare il tuo server web personale.
Installa dal file .tar:
- 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.17.09.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
sul nuovo nodo. - Installa
yum-utils
eyum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- Sul nuovo nodo, disabilita SELinux come descritto sopra.
- Abilita il repository EPEL come descritto sopra.
- Sul nuovo nodo, annulla iltar del file nella directory /tmp:
> tar -xzf apigee-4.17.09.tar.gz
Questo comando crea una nuova directory, denominata repository, nella directory contenente il file .tar. Ad esempio
/tmp/repos.
- Installa l'utilità e le dipendenze Edge apigee-service da
/tmp/repos
:> sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Tieni presente che in questo comando includi il percorso della directory repository.
- 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 saperne di più, consulta Installare i componenti Edge su un nodo.
Installa dal repository utilizzando il server web Nginx:
- Installa il server web Nginx sul nodo del repository:
> opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
- Per impostazione predefinita, Nginx è configurato in modo da 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
- Installa
yum-utils
eyum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- Sul nuovo nodo, disabilita SELinux come descritto sopra.
- Abilita il repository EPEL come descritto sopra.
- Sul nodo remoto, scarica il file Edge bootstrap_4.17.09.sh in
/tmp/bootstrap_4.17.09.sh
:> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
dove uName:pWord sono il nome utente e la password che hai impostato in precedenza per il repository e remoteRepo è l'indirizzo IP o il nome DNS del nodo del repository.
- Sul nodo remoto, installa l'utilità e le dipendenze Edge
apigee-service
:> sudo bash /tmp/bootstrap_4.17.09.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.
Aggiorna un repository Apigee locale
Per aggiornare il repository, devi scaricare il file bootstrap_4.17.09.sh più recente, quindi eseguire una nuova sincronizzazione:
- Scarica il file Edge bootstrap_4.17.09.sh su
/tmp/bootstrap_4.17.09.sh
:> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- Esegui il file Edge
bootstrap_4.17.09.sh
:> sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
dove uName:pWord sono il nome utente e la password ricevuti da Apigee. Se ometti pWord, ti verrà chiesto di inserirlo.
- Aggiorna
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 scaricare 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
Aggiungi o aggiorna Edge 4.16.0x/4.17.0x in un repository 4.17.09
Se devi mantenere le installazioni per Edge 4.16.0x o 4.17.01/4.17.05 in un repository 4.17.09, puoi mantenere un repository che contenga tutte le versioni. Da quel repository, potrai quindi installare qualsiasi versione di Edge.
Per aggiungere 4.16.0x/4.17.0x a un repository 4.17.09:
- Assicurati di aver installato la versione 4.17.09 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 della build:
apigee-mirror-4.17.09-0.0.xyz
- Utilizza l'utilità
apigee-mirror
per scaricare Edge 4.16.0x/4.17.01/4.17/05 nel repository. Osserva come il comando deve precedere la versione desiderata:> apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
Utilizza questo stesso comando per aggiornare in un secondo momento i repository 4.16.0x/4.17.05 specificando i numeri di versione richiesti.
- Esamina la directory
/opt/apigee/data/apigee-mirror/repos
per vedere la struttura del file:> ls /opt/apigee/data/apigee-mirror/repos
Dovresti vedere 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 thirdparty
Osserva come è disponibile un file di bootstrap per tutte le versioni di Edge. La directory
apigee
contiene anche directory separate per ogni versione di Edge. - 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 pacchettizzare solo una parte del repository.
Per installare Edge dal repository locale o dal file .tar, assicurati di eseguire il file di bootstrap corretto utilizzando uno dei seguenti comandi. Questo esempio installa Edge 4.17.01:
- Se l'installazione avviene 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 "Installare dal file .tar" qui sopra.
- Se esegui l'installazione 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 "Installazione dal repository utilizzando il server web Nginx" qui sopra.