Panoramica dell'installazione perimetrale

Edge for Private Cloud v. 4.17.09

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

Procedura di installazione

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

• Disattiva SELinux sul nodo o impostalo sulla modalità permissiva. Per saperne di più, consulta Installa l'utilità apigee-setup di Edge.
• Decidi se attivare l'autenticazione Cassandra.
• Decidi se vuoi configurare la replica master-standby per Postgres.
• Seleziona la configurazione 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 Edge bootstrap_4.17.09.sh in /tmp/bootstrap_4.17.09.sh.
  • Installa l'utilità Edge apigee-service e le dipendenze.
  • Installa l'utilità Edge apigee-setup e le dipendenze.
    
    Per saperne di più, consulta Installa l'utilità apigee-setup di Edge.
• Utilizza l'utilità apigee-setup per installare uno o più componenti Edge su ciascun nodo in base alla topologia selezionata.
  Consulta Installa i componenti Edge su un nodo 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 Esegui l'onboarding di un'organizzazione.

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 Edge, i comandi devono essere eseguiti dall'utente root o da un utente con accesso sudo completo. L'accesso sudo completo consente all'utente di 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:

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

Inoltre, il programma di installazione di Edge crea un nuovo utente sul tuo sistema, denominato "apigee". Molti comandi Edge richiamano sudo per l'esecuzione 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.

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

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

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

1. Crea il file in un editor come qualsiasi utente.
2. Cambia il proprietario del file in "apigee:apigee" o, se hai cambiato l'utente che esegue il servizio Edge dall'utente "apigee", cambia il proprietario del file impostandolo sull'utente che esegue il servizio Edge.

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

Sebbene sia più semplice eseguire l'intero processo di installazione di Edge come root o da un utente che dispone dell'accesso sudo completo, ciò non è sempre possibile. Puoi invece suddividere il processo 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.17.09.sh:
      > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
      > sudo bash /tmp/bootstrap_4.17.09.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 sopra.
   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 Edge sul nodo:
      > /opt/apigee/apigee-service/bin/apigee-service compName install
      
      Gli RPM 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-ui, edge-management-server, edge-ui, 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 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, utilizzare il seguente comando:
      > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f file di configurazione
      
      Dove file di configurazione è 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 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 impostalo su "apigee:apigee".

Tutte le informazioni nel file di configurazione sono obbligatorie, 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 Installa 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 correggere il problema e poi eseguire nuovamente 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.

Installazione con o senza connessione a internet

Per installare Edge su un nodo, quest'ultimo 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 una connessione a internet esterna
  
  I nodi senza una connessione a internet esterna possono accedere a una versione sottoposta a mirroring del repository Apigee configurato internamente. Questo repository contiene tutti gli RPM 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, è 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.

Utilizzo di 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 a internet esterna, come descritto nella sezione precedente.

Tuttavia, l'utilizzo di un repository locale offre un altro vantaggio, anche per i nodi con una connessione a internet esterna. Quando installi Edge dal repository pubblico di Apigee, installi sempre gli RPM 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 di Edge. Puoi quindi utilizzare il repository locale per eseguire le installazioni per 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, installi di nuovo Edge dal repository locale. L'installazione dal repository locale garantisce che gli ambienti di sviluppo e di produzione corrispondano.

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

Risoluzione delle dipendenze di installazione 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 l'installazione viene eseguita 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 eventuali dipendenze mancanti e copiarle nel repository locale fino a quando 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.

• Svuota 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 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 for 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 per ogni componente sono contenuti nella directory /opt/apigee/var/log. Ogni componente ha la propria sottodirectory. Ad esempio, i log per il 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

Attività post-installazione

Al termine dell'installazione, puoi eseguire azioni aggiuntive sui componenti Edge.

Configurazione dei componenti Edge dopo l'installazione

Per configurare Edge dopo l'installazione, utilizza una combinazione di file .properties e utilità Edge. Ad esempio, per configurare TLS/SSL sulla UI Edge, modifica i file .properties per impostare le proprietà necessarie. Le modifiche ai file .properties richiedono il riavvio del componente Edge interessato.

I file .properties si trovano nella directory /opt/apigee/customer/application. Ogni componente ha il proprio file .properties in quella directory. Ad esempio, router.properties e management-server.properties.

Per impostare una proprietà per un componente, modifica il file .properties corrispondente, quindi riavvia il componente:

> /opt/apigee/apigee-service/bin/apigee-service component restart

Ad esempio:

> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Quando aggiorni Edge, vengono letti i file .properties nella directory /opt/apigee/customer/application. Ciò significa che l'aggiornamento conserva tutte le proprietà impostate sul componente.

Per saperne di più sulla configurazione di Edge, consulta Come configurare Edge.

Richiamo di comandi sui componenti Edge

Edge installa le utilità di gestione in /opt/apigee/apigee-service/bin che puoi utilizzare per gestire un'installazione di Edge. Ad esempio, puoi utilizzare l'utilità apigee-all per avviare, arrestare, riavviare o determinare lo stato di tutti i componenti Edge sul nodo:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

Utilizza l'utilità apigee-service per controllare e configurare i singoli componenti. L'utilità apigee-service ha il seguente formato:

/opt/apigee/apigee-service/bin/apigee-service component action

Ad esempio, per riavviare il router perimetrale:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

Puoi determinare l'elenco dei componenti installati sul nodo esaminando la directory /opt/apigee. Questa directory contiene una sottodirectory per ogni componente Edge installato sul nodo. Ogni sottodirectory è preceduta da:

• apigee: un componente di terze parti utilizzato da Edge. Ad esempio, apigee-cassandra.
• edge: un componente Edge di Apigee. Ad esempio, edge-management-server.
• edge-mint: un componente di Monetization. Ad esempio edge-mint-management-server.
• baas: un componente API BaaS. Ad esempio baas-usergrid.

L'elenco completo delle azioni per un componente dipende dal componente stesso, ma tutti i componenti supportano le seguenti azioni:

• start, stop, restart
• status, version
• backup, restore
• install, uninstall