Questa pagina è stata tradotta dall'API Cloud Translation.

Panoramica dell'installazione perimetrale

Una tipica installazione di Edge è composta da componenti Edge distribuiti su più nodi. Dopo aver installato Edge su un nodo, installa e configura uno o più componenti Edge sul nodo.

Procedura di installazione

L'installazione di Edge su un nodo è un processo in più passaggi:

Disattiva 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 di Edge dall'elenco delle 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 ogni nodo della topologia selezionata, installa l'utilità Edge apigee-setup:
- Scarica il file bootstrap_4.50.00.sh di Edge su /tmp/bootstrap_4.50.00.sh.
- Installa l'utilità apigee-service di Edge e le dipendenze.
- Installa l'utilità apigee-setup di Edge e le dipendenze.
  Vedi Installare l'utilità apigee-setup di Edge per ulteriori informazioni.
Utilizza l'utilità apigee-setup per installare uno o più componenti Edge su ciascun nodo in base alla topologia selezionata.
Consulta Installare i componenti di Edge su un nodo.
Sul nodo del server di gestione, utilizza l'utilità apigee-setup per installare apigee-provision, le utilità che utilizzi per creare e gestire le organizzazioni Edge.
Per saperne di più, consulta Eseguire l'onboarding di un'organizzazione.
Riavvia il componente dell'interfaccia utente classica su ogni nodo al termine dell'installazione, come mostrato 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 di Edge (il cui nome del componente è edge-management-ui), un'interfaccia utente avanzata per sviluppatori e amministratori di Apigee Edge for Private Cloud.

Per ulteriori informazioni, vedi Installare la nuova UI di Edge.

Al termine dell'installazione, consulta questo elenco di azioni post-installazione comuni.

Chi può eseguire l'installazione

I file di distribuzione Apigee Edge vengono installati come insieme di RPM e dipendenze. Per installare, disinstallare e aggiornare gli RPM di Edge, i comandi devono essere eseguiti dall'utente root o da un utente con accesso sudo completo. Per l'accesso sudo completo, l'utente ha accesso sudo per eseguire le stesse operazioni di root.

Qualsiasi utente che voglia eseguire i seguenti comandi o script deve essere root o un utente con accesso sudo completo:

Utilità apigee-service:
- Comandi apigee-service: install, uninstall, update.
- Comandi apigee-all: install, uninstall, update.
Lo script setup.sh per installare i componenti di Edge (a meno che tu non abbia già utilizzato "apigee-service install" per installare gli RPM richiesti. quindi accesso root o completo sudo se non richiesto.)
Script update.sh per aggiornare i componenti di Edge

Inoltre, il programma di installazione di Edge crea un nuovo utente sul sistema, denominato "apigee". Molti comandi Edge richiamano sudo per essere eseguiti come utente "apigee".

Qualsiasi utente che voglia eseguire tutti gli altri comandi rispetto a quelli mostrati sopra deve avere accesso sudo completo 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.

Creazione di un utente con accesso sudo completo all'utente "apigee"

NOTA: non puoi eseguire questo passaggio finché non hai eseguito il file bootstrap_4.50.00.sh per creare l'utente "apigee".

Per configurare un utente in modo che abbia accesso sudo completo all'utente "apigee", utilizza il comando "visudo" per modificare il file sudoers in modo da aggiungere:

installUser        ALL=(apigee)      NOPASSWD: ALL

Dove installUser è il nome utente della persona che lavora con Edge.

Impostazione delle autorizzazioni sui file di configurazione

Tutti i file o le risorse utilizzati dai comandi Edge devono essere accessibili all'utente "apigee". Sono inclusi il file della licenza di Edge e eventuali file di configurazione.

Quando crei un file di configurazione, puoi modificarne il proprietario in "apigee:apigee" per garantire che sia accessibile ai comandi Edge:

Crea il file in un editor come qualsiasi utente.
chown il proprietario del file a "apigee:apigee" oppure, se hai modificato l'utente che esegue il servizio Edge dall'utente "apigee", esegui chown del file per l'utente che esegue il servizio Edge.

Separazione delle attività di installazione di Edge tra utente root e utente non root

Sebbene sia più semplice eseguire l'intera procedura di installazione di Edge come utente root o da un utente che ha accesso sudo completo, non è sempre possibile. In alternativa, puoi suddividere il processo in attività eseguite da root e attività eseguite da un utente con accesso sudo completo all'utente "apigee".

Attività eseguite dall'utente root:
1. Scarica ed esegui il file bootstrap_4.50.00.sh:
```
curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
```
  Questo passaggio installa l'utilità apigee-service e crea l'utente "apigee".
2. Configura un utente in modo che abbia accesso sudo completo all'utente "apigee" come descritto in Creare un utente con accesso sudo completo all'utente "apigee".
3. Installa l'utilità apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
4. Utilizza l'utilità apigee-setup per installare gli RPM di Edge sul nodo:
```
/opt/apigee/apigee-service/bin/apigee-service compName install
```
  I RPM Edge installati 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.
Dopo che l'utente root installa gli RPM Edge sul nodo, l'utente con accesso sudo completo all'utente "apigee" completa il processo di configurazione:
1. Utilizza l'utilità setup.sh per completare la configurazione dei componenti Edge sul nodo. La forma del comando dipende dai componenti installati 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 di Edge.
  
  In alternativa, per eseguire un'installazione all-in-one, utilizza il seguente comando:
```
/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
```

Posizione dei file di configurazione dell'installazione

Devi passare all'utilità apigee-setup un file di configurazione contenente le informazioni sull'installazione di Edge. L'unico requisito per le installazioni silenziose è 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 in "apigee:apigee".

Tutte le informazioni nel file di configurazione sono obbligatorie, ad eccezione della password dell'amministratore del sistema perimetrale. 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 di Edge, puoi provare a correggere il problema, quindi eseguire di nuovo il programma di installazione. Il programma di installazione è progettato per essere eseguito ripetutamente nel caso in cui rilevi 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 di 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 le RPM e le dipendenze di Edge.
Nodi senza connessione a internet esterna
I nodi senza una connessione a internet esterna possono accedere a una versione in mirroring del repository Apigee configurato internamente. Questo repository contiene tutti gli RPM di Edge, ma devi assicurarti di avere tutte le altre dipendenze disponibili dai repository sulla rete interna.

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

Per creare il repository Apigee interno, hai bisogno di un nodo con accesso esterno a internet per poter scaricare gli RPM e le dipendenze perimetrali. Una volta creato il repo 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 di 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.

Nota: tuttavia, l'utilizzo di un repository locale presenta un altro vantaggio, anche per i nodi con una connessione a internet esterna. Quando installi Edge dal repository pubblico di Apigee, vengono sempre installate le RPM di Edge più recenti. Pertanto, se vuoi scaricare e archiviare gli RPM Edge per una versione specifica di Edge, devi creare un repository locale per quella versione. Puoi quindi utilizzare il repository locale per eseguire installazioni di qualsiasi versione di Edge.

Ad esempio, utilizzi prima il repository locale per installare un ambiente di sviluppo Edge. Poi, quando è tutto pronto per passare a un ambiente di produzione, installa di nuovo Edge dal repo locale. Se esegui l'installazione dal repository locale, garantisci la corrispondenza degli ambienti di sviluppo e produzione.

Un repository con mirroring è molto flessibile. Ad esempio, puoi creare un repository sottoposto a mirroring dalle ultime RPM di Edge o da una versione specifica di Edge. Dopo aver creato il repository, puoi anche aggiornarlo per aggiungere RPM da versioni diverse di Edge. Per saperne di più, consulta Installare l'utilità apigee-setup di Edge.

Risoluzione delle dipendenze di installazione RPM

I file di distribuzione Apigee Edge vengono installati come set di file RPM, ognuno dei quali può avere una propria catena di dipendenze di installazione. Molte di queste dipendenze sono definite da componenti di terze parti che non sono sotto il controllo di Apigee e possono cambiare in qualsiasi momento. Pertanto, la documentazione non elenca il numero di versione esplicito di ogni dipendenza.

Se stai eseguendo un'installazione su una macchina con accesso a internet, il nodo può scaricare le RPM e le dipendenze necessarie. 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 tuo repository locale è tentare un'installazione, identificare le eventuali dipendenze mancanti e copiarle nel repository locale finché l'installazione non va a buon fine.

Comandi Yum comuni

Gli strumenti di installazione di 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.

Pulisci 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 di Edge, la directory di installazione principale è indicata come:

/opt/apigee

L'installazione utilizza la seguente struttura del file system per eseguire il deployment di Apigee Edge per Private Cloud.

File di log

Il file di log per apigee-setup e lo script setup.sh viene scritto in /tmp/setup-root.log.

I file di log di ciascun componente sono contenuti nella directory /opt/apigee/var/log. Ogni componente ha la propria sottodirectory. Ad esempio, i log del server di gestione si trovano nella directory:

/opt/apigee/var/log/edge-management-server

Le seguenti tabelle elencano le posizioni 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 è implementato utilizzando Nginx. Per altri log, vedi: `/opt/apigee/var/log/edge-router/nginx` `/opt/nginx/logs`
processore di messaggi	`/opt/apigee/var/log/edge-message-processor`
Apigee Qpid Server	`/opt/apigee/var/log/edge-qpid-server`
Apigee Postgres Server	`/opt/apigee/var/log/edge-postgres-server`
Interfaccia utente classica (non la nuova interfaccia utente 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 di 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`

Attivare il controllo del sistema durante l'installazione

Il file di configurazione dell'installazione di 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 in fase di installazione. Il valore predefinito è "n" per disattivare il controllo.