Mengonfigurasi UI New Edge

Dokumen ini menjelaskan cara menginstal dan mengonfigurasi UI Edge Baru untuk Apigee Edge untuk Private Cloud. Pada versi 4.54.00, UI Edge Baru terdiri dari dua komponen RPM:

  • edge-management-ui: Server backend UI Edge Baru.
  • edge-management-ui-static: Aset web statis untuk frontend UI Edge Baru.

UI Edge Baru diinstal secara default saat Anda menjalankan setup.sh dengan profil aio (all-in-one), sa (standalone), atau ms (Management Server), atau dapat diinstal secara terpisah di node menggunakan profil ue.

Prasyarat

Sebelum menginstal atau mengonfigurasi UI Edge Baru dalam penginstalan Apigee Edge untuk Private Cloud, pastikan node memenuhi persyaratan berikut:

  • Persyaratan hardware dan OS:
    • RAM 4 GB
    • 2 core CPU
    • Kapasitas disk 60 GB
    • Versi 4.54.00 utilitas apigee-setup yang diinstal di node seperti yang dijelaskan di Menginstal utilitas apigee-setup Edge.
    • Port 3001 harus terbuka. Ini adalah port default yang digunakan untuk permintaan ke UI Edge Baru. Jika Anda mengubah port menggunakan properti yang dijelaskan dalam File konfigurasi UI Edge Baru, pastikan port tersebut terbuka.
  • Autentikasi:
    • Autentikasi dasar (default): Diaktifkan secara default (AUTH_MODE=basic). Menggunakan kredensial Edge Management Server dan SymasLDAP tanpa memerlukan Penyedia Identitas (IDP) eksternal.
    • SSO / IDP eksternal (opsional): Anda dapat mengonfigurasi Apigee SSO atau IDP eksternal (seperti SAML atau OIDC) secara opsional. Jika Anda terhubung ke IDP eksternal melalui TLS, IDP Anda harus mendukung TLS v1.2 atau yang lebih tinggi.

Untuk mengetahui informasi selengkapnya tentang fitur UI Edge Baru, lihat UI Edge Baru untuk cloud pribadi.

Ringkasan penginstalan dan konfigurasi

Pada tingkat tinggi, proses penginstalan atau konfigurasi ulang UI Edge Baru menggunakan ue profil adalah sebagai berikut:

  • Pastikan utilitas apigee-setup diinstal di node.
  • Buat file konfigurasi senyap dan ubah dengan setelan Anda.
  • Jalankan /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile. Tindakan ini akan menginstal dan mengonfigurasi edge-management-ui dan edge-management-ui-static.
  • Login dan uji UI Edge Baru di http://new_edge_UI_IP:3001.

Jika Management Server dan server UI Edge Baru Anda berada di belakang load balancer dengan TLS offloading yang terjadi di load balancer, pastikan konfigurasi mencerminkan properti yang ditandai di Mengonfigurasi UI Edge Baru saat TLS termination di load balancer.

File konfigurasi UI Edge Baru

Contoh berikut menunjukkan file konfigurasi untuk menginstal dan mengonfigurasi UI Edge Baru dengan autentikasi Dasar default.

Konfigurasi autentikasi dasar (default)

# IP of the Edge Management Server.
IP1=management_server_IP

# IP of the New Edge UI node (can be the same as IP1 or a separate node).
IP2=new_edge_UI_server_IP

# Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=your_password    # If omitted, you are prompted for it.

# Edge Management Server information.
APIGEE_PORT_HTTP_MS=8080
MSIP=$IP1
MS_SCHEME=http

#
# New Edge UI configuration.
#
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_IP=$IP2
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_SCHEME=http
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT

# Authentication mode (basic is default)
AUTH_MODE=basic

## SMTP Configuration
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.example.com
SMTPUSER=your@email.com
SMTPPASSWORD=your_email_password
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.
SMTPMAILFROM="My Company <myco@company.com>"

Menginstal atau mengonfigurasi UI Edge Baru

Untuk menginstal atau mengonfigurasi UI Edge Baru menggunakan profil ue:

  1. Login ke node target sebagai administrator.
  2. Instal utilitas apigee-setup versi 4.54.00 di node, seperti yang dijelaskan di Menginstal utilitas apigee-setup Edge.
  3. Bersihkan semua informasi yang di-cache dengan Yum dengan menjalankan perintah berikut: 
    sudo yum clean all
  4. Buat file konfigurasi seperti yang dijelaskan dalam New Edge UI configuration file dan pastikan file tersebut dimiliki oleh pengguna "apigee": 
    chown apigee:apigee configFile
  5. Di node, jalankan perintah berikut: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile

    Utilitas apigee-setup menginstal dan mengonfigurasi edge-management-ui dan edge-management-ui-static.

  6. Login ke UI Edge Baru dengan membuka URL berikut di browser: 
    http://new_edge_UI_IP:3001

    Dengan new_edge_UI_IP adalah alamat IP atau nama host node yang menghosting UI Edge Baru.

  7. Masukkan kredensial Anda.

    UI Edge Baru akan muncul. Untuk mengetahui informasi tentang cara menggunakan UI Edge Baru, lihat UI Edge Baru untuk cloud pribadi.

    Jika UI Edge Baru tidak ditampilkan, pastikan port 3001 terbuka untuk koneksi.

Opsional: Jika Anda ingin mengonfigurasi Apigee SSO untuk autentikasi, ikuti langkah-langkah di Menginstal dan mengonfigurasi Apigee SSO dan Mengaktifkan IDP eksternal di UI Edge Baru.

Meng-uninstal UI Edge Baru

Untuk meng-uninstal UI Edge Baru dari node, uninstal komponen edge-management-ui dan edge-management-ui-static.

Untuk meng-uninstal komponen UI Edge Baru:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui uninstall
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static uninstall

Untuk menghapus semua komponen Edge dari node:

  1. Hentikan semua layanan Edge yang berjalan di komputer: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  2. Hapus cache yum: 
    sudo yum clean all
  3. Hapus semua RPM Apigee: 
    sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
  4. Hapus direktori root penginstalan: 
    sudo rm -rf /opt/apigee