Panoramica dell'installazione perimetrale

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

Procedura di installazione

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

1. Disattiva SELinux sul nodo o impostalo in modalità permissiva. Per saperne di più, consulta Installare l'utilità apigee-setup di Edge per altro.
2. Decidi se vuoi attivare l'autenticazione di Cassandra.
3. Decidi se vuoi configurare la replica master-standby per Postgres.
4. 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.
5. Su ogni nodo della topologia selezionata, installa l'utilità apigee-setup di Edge:
   • Scarica il file bootstrap_4.54.00.sh di Edge in /tmp/bootstrap_4.54.00.sh.
   • Installa l'utilità apigee-service di Edge e le relative dipendenze.
   • Installa l'utilità apigee-setup di Edge e le relative dipendenze.

     Per saperne di più, consulta Installare l'utilità apigee-setup di Edge.

6. Utilizza l'utilità apigee-setup per installare uno o più componenti Edge su ogni nodo in base alla topologia selezionata.

   Consulta Installare i componenti Edge su un nodo.

7. 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.

8. Riavvia il componente dell'UI New Edge su ogni nodo al termine dell'installazione, come mostrato nell'esempio seguente:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

9. Configura l'autenticazione e le impostazioni facoltative per l'UI New Edge (i cui nomi dei componenti sono edge-management-ui e edge-management-ui-static).

   Per saperne di più, consulta Configurare l'UI New 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 un 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 accesso sudo completo, si intende che 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.
• Script setup.sh per installare i componenti Edge (a meno che tu non abbia già utilizzato "apigee-service install" per installare gli RPM richiesti. In questo caso, l'accesso root o sudo completo non è obbligatorio.)
• Script update.sh per aggiornare i componenti 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 diversi da quelli mostrati sopra deve essere un utente con 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.

Creare un utente con accesso sudo completo all'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 e aggiungere:

installUser        ALL=(apigee)      NOPASSWD: ALL

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

Impostare le 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 di licenza Edge e tutti i file di configurazione.

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

1. Crea il file in un editor come qualsiasi utente.
2. Modifica il proprietario del file in "apigee:apigee" con il comando chown oppure, se hai modificato l'utente che esegue il servizio Edge dall'utente "apigee", modifica il file in modo che appartenga all'utente che esegue il servizio Edge.

Separare le 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 root o da un utente che ha accesso sudo completo, non è sempre possibile. In alternativa, puoi separare la procedura in attività eseguite da root e attività eseguite da un utente con accesso sudo completo all'utente "apigee".

1. Attività eseguite da root:
   1. Scarica ed esegui il file bootstrap_4.54.00.sh:

      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
      sudo bash /tmp/bootstrap_4.54.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

      Gli RPM di Edge 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-management-ui, edge-management-ui-static, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.

2. Dopo che l'utente root ha installato gli RPM di Edge sul nodo, l'utente con accesso sudo completo all'utente "apigee" completa la procedura 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 un file di configurazione all'utilità apigee-setup che contenga le informazioni sull'installazione di 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 in modo che appartenga a "apigee:apigee".

Tutte le informazioni nel file di configurazione sono obbligatorie, ad eccezione della password dell'amministratore di sistema di 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.

Gestire un errore di installazione

In caso di errore durante l'installazione di un componente Edge, puoi provare a correggere il problema e poi 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'UI New Edge su ogni nodo su cui è in esecuzione.

Installazione con o senza 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 di Edge.

• Nodi senza connessione a internet esterna

  I nodi senza connessione a internet esterna possono accedere a una versione sottoposta a mirroring del repository Apigee che hai 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

  Per creare il repository Apigee interno, è necessario un nodo con accesso internet esterno per poter scaricare gli RPM e le dipendenze di Edge. Dopo aver creato il repository interno, puoi spostarlo su un altro nodo o rendere il nodo accessibile ai nodi Edge per l'installazione.

Utilizzare un repository Edge locale per mantenere la versione di Edge

Uno dei motivi per utilizzare un repository locale o sottoposto a mirroring è l'installazione di Edge su nodi senza connessione internet esterna, come descritto nella sezione precedente.

Risolvere le dipendenze di installazione degli RPM

I file di distribuzione di Apigee Edge vengono installati come un insieme di file RPM, ognuno dei quali può avere la 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 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 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 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 operativa di Edge, la directory di installazione root è indicata come:

/opt/apigee

L'installazione utilizza la seguente struttura del 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 viene scritto in /tmp/setup-root.log.

I file di log per ogni componente sono contenuti nella /opt/apigee/var/log directory. 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 tabelle seguenti elencano la posizione dei file di log:

Dati

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.