Una tipica installazione Edge è composta da componenti Edge distribuiti su più nodi. Dopo aver installato Edge su un nodo, installerai e configurerai uno o più componenti Edge sul nodo.
Procedura di installazione
L'installazione di Edge su un nodo è un processo in più passaggi:
- Disabilita SELinux sul nodo o impostalo in modalità permissiva. Per saperne di più, consulta Installare l'utilità apigee-setup di Edge.
- Decidi se attivare l'autenticazione Cassandra.
- Decidi se vuoi configurare la replica in standby del master per Postgres.
- Seleziona la configurazione Edge dall'elenco di topologie consigliate. Ad esempio, puoi installare Edge su un singolo nodo per i test o su 13 nodi per la produzione. Per saperne di più, consulta Topologie di installazione.
- Su ciascun nodo della topologia selezionata, installa l'utilità Edge
apigee-setup
:- Scarica il file
bootstrap_4.52.01.sh
di Edge su/tmp/bootstrap_4.52.01.sh
. - Installa l'utilità e le dipendenze di Edge
apigee-service
. - Installa l'utilità e le dipendenze di Edge
apigee-setup
.Per saperne di più, consulta Installare l'utilità Edge apigee-setup.
- Scarica il file
- Utilizza l'utilità
apigee-setup
per installare uno o più componenti Edge su ciascun nodo in base alla topologia selezionata. - Sul nodo del server di gestione, utilizza l'utilità
apigee-setup
per installareapigee-provision
, le utilità che utilizzi per creare e gestire le organizzazioni perimetrali.Per ulteriori informazioni, vedi Eseguire l'onboarding di un'organizzazione.
- Riavvia il componente della UI classica su ogni nodo al termine dell'installazione, come illustrato nell'esempio seguente:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
(Consigliato) Dopo aver completato l'installazione iniziale, Apigee consiglia di installare la nuova UI Edge (il cui nome del componente è
edge-management-ui
), che è un'interfaccia utente avanzata per gli sviluppatori e gli amministratori di Apigee Edge per il cloud privato.Per maggiori informazioni, vedi Installare la nuova UI Edge.
Al termine dell'installazione, consulta questo elenco di azioni comuni post-installazione.
Chi può eseguire l'installazione
I file di distribuzione di Apigee Edge vengono installati come insieme di RPM e dipendenze. Per installare, disinstallare e aggiornare gli RPM Edge, i comandi devono essere eseguiti dall'utente root o da un utente con accesso completo a sudo. Per avere accesso completo a sudo, ciò significa che l'utente dispone dell'accesso sudo per eseguire le stesse operazioni dell'utente root.
Qualsiasi utente che voglia eseguire i comandi o gli script seguenti deve essere root o essere un utente con accesso sudo completo:
- Utilità apigee-service:
- Comandi apigee-service:
install, uninstall, update
. - Comandi apigee-all:
install, uninstall, update
.
- Comandi apigee-service:
- Script setup.sh per installare i componenti Edge (a meno che tu non abbia già utilizzato "
apigee-service install
" per installare gli RPM richiesti. Quindi, puoi accedere come root o sudo completo, se non richiesto. - Script update.sh per aggiornare i componenti Edge
Inoltre, il programma di installazione Edge crea un nuovo utente sul sistema, denominato "apigee". Molti comandi Edge richiamano sudo per essere eseguito come utente "apigee".
Qualsiasi utente che vuole eseguire tutti gli altri comandi oltre a quelli mostrati sopra deve essere un utente con accesso completo sudo all'utente "apigee". Questi comandi includono:
-
Comandi dell'utilità apigee-service, tra cui:
- Comandi apigee-service come
start, stop, restart, configure
. - Comandi apigee-all come
start, stop, restart, configure
.
- Comandi apigee-service come
Creazione di un utente con accesso completo sudo all'utente "apigee"
Per configurare un utente in modo che abbia accesso completo sudo all'utente "apigee", utilizza il comando "visudo" per modificare il file sudoers e aggiungere:
installUser ALL=(apigee) NOPASSWD: ALL
Dove installUser è il nome utente della persona che utilizza Edge.
Impostare le autorizzazioni per i file di configurazione
Tutti i file o le risorse utilizzati dai comandi Edge devono essere accessibili all'utente "apigee". Sono inclusi il file di licenza Edge e gli eventuali file di configurazione.
Quando crei un file di configurazione, puoi modificarne il proprietario in "apigee:apigee" per assicurarti che sia accessibile ai comandi Edge:
- Crea il file in un editor come qualsiasi utente.
chown
il proprietario del file in "apigee:apigee" oppure, se hai cambiato l'utente che esegue il servizio Edge dall'utente "apigee", assegna il file all'utente che esegue il servizio Edge.
Separazione delle attività di installazione Edge tra utenti root e non root
Sebbene sia più semplice eseguire l'intero processo di installazione Edge come root o da un utente che dispone dell'accesso completo sudo, non è sempre possibile. Puoi invece separare il processo in attività eseguite dal root e in attività eseguite da un utente con accesso sudo completo all'utente "apigee".
- Attività eseguite dalla directory principale:
- Scarica ed esegui il file
bootstrap_4.52.01.sh
:curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
Questo passaggio installa l'utilità
apigee-service
e crea l'utente "apigee". - Configura un utente in modo che abbia accesso completo sudo all'utente "apigee" come descritto in Creare un utente con accesso sudo completo all'utente "apigee".
- Installa l'utilità
apigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Utilizza l'utilità
apigee-setup
per installare gli RPM perimetrali sul nodo:/opt/apigee/apigee-service/bin/apigee-service compName install
Gli RPM perimetrali che installi sul nodo dipendono dalla topologia. L'elenco dei componenti disponibili include:
apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server
.
- Scarica ed esegui il file
- Dopo che l'utente root installa gli RPM Edge sul nodo, l'utente con accesso completo sudo
all'utente "apigee" completa il processo di configurazione:
- Utilizza l'utilità
setup.sh
per completare la configurazione dei componenti Edge sul nodo. La forma del comando dipende dai componenti che hai installato sul nodo. Per un elenco completo, consulta Installare i componenti Edge su un nodo.Ad esempio, per completare l'installazione di ZooKeeper e Cassandra, utilizza il seguente comando:
/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
Dove configFile è il file di configurazione perimetrale.
In alternativa, per eseguire un'installazione all-in-one, utilizza il seguente comando:
/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
- Utilizza l'utilità
Percorso dei file di configurazione di installazione
Devi passare all'utilità apigee-setup
un file di configurazione contenente le informazioni sull'installazione Edge. L'unico requisito per le installazioni invisibili è che il file di configurazione deve essere accessibile o leggibile dall'utente "apigee". Ad esempio, inserisci il file nella directory /usr/local/var
o /usr/local/share
sul nodo e chown
ad "apigee:apigee".
Sono obbligatorie tutte le informazioni contenute nel file di configurazione, ad eccezione della password dell'amministratore di sistema Edge. Se ometti la password, l'utilità apigee-setup
ti chiede di inserirla nella riga di comando.
Per saperne di più, consulta Installare i componenti Edge su un nodo.
Gestione di un errore di installazione
In caso di errore durante l'installazione di un componente Edge, puoi provare a risolvere il problema, quindi eseguire di nuovo il programma di installazione. Il programma di installazione è progettato per essere eseguito ripetutamente nei casi in cui rileva un errore o se in un secondo momento vuoi modificare o aggiornare un componente dopo l'installazione.
Dopo l'installazione o l'upgrade, assicurati di riavviare il componente dell'interfaccia utente Edge su ogni nodo su cui è in esecuzione.
Installazione tramite Internet o non Internet
Per installare Edge su un nodo, il nodo deve essere in grado di accedere al repository Apigee:
- Nodi con una connessione a internet esterna
I nodi con una connessione a internet esterna accedono al repository Apigee per installare gli RPM e le dipendenze perimetrali.
- Nodi senza una connessione a internet esterna
I nodi senza una connessione a internet esterna possono accedere a una versione con mirroring del repository Apigee che hai configurato internamente. Questo repository contiene tutti gli RPM perimetrali, ma devi assicurarti di avere a disposizione tutte le altre dipendenze dai repository sulla rete interna.
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 su un altro nodo o renderlo accessibile ai nodi Edge per l'installazione.
Utilizzo di un repository Edge locale per mantenere la versione Edge
Uno dei motivi per utilizzare un repository locale o con mirroring è l'installazione di Edge su nodi senza connessione a internet esterna, come descritto nella sezione precedente.
Risoluzione delle dipendenze di installazione RPM
I file di distribuzione di Apigee Edge vengono installati come set di file RPM, ciascuno dei quali può avere la propria catena di dipendenze di installazione. Molte di queste dipendenze sono definite da componenti di terze parti che esulano dal controllo di Apigee e possono cambiare in qualsiasi momento. Pertanto, la documentazione non elenca il numero di versione esplicito di ogni dipendenza.
Se esegui un'installazione su una macchina con accesso a internet, il nodo può scaricare gli RPM e le dipendenze necessari. Tuttavia, se esegui l'installazione da un nodo senza accesso a internet, in genere configuri un repository interno contenente tutte le dipendenze necessarie. L'unico modo per garantire che tutte le dipendenze siano incluse nel repository locale è tentare un'installazione, identificare le dipendenze mancanti e copiarle nel repository locale fino al completamento dell'installazione.
Comandi Yum comuni
Gli strumenti di installazione Edge per Linux si basano su Yum per installare e aggiornare i componenti. Potresti dover utilizzare diversi comandi Yum per gestire un'installazione su un nodo.
- Svuota tutte le cache di Yum:
sudo yum clean all
- Per aggiornare un componente Edge:
sudo yum update componentName
Ad esempio:
sudo yum update apigee-setup
sudo yum update edge-management-server
Struttura del file system
Edge installa tutti i file nella directory /opt/apigee
.
In questa guida e nella Guida alle operazioni perimetrali, la directory di installazione radice è indicata come:
/opt/apigee
L'installazione utilizza la seguente struttura di file system per eseguire il deployment di Apigee Edge per il cloud privato.
File di log
Il file di log per apigee-setup
e lo script setup.sh
vengono scritti in /tmp/setup-root.log
.
I file di log di ciascun componente si trovano nella directory /opt/apigee/var/log
. Ogni componente ha una propria sottodirectory. Ad esempio, i log del server di gestione si trovano nella directory:
/opt/apigee/var/log/edge-management-server
Nella tabella seguente sono elencati i percorsi dei file di log:
Componente | Località |
---|---|
Server di gestione |
/opt/apigee/var/log/edge-management-server
|
Router |
/opt/apigee/var/log/edge-router
Il router perimetrale viene implementato utilizzando Nginx. Per log aggiuntivi, vedi:
|
processore di messaggi |
/opt/apigee/var/log/edge-message-processor
|
Server Qpid Apigee |
/opt/apigee/var/log/edge-qpid-server
|
Server Apigee Postgres | /opt/apigee/var/log/edge-postgres-server |
UI classica (non la nuova UI di Edge, il cui nome del componente è
edge-management-ui ) |
/opt/apigee/var/log/edge-ui |
ZooKeeper | /opt/apigee/var/log/apigee-zookeeper |
OpenLDAP | /opt/apigee/var/log/apigee-openldap |
Cassandra | /opt/apigee/var/log/apigee-cassandra/system.log |
Qpidd | /opt/apigee/var/log/apigee-qpidd |
Database PostgreSQL | /opt/apigee/var/log/apigee-postgresql |
apigee-monit |
/opt/apigee/var/log/apigee-monit |
Dati
Componente | Località |
---|---|
Server di gestione | /opt/apigee/data/edge-management-server |
Router | /opt/apigee/data/edge-router |
processore di messaggi | /opt/apigee/data/edge-message-processor |
Agente Qpid Apigee | /opt/apigee/data/edge-qpid-server |
Agente Apigee Postgres | /opt/apigee/data/edge-postgres-server |
ZooKeeper | /opt/apigee/data/apigee-zookeeper |
OpenLDAP | /opt/apigee/data/apigee-openldap |
Cassandra | /opt/apigee/data/apigee-cassandra/data |
Qpidd | /opt/apigee/data/apigee-qpid/data |
Database PostgreSQL | /opt/apigee/data/apigee-postgres/pgdata |
apigee-monit |
/opt/apigee/data/apigee-monit |
Abilita controllo del sistema all'installazione
Il file di configurazione dell'installazione Edge supporta la seguente proprietà:
ENABLE_SYSTEM_CHECK=y
Se imposti questa proprietà su "y", il programma di installazione verifica che il sistema soddisfi i requisiti di CPU e memoria per il componente da installare. Il valore predefinito è "n" per disabilitare il controllo.