Installare l'utilità di configurazione perimetrale di Apigee

Edge per Private Cloud v4.18.01

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 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 disabilitare SELinux o impostarlo in modalità permissiva prima di poter installare l'utilità Edge apigee-setup o qualsiasi componente Edge. Se necessario, dopo l'installazione di Edge, puoi riattivare SELinux.

• Per impostare temporaneamente SELinux sulla modalità permissiva, esegui questo comando:
  1. Su un sistema operativo Linux 6.x:
     sudo echo 0 > /selinux/enforce
     
     Per riabilitare SELinux dopo l'installazione di Edge:
     sudo echo 1 > /selinux/enforce
  2. Su un sistema operativo Linux 7.x:
     sudo setenforce 0
     
     Per riabilitare SELinux dopo l'installazione di Edge:
     sudo setenforce 1
• Per disabilitare definitivamente SELinux o impostarlo in modalità permissiva:
  1. Apri /etc/sysconfig/selinux in un editor.
  2. Imposta SELINUX=disattivato o SELINUX=permissivo
  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: 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. Se disponi di una versione successiva, disinstallala e il programma di installazione di Edge installerà la versione 4.8.

Puoi utilizzare il seguente comando per verificare la tua versione:

> rpm -qa | grep libdb4

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

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:

1. 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.
2. Accedi al nodo come root per installare gli RPM Edge
   Nota: sebbene l'installazione RPM richieda l'accesso root, puoi eseguire la configurazione Edge senza accesso root.
3. Installa yum-utils e yum-plugin-priorities:
   > sudo yum install yum-utils
   > sudo yum install yum-plugin-priorities
4. Disabilita SELinux come descritto sopra.
5. Abilita il repository EPEL come descritto sopra.
6. Controlla la tua versione di libdb4 come descritto sopra.
7. Se stai eseguendo l'installazione su Oracle 7.x, esegui questo comando:
   > sudo yum-config-manager --enable ol7_optional_latest
8. 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
9. Scarica il file Edge bootstrap_4.18.01.sh in /tmp/bootstrap_4.18.01.sh:
   > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
10. Installa l'utilità e le dipendenze di Edge apigee-service:
    > sudo bash /tmp/bootstrap_4.18.01.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 controlla se Java 1.8 è 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
    Q = 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*'
11. Utilizza apigee-service per installare l'utilità apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
12. Utilizza apigee-setup per installare e configurare i componenti Edge sul nodo. Per saperne di più, vedi 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.

Nota: Apigee non ospita tutte le dipendenze di terze parti nei nostri repository pubblici. Devi scaricare e installare queste dipendenze da repository accessibili pubblicamente.

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:

1. 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.
2. Accedi al nodo come root per installare gli RPM Edge.
   Nota: sebbene l'installazione RPM richieda l'accesso root, puoi eseguire la configurazione Edge senza accesso root.
3. Disabilita SELinux come descritto sopra.
4. Scarica il file Edge bootstrap_4.18.01.sh in /tmp/bootstrap_4.18.01.sh:
   > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
5. Installa l'utilità e le dipendenze di Edge apigee-service:
   > sudo bash /tmp/bootstrap_4.18.01.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
   
   Nota: se aggiorni un repo esistente a 4.18.01, devi solo aggiornare apigee-mirror:
   > /opt/apigee/apigee-service/apigee-mirror-apigee
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. Hai bisogno di circa 1,6 GB di spazio su disco per il download:
   > /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. Hai bisogno di circa 6 GB di spazio su disco per il download completo:
   > /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.
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.18.01.sh dal repository locale per installare l'utilità apigee-service:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/apigee/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 saperne di più, vedi Installare i componenti Edge su un nodo.

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:

1. Sul nodo con il repository locale, utilizza il seguente comando per pacchettizzare il repository locale in un singolo file .tar denominato /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror pacchetto
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, disabilita SELinux come descritto sopra.
4. Sul nuovo nodo, abilita il repository EPEL come descritto sopra.
5. Sul nuovo nodo, assicurati di aver disabilitato tutti i repository esterni su internet. Quando esegui il comando seguente, tutti i repository esterni dovrebbero essere visualizzati come disabilitati, ma il repository Apigee locale e gli eventuali repository interni dovrebbero essere abilitati:
   > sudo yum repolist
6. Sul nuovo nodo, installa yum-utils e yum-plugin-priorities:
   > sudo yum install yum-utils
   > sudo yum install yum-plugin-priorities
7. Sul nuovo nodo, controlla la tua versione di libdb4 come descritto sopra.
8. Se stai eseguendo 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, annulla iltar del file nella directory /tmp:
    > tar -xzf apigee-4.18.01.tar.gz
    
    Questo comando crea una nuova directory, denominata repository, nella directory contenente il file .tar. Ad esempio /tmp/repos.
11. Installa l'utilità e le dipendenze Edge apigee-service da /tmp/repos:
    > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
    
    Tieni presente che in questo comando includi il percorso della directory repos.
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ù, vedi Installare i componenti Edge su un nodo.

Installa dal repository utilizzando il server web Nginx:

1. Installa il server web Nginx sul nodo repository:
   > opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
2. Per impostazione predefinita, Nginx è configurato in modo da 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 reboot
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, abilita il repository EPEL come descritto sopra.
7. Sul nuovo nodo, controlla la tua versione di libdb4 come descritto sopra.
8. Sul nodo remoto, scarica il file Edge bootstrap_4.18.01.sh in /tmp/bootstrap_4.18.01.sh:
   > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01 il nome utente è remoteRepo:3939/bootstrap_4.18.01. il nome utente è .
   
   
9. Sul nodo remoto, installa l'utilità e le dipendenze di Edge apigee-service:
   > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigee=pWord apigeeprotocol=http://passwordpWord
   
   
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ù, vedi Installare i componenti Edge su un nodo.

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

1. Assicurati di aver installato la versione 4.18.01 dell'utilità apigee-mirror:
   > /opt/apigee/apigee-service/bin/apigee-service versione apigee-mirror
   
   Dovresti vedere un risultato nel modulo di seguito, dove xyz è il numero di build:
   apigee-mirror-4.18.01-0.0.
2. Utilizza l'utilità apigee-mirror per scaricare Edge 4.16.0x/4.17.0x nel repository. Osserva come prefisso il comando con la 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 repos 4.16.0x/4.17.0x specificando i numeri di versione richiesti.
3. Esamina la directory /opt/apigee/data/apigee-mirror/repos per vedere la struttura del file:
   > ls /opt/apigee/data/apigee-mirror/repos
   
   Consulta i seguenti file e directory:
   apigee- apigee-repo-1.0-6.x86_64.rpm bootstrap_4.sh16.
   
   La directory 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 pacchetto
   
   Questo comando raggruppa tutti i repos 4.17.0x e 4.16.0x nello stesso file .tar. Non puoi pacchettizzare solo una parte del repository.