Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Installare l'utilità di configurazione perimetrale di Apigee

Edge for Private Cloud v. 4.17.01

Per installare Edge su un nodo, devi prima installare l'utilità apigee-setup di Edge. Se ti trovi in un ambiente in cui i nodi non dispongono di 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 vuoi, puoi creare un collegamento simbolico per mappare /opt/apigee a un'altra posizione. Per saperne di più, consulta i requisiti di installazione.

Prerequisito: disabilita SELinux

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

Per impostare temporaneamente SELinux in modalità permissiva, esegui questo comando:
1. Su un sistema operativo Linux 6.x:
  echo 0 > /selinux/enforce
  
  Per riattivare SELinux dopo l'installazione di Edge:
  echo 1 > /selinux/enforce
2. Su un sistema operativo Linux 7.x:
  setenforce 0
  
  Per riattivare SELinux dopo l'installazione di Edge:
  setenforce 1
Per disattivare SELinux in modo permanente 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: abilita il repository EPEL

Per installare o aggiornare Edge, devi attivare Extra Packages for Enterprise Linux (o EPEL). Il comando da utilizzare dipende dalla versione di RedHat/CentOS:

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:

Ottieni da Apigee il nome utente e la password che utilizzi per accedere al repository Apigee. Se hai già un nome utente e una password per il sito FTP di Apigee, puoi utilizzare queste credenziali.
Accedi al nodo come utente root per installare gli RPM Edge
Nota: sebbene l'installazione degli RPM richieda l'accesso root, puoi eseguire la configurazione di Edge senza l'accesso root.
Disattiva SELinux come descritto sopra.
Abilita il repository EPEL come descritto sopra.
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
Installa l'utilità apigee-service di Edge e le dipendenze:
> 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 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 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*'
(Solo CentOS-6.x e RedHat-6.x) Su tutti i nodi Qpid, esegui il seguente comando per assicurarti di scaricare la versione corretta di Qpid:
> yum install apigee-qpidd --disablerepo=epel
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 Installa i componenti Edge su un nodo.

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

Se i nodi Edge si trovano dietro un firewall o se in qualche altro modo non possono accedere al repository Apigee tramite internet, devi creare un repository locale o un mirror del repository Apigee. Questo mirror deve quindi 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, è necessario un nodo con accesso a internet esterno per poter scaricare gli RPM e le dipendenze di Edge. 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, potrebbe essere necessario aggiornarlo con i file della release Edge più recente. Le sezioni seguenti 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 e una password per il sito FTP di Apigee, puoi utilizzare queste credenziali.
Accedi al nodo RedHat o CentOS come utente root per installare gli RPM di Edge.
Nota: sebbene l'installazione di RPM richieda l'accesso root, puoi eseguire la configurazione di Edge senza l'accesso root.
Assicurati di avere l'ultima versione di yum-utils:
> sudo yum update yum-utils
Disattiva SELinux come descritto sopra.
Abilita il repository EPEL come descritto sopra.
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
(Solo CentOS-6.x e RedHat-6.x) Esegui questo comando per assicurarti di scaricare la versione corretta di Qpid:
> yum install apigee-qpidd --disablerepo=epel
Installa l'utilità apigee-service di Edge e le dipendenze:
> 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.
Installa l'utilità apigee-mirror sul nodo:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

Nota: se stai aggiornando un repository esistente alla versione 4.17.01, devi solo aggiornare apigee-mirror:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
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 precedenti, 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:
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ù, consulta Installa i componenti Edge su un nodo.

Installa 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, copialo in un nodo e poi installa Edge dal 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 che puoi utilizzare oppure puoi utilizzare il tuo server web.

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.01.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, estrai il file nella directory /tmp:
> tar -xzf apigee-4.17.01.tar.gz

Questo comando crea una nuova directory, denominata repos, nella directory contenente il file .tar. Ad esempio, /tmp/repos.
Installa l'utilità apigee-service di Edge e le dipendenze 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.
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 Installa 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 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
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, disattiva SELinux come descritto sopra.
Sul nodo remoto, scarica il file bootstrap_4.17.01.sh di Edge in /tmp/bootstrap_4.17.01.sh:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh

dove uName:pWord sono il nome utente e la password impostati sopra per il repository e remoteRepo è l'indirizzo IP o il nome DNS del nodo del repository.
Sul nodo remoto, installa l'utilità apigee-service di Edge e le dipendenze:
> sudo bash /tmp/bootstrap_4.17.01.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 Installa i componenti Edge su un nodo.

Aggiorna un repository Apigee locale

Per aggiornare il repository, devi scaricare l'ultimo file bootstrap_4.17.01.sh, quindi eseguire una nuova sincronizzazione:

Scarica il file bootstrap_4.17.01.sh di Edge in /tmp/bootstrap_4.17.01.sh:
> curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
Esegui il file Edge bootstrap_4.17.01.sh:
> 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 inserirla.
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.01/4.16.05/4.16.09 in un repository 4.17.01

Se devi gestire le installazioni di Edge 4.16.0x in un repository 4.17.01, puoi gestire un repository che contiene tutte le versioni. Da quel repository, puoi installare qualsiasi versione di Edge.

Per aggiungere 4.16.0x a un repository 4.17.01:

Assicurati di aver installato la versione 4.17.01 dell'utilità apigee-mirror:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

Dovresti visualizzare un risultato nel modulo seguente, dove xyz è il numero build:
apigee-mirror-4.17.01-0.0.xyz
Utilizza l'utilità apigee-mirror per scaricare Edge 4.16.01/4.16.05/4.16.09 nel tuo repository. Nota come anteponi al 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

Utilizza lo stesso comando per aggiornare in un secondo momento i repository 4.16.05/4.16.09 specificando i numeri di versione richiesti.
Esamina la directory /opt/apigee/data/apigee-mirror/repos per visualizzare la struttura dei file:
> ls /opt/apigee/data/apigee-mirror/repos

Dovresti visualizzare 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 thirdparty

Nota come hai 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.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

Questo comando pacchettizza i repository 4.17.01 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:

Se l'installazione viene eseguita da un file .tar, esegui il file di bootstrap corretto dal repository:
> sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

Per completare l'installazione, segui i passaggi rimanenti della sezione "Installazione dal file .tar" riportata sopra.
Se l'installazione viene eseguita 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.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh
> sudo bash /tmp/bootstrap_4.16.0X.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" riportata sopra.