Installare l'utilità di configurazione perimetrale di Apigee

Edge per Private Cloud v. 4.17.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:
     echo 0 > /selinux/enforce
     
     Per riabilitare SELinux dopo l'installazione di Edge:
     echo 1 > /selinux/enforce
  2. Su un sistema operativo Linux 7.x:
     setenforce 0
     
     Per riabilitare SELinux dopo l'installazione di Edge:
     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. Il comando da utilizzare dipende dalla versione di RedHat/CentOS in uso:

• Per RedHat/CentOS 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 6.x:
  > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; sudo rpm -ivh epel-release-latest-6.noarch.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:

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. Abilita il repository EPEL come descritto sopra.
5. Scarica il file Edge bootstrap_4.17.01.sh in /tmp/bootstrap_4.17.01.sh:
   > curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
6. Installa l'utilità e le dipendenze di Edge apigee-service:
   > sudo bash /tmp/bootstrap_4.17.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*'
7. (solo CentOS-6.x e RedHat-6.x) Su tutti i nodi Qpid, esegui questo comando per assicurarti di scaricare la versione di Qpid corretta:
   > yum install apigee-qpidd --disablerepo=epel
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 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 RedHat o CentOS 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. Assicurati di avere l'ultima versione di yum-utils:
   > sudo yum update yum-utils
4. Disabilita SELinux come descritto sopra.
5. Abilita il repository EPEL come descritto sopra.
6. Scarica il file Edge bootstrap_4.17.01.sh in /tmp/bootstrap_4.17.01.sh:
   > curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
7. (Solo CentOS-6.x e RedHat-6.x) Esegui il comando seguente per assicurarti di scaricare la versione di Qpid corretta:
   > yum install apigee-qpidd --disablerepo=epel
8. Installa l'utilità e le dipendenze di Edge apigee-service:
   > sudo bash /tmp/bootstrap_4.17.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.
9. 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.17.01, devi solo aggiornare apigee-mirror:
   > /opt/apigee/apigee-service/apigee-mirror-apigee
10. 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.
11. (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.17.01.sh dal repository locale per installare l'utilità apigee-service:
       > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.01.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 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.17.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, annulla iltar del file nella directory /tmp:
   > tar -xzf apigee-4.17.01.tar.gz
   
   Questo comando crea una nuova directory, denominata repository, nella directory contenente il file .tar. Ad esempio /tmp/repos.
5. Installa l'utilità e le dipendenze apigee-service Edge da /tmp/repos:
   > sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
   
   Tieni presente che in questo comando includi il percorso della directory repos.
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 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 riavvio
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, disabilita SELinux come descritto sopra.
5. Sul nodo remoto, scarica il file Edge bootstrap_4.17.01.sh in /tmp/bootstrap_4.17.01.sh:
   > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01. il nome utente è il nome di .
   
   
6. Sul nodo remoto, installa l'utilità e le dipendenze Edge apigee-service:
   > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigee=pWord apigeeprotocol=http://pWord
   
   
7. Sul nodo remoto, utilizza apigee-service per installare l'utilità apigee-setup:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
8. 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.17.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.17.01-0.0.
2. Utilizza l'utilità apigee-mirror per scaricare Edge 4.16.01/4.16.05/4.16.09 nel repository. Osserva come prefisso il comando apigeereleasever=4.16.01 o apigeereleasever=4.16.05:
   > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms obbligatorio da susp.
   
   
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.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror pacchetto
   
   Questo comando raggruppa sia i repos 4.17.01 che 4.16.0x nello stesso file .tar. Non puoi pacchettizzare solo una parte del repository.