Panoramica dell'installazione perimetrale

Edge per Private Cloud v4.18.05

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

Procedura di installazione

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

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

     Vedi Installare l'utilità apigee-setup Edge per saperne di più.

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

   Vedi 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 usi per creare e gestire le organizzazioni Edge.

   Per saperne di più, vedi Eseguire l'onboarding di un'organizzazione.

8. Riavvia il componente UI Edge al termine dell'installazione.

Chi può eseguire l'installazione

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

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

• 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. Quindi root o sudo completo se non è necessario.)
• Script update.sh per aggiornare i componenti di Edge

Inoltre, il programma di installazione di Edge crea sul tuo sistema un nuovo utente, denominato "apigee". Molti comandi Edge richiamare sudo to run as "apigee" utente.

Qualsiasi utente che voglia eseguire tutti gli altri comandi oltre a quelli mostrati sopra deve essere un utente con accesso completo sudo all'app "apigee" utente. Questi comandi includono:

• I 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 a "apigee" utente

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

installUser        ALL=(apigee)      NOPASSWD: ALL

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

Impostazione delle autorizzazioni per i file di configurazione

Qualsiasi file o risorsa utilizzati dai comandi Edge deve essere accessibile all'istanza utente. Questo include il file della licenza Edge ed eventuali file di configurazione.

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

1. Crea il file in un editor come qualsiasi utente.
2. chown il proprietario del file di "apigee:apigee" o se hai cambiato l'utente che esegue il servizio Edge dall'istanza "apigee" utente, sottoponi il file all'utente che sta eseguendo 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 Edge come root o da un utente che ha accesso completo a sudo, cosa che non sempre è possibile. Puoi, invece, separare in attività eseguite dalla directory principale e in attività eseguite da un utente con accesso completo sudo all'app "apigee" utente.

1. Attività eseguite dall'utente principale:
   1. Scarica ed esegui il file bootstrap_4.18.05.sh:

      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
      sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

      Questo passaggio installa l'utilità apigee-service e crea l'"apigee" utente.

   2. Configurare un utente per avere accesso completo all'archivio "apigee" come descritto in Creazione di un utente con accesso sudo completo a "apigee" utente.
   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 perimetrali sul nodo:

      /opt/apigee/apigee-service/bin/apigee-service compName install

      Gli RPM perimetrali che installi sul nodo dipendono dalla tua topologia. L'elenco di tra i componenti disponibili: 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.

2. Dopo che l'utente root ha installato gli RPM perimetrali sul nodo, l'utente con accesso completo a sudo "apigee" L'utente completa il processo di configurazione:
   1. Utilizza l'utilità setup.sh per completare la configurazione di Edge componenti sul nodo. La forma del comando dipende dai componenti installato sul nodo. Per un elenco completo, vedi Installa i componenti Edge su un nodo.

      Ad esempio, per completare l'installazione di ZooKeeper e Cassandra, utilizza quanto segue :

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      Dove configFile è il file di configurazione 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

Percorso dei file di configurazione di installazione

Devi passare un file di configurazione all'utilità apigee-setup contenente le informazioni sull'installazione di Edge. L'unico requisito per le installazioni automatiche è che di configurazione del file deve essere accessibile o leggibile da "apigee" utente. Ad esempio, metti il file nella directory /usr/local/var o /usr/local/share sul nodo chown in "apigee:apigee".

Tutte le informazioni nel file di configurazione sono obbligatorie, ad eccezione del sistema Edge password dell'amministratore. Se ometti la password, l'utilità apigee-setup richiede per inserirlo nella riga di comando.

Per ulteriori informazioni, 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 correggere il problema ed esegui di nuovo il programma di installazione. Il programma di installazione è progettato per essere eseguito ripetutamente casi in cui rileva un errore o se in un secondo momento vuoi modificare o aggiornare un componente dell'installazione.

Dopo l'installazione o l'upgrade, assicurati di riavviare il componente Edge UI su ogni nodo su cui mentre è in esecuzione.

Installazione tramite Internet o non 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 Edge RPM e dipendenze.

• Nodi senza connessione a internet esterna

  I nodi senza una connessione a internet esterna possono accedere a una versione sottoposta a mirroring di Apigee configurato internamente. Questo repository contiene tutti gli RPM perimetrali, ma devi assicurati di avere a disposizione tutte le altre dipendenze dai repository in ogni rete.

  Per creare il repository Apigee interno, hai bisogno di un nodo con una connessione internet esterna per poter scaricare gli RPM perimetrali e le dipendenze. Dopo aver creato repository interno, puoi quindi spostarlo in un altro nodo o renderlo accessibile a Edge nodi 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 è per l'installazione di Edge sui nodi senza una connessione a internet esterna, come descritto nella sezione precedente.

Risolvere le dipendenze di installazione RPM

I file di distribuzione Apigee Edge vengono installati come set di file RPM, ognuno dei quali può avere e la propria catena di dipendenze di installazione. Molte di queste dipendenze sono definite che sono al di fuori del controllo di Apigee e che possono essere modificati in qualsiasi momento. Pertanto, documentazione non indica il numero di versione esplicito di ciascuna dipendenza.

Se stai eseguendo un'installazione su una macchina con accesso a internet, il nodo può scaricare gli RPM e le dipendenze necessarie. Tuttavia, se esegui l'installazione da un nodo senza internet all'accesso, 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 è provare a eseguire l'installazione, identificare eventuali dipendenze mancanti e copiarle nel repository locale fino al momento .

Comandi Yum comuni

Gli strumenti di installazione Edge per Linux si basano su Yum per installare e aggiornare i componenti. Potresti usare 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 Edge, la directory di installazione principale è indicata come segue:

/opt/apigee

L'installazione utilizza la seguente struttura di file system per il deployment di Apigee Edge per privati Google Cloud.

File di log

Viene scritto il file di log per apigee-setup e lo script setup.sh /tmp/setup-root.log.

I file di log di ogni componente sono contenuti nell'elemento /opt/apigee/var/log . Ogni componente ha una propria sottodirectory. Ad esempio, i log per l'account di gestione Il server si trova nella directory:

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

Le seguenti tabelle elencano la posizione dei file di log:

Dati

Attività successive all'installazione

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

Riavvia la UI Edge componente

Al termine dell'installazione, devi riavviare il componente Edge UI su ciascun nodo:

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

Configurazione di Edge componenti dopo l'installazione

Per configurare Edge dopo l'installazione, utilizza una combinazione di file .properties e le utilità Edge. Ad esempio, per configurare TLS/SSL nella UI Edge, .properties per impostare le proprietà necessarie. Modifiche a .properties richiedono il riavvio del componente Edge interessato.

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

Per impostare una proprietà per un componente, modifica il file .properties corrispondente e 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, i file .properties nella La directory /opt/apigee/customer/application è stata letta. Ciò significa che l'aggiornamento conserva tutte le proprietà che imposti sul componente.

Vedi Come configurare Edge per ulteriori informazioni su configurazione perimetrale.

Richiamo dei comandi sui componenti Edge

Utilità di gestione delle installazioni perimetrali in /opt/apigee/apigee-service/bin che puoi per gestire un'installazione 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

Usa 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_name action

Dove component_name identifica il componente. Il componente deve trovarsi sul nodo che eseguirai apigee-service. A seconda della configurazione, i valori component_name può includere:

• apigee-cassandra (Cassandra)
• apigee-openldap (OpenLDAP)
• apigee-postgresql (database PostgreSQL)
• apigee-qpidd (qpidd)
• apigee-sso (SSO perimetrale)
• apigee-zookeeper (ZooKeeper)
• edge-management-server (server di gestione)
• edge-management-ui (nuova UI di Edge)
• edge-message-processor (Elaboratore messaggi)
• edge-postgres-server (server Postgres)
• edge-qpid-server (server Qpid)
• edge-router (router Edge)
• edge-ui (UI classica)

Oltre a questi componenti, puoi anche richiamare apigee-service sul apigee-provision e apigee-validate in base al configurazione.

Ad esempio, per riavviare il router perimetrale, esegui questo comando:

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

Puoi determinare l'elenco dei componenti installati sul nodo esaminando Directory /opt/apigee. La directory contiene una sottodirectory per ogni Edge installato sul nodo. Ogni sottodirectory è preceduta dal prefisso:

• 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 monetizzazione. Ad esempio: edge-mint-management-server.

L'elenco completo delle azioni di un componente dipende dal componente stesso, ma tutte supportano le seguenti azioni:

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

Attiva controllo del sistema al momento dell'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 la CPU e di memoria per il componente da installare. Il valore predefinito è "n" per disattivare controllo.