Halaman ini diterjemahkan oleh Cloud Translation API.

Menginstal UI Edge baru

Dokumen ini menjelaskan cara menginstal UI Edge untuk Apigee Edge untuk Cloud Pribadi. UI Edge adalah UI generasi berikutnya untuk Edge.

Prasyarat

Untuk mencoba UI Edge baru di penginstalan Apigee Edge untuk Private Cloud, Anda harus:

Instal UI Edge pada node-nya sendiri. Anda tidak dapat menginstalnya di node yang berisi komponen Edge lainnya, termasuk node tempat UI Klasik yang ada berada. Tindakan ini akan menyebabkan pengguna tidak dapat login ke UI Klasik.
Node UI Edge harus memenuhi persyaratan berikut:
- JAVA 1,8
- RAM 4 GByte
- 2 core
- Kapasitas disk 60 GB
- Anda harus menginstal utilitas apigee-setup versi 4.51.00 terlebih dahulu di node seperti yang dijelaskan di Menginstal utilitas penyiapan apigee Edge.
- Port 3001 harus terbuka. Ini adalah port default yang digunakan untuk permintaan ke UI Edge. Jika Anda mengubah port menggunakan properti yang dijelaskan dalam File konfigurasi UE baru, pastikan port terbuka.
Aktifkan IDP eksternal di Edge. UI Edge mendukung SAML atau LDAP sebagai mekanisme autentikasi.
(Khusus SAML IDP) UI Edge hanya mendukung TLS v1.2. Karena Anda terhubung ke IdP SAML melalui TLS, jika Anda menggunakan SAML, IdP Anda harus mendukung TLS v1.2.

Untuk mengetahui informasi selengkapnya tentang UI Edge, lihat UI Edge baru untuk Private Cloud.

Ringkasan penginstalan

Pada level tinggi, proses penginstalan UI Edge untuk Apigee Edge untuk Private Cloud adalah sebagai berikut:

Menambahkan node baru ke cluster
Login ke node baru
Download utilitas apigee-setup
Membuat file konfigurasi dan mengubahnya dengan setelan Anda
Menjalankan utilitas apigee-setup
Login dan uji ke UE baru

Saat dieksekusi pada node baru, utilitas apigee-setup:

Menginstal UI Klasik dasar, yang disebut shoehorn, dan mengonfigurasi UI Klasik untuk menggunakan IdP eksternal guna mengautentikasi dengan Edge.
CATATAN: Anda tidak dapat menggunakan UI Klasik yang diinstal untuk terhubung ke Edge. Ini hanyalah persyaratan untuk menginstal UI Edge baru.
Menginstal UI Edge baru, dan mengonfigurasi UI Edge untuk menggunakan IdP eksternal Anda guna melakukan autentikasi dengan Edge.

Pertimbangan sebelum menginstal UI Edge baru

Seperti yang dijelaskan dalam prasyarat di atas, UI Edge mengharuskan Anda mengaktifkan IDP eksternal di Edge. Artinya, autentikasi pengguna dikontrol oleh IDP, tempat Anda mengonfigurasinya untuk menggunakan alamat email sebagai ID pengguna. Oleh karena itu, semua pengguna UI Edge harus terdaftar di IdP.

UI Klasik, UI default yang Anda instal dengan Apigee Edge untuk Cloud Pribadi, tidak memerlukan IdP eksternal. Fitur ini dapat menggunakan autentikasi IDP atau Dasar. Artinya, Anda dapat:

Mengaktifkan dukungan IdP eksternal di Edge dan di UI Klasik serta UI Edge.
Dalam skenario ini, semua pengguna UI Klasik dan UI Edge terdaftar di IdP. Untuk informasi tentang cara menambahkan pengguna baru ke IDP, lihat Mendaftarkan pengguna Edge baru.
Aktifkan dukungan IdP eksternal di Edge, tetapi biarkan Autentikasi dasar diaktifkan. UI Edge menggunakan IdP dan UI Klasik masih menggunakan Autentikasi dasar.
Dalam skenario ini, semua pengguna UI Klasik login dengan kredensial autentikasi Dasar, tempat kredensial mereka disimpan di database OpenLDAP Edge. Pengguna UI Edge terdaftar di IdP dan login menggunakan SAML atau LDAP.

Namun, pengguna UI Klasik tidak dapat login ke UI Edge sampai Anda menambahkan pengguna tersebut ke IDP seperti yang dijelaskan dalam Mendaftarkan pengguna Edge baru.

Perubahan konfigurasi penginstalan dari rilis sebelumnya

Perhatikan perubahan berikut pada prosedur penginstalan dari rilis Beta UI Edge.

Perubahan konfigurasi penginstalan dari Edge 4.18.05

Rilis UI Edge 4.51.00 berisi perubahan berikut pada file konfigurasi dari rilis Edge 4.18.05:

Jenis perubahan	Properti yang terpengaruh
Dihapus	MANAGEMENT_UI_SSO_PUBLIC_KEY_CACHE_HOURS Properti tersebut memiliki nilai standar 0,5 (30 menit) dan tidak dapat diubah.
Ditambahkan	Sekarang Anda dapat menggunakan properti untuk mengaktifkan TLS di UI Edge. Lihat Mengonfigurasi TLS untuk UI Edge untuk mengetahui informasi selengkapnya.

Jenis perubahan

Properti yang terpengaruh

Dihapus

MANAGEMENT_UI_SSO_PUBLIC_KEY_CACHE_HOURS

Properti tersebut memiliki nilai standar 0,5 (30 menit) dan tidak dapat diubah.

Ditambahkan

Sekarang Anda dapat menggunakan properti untuk mengaktifkan TLS di UI Edge. Lihat Mengonfigurasi TLS untuk UI Edge untuk mengetahui informasi selengkapnya.

Perubahan konfigurasi penginstalan dari Edge 4.18.01

Rilis UI Edge 4.51.00 berisi perubahan berikut pada file konfigurasi dari rilis Edge 4.18.01:

Jenis perubahan	Properti yang terpengaruh
Ditambahkan	# Shoehorn/Classic UI configurations. SHOEHORN_SCHEME SHOEHORN_IP SHOEHORN_PORT # Classic UI configurations. CLASSIC_UI_SCHEME CLASSIC_UI_IP CLASSIC_UI_PORT # Information about Edge SSO module. MANAGEMENT_UI_SKIP_VERIFY
Dihapus	ROUTES_SHOEHORN ROUTES_CLASSICUI
Diganti	MANAGEMENT_UI_USE_HTTPS Digantikan dengan: MANAGEMENT_UI_SCHEME

Jenis perubahan

Properti yang terpengaruh

Ditambahkan

# Shoehorn/Classic UI configurations.
SHOEHORN_SCHEME
SHOEHORN_IP
SHOEHORN_PORT

# Classic UI configurations.
CLASSIC_UI_SCHEME
CLASSIC_UI_IP
CLASSIC_UI_PORT

# Information about Edge SSO module.
MANAGEMENT_UI_SKIP_VERIFY

Dihapus

ROUTES_SHOEHORN
ROUTES_CLASSICUI

Diganti

MANAGEMENT_UI_USE_HTTPS

Digantikan dengan:

MANAGEMENT_UI_SCHEME

File konfigurasi UI Edge baru

File konfigurasi berikut berisi semua informasi yang diperlukan untuk menginstal dan mengonfigurasi UI Edge baru. Anda dapat menggunakan file konfigurasi yang sama untuk menginstal dan mengonfigurasi UI shoehorn/Klasik dan UI Edge.

# IP of the Edge Management Server.
# This node also hosts the Apigee SSO module and the current, or Classic, UI.
IP1=management_server_IP

# IP of the Edge UI node.
IP2=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

#
# Edge UI configuration.
#

# Enable the Edge UI.
EDGEUI_ENABLE_UNIFIED_UI=y
# Specify IP and port for the Edge UI.
# The management UI port must be open for requests to the Edge UI
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_IP=$IP2
# Set to 'OPDK' to specify a Private Cloud deployment.
MANAGEMENT_UI_APP_ENV=OPDK
# Disable TLS on the Edge UI.
MANAGEMENT_UI_SCHEME=http

# Location of Edge UI.
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT
MANAGEMENT_UI_SSO_REGISTERED_PUBLIC_URIS=$MANAGEMENT_UI_PUBLIC_URIS
MANAGEMENT_UI_SSO_CSRF_SECRET=YOUR_CSRF_SECRET
# Duration of CSRF token.
MANAGEMENT_UI_SSO_CSRF_EXPIRATION_HOURS=24
# Defaults to 8760 hours, or 365 days.
MANAGEMENT_UI_SSO_STRICT_TRANSPORT_SECURITY_AGE_HOURS=8760

## SSO configuration for the Edge UI.
MANAGEMENT_UI_SSO_ENABLED=y

# Only required if MANAGEMENT_UI_SSO_ENABLED is 'y'
MANAGEMENT_UI_SSO_CLIENT_OVERWRITE=y

MANAGEMENT_UI_SSO_CLIENT_ID=newueclient
MANAGEMENT_UI_SSO_CLIENT_SECRET=your_client_sso_secret

#
# Shoehorn UI configuration
#
# Set to http even if you enable TLS on the Edge UI.
SHOEHORN_SCHEME=http
SHOEHORN_IP=$MANAGEMENT_UI_IP
SHOEHORN_PORT=9000

#
# Edge Classic UI configuration.
# Some settings are for the Classic UI, but are still required to configure the Edge UI.
#

# These settings assume that Classic UI is installed on the Management Server.
CLASSIC_UI_IP=$MSIP
CLASSIC_UI_PORT=9000
CLASSIC_UI_SCHEME=http
EDGEUI_PUBLIC_URIS=$CLASSIC_UI_SCHEME://$CLASSIC_UI_IP:$CLASSIC_UI_PORT

# Information about publicly accessible URL for Classic UI.
EDGEUI_SSO_REGISTERED_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS

# Enable SSO
EDGEUI_SSO_ENABLED=y

# The name of the OAuth client used to connect to apigee-sso.
# The default client name is 'edgeui'.
# Apigee recommends that you use the same settings as you used
# when enabling your IDP on the Classic UI.
EDGEUI_SSO_CLIENT_NAME=edgeui
# Oauth client password using uppercase, lowercase, number, and special chars.
EDGEUI_SSO_CLIENT_SECRET=ssoClient123
# If set, existing EDGEUI client will deleted and new one will be created.
EDGEUI_SSO_CLIENT_OVERWRITE=y

# Apigee SSO Component configuration
# Externally accessible IP or DNS of Edge SSO module.
SSO_PUBLIC_URL_HOSTNAME=$IP1
SSO_PUBLIC_URL_PORT=9099
# Default is http. Set to https if you enabled TLS on the Apigee SSO module.
# If Apigee SSO uses a self-signed cert, you must also set MANAGEMENT_UI_SKIP_VERIFY to "y".
SSO_PUBLIC_URL_SCHEME=http
# MANAGEMENT_UI_SKIP_VERIFY=y
# SSO admin credentials as set when you installed Apigee SSO module.
SSO_ADMIN_NAME=ssoadmin
SSO_ADMIN_SECRET=your_sso_admin_secret

#
##      SSO Configuration (define external IDP)           #
#
# Use one of the following configuration blocks to        #
# define your IDP settings:                               #
#  - SAML configuration properties                        #
#  - LDAP Direct Binding configuration properties         #
#  - LDAP Indirect Binding configuration properties       #

INSERT_IDP_CONFIG_BLOCK_HERE (SAML, LDAP direct, or LDAP indirect)

## SMTP Configuration (required)
#
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.gmail.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 UI Edge

Setelah membuat dan mengubah file konfigurasi, Anda dapat menginstal UI Edge baru di node baru tersebut.

Untuk menginstal UI Edge:

Tambahkan node baru ke cluster Anda.
Login ke node baru sebagai administrator.
Instal utilitas apigee-setup versi 4.51.00 pada node, seperti yang dijelaskan di Menginstal utilitas penyiapan Edge.
Bersihkan semua informasi yang di-cache dengan Yum dengan menjalankan perintah berikut:
```
sudo yum clean all
```
Buat file konfigurasi seperti yang dijelaskan dalam file konfigurasi UI Edge Baru dan pastikan file tersebut dimiliki oleh pengguna "apigee":
```
chown apigee:apigee configFile
```
Pastikan Anda melakukan pengeditan berikut pada file konfigurasi:
- Ubah nilai properti MANAGEMENT_UI_SSO_CSRF_SECRET dalam file konfigurasi menjadi rahasia CSRF Anda.
  CATATAN: Jangan gunakan nilai default dalam contoh file konfigurasi di atas untuk rahasia CSRF Anda. Ubah ke nilai unik yang hanya Anda ketahui.
- Konfigurasikan Edge untuk menggunakan salah satu dari berikut ini (UI Edge baru memerlukan IdP eksternal):
  - SAML
  - LDAP
  Untuk informasi selengkapnya, lihat Ringkasan autentikasi IDP eksternal.
Konfigurasikan IdP eksternal dengan pengguna yang Anda inginkan untuk memiliki akses ke UI Edge. Untuk informasi selengkapnya, lihat Mendaftarkan pengguna Edge baru.
Pada node baru, jalankan perintah berikut:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile
```
Utilitas apigee-setup menginstal UI Klasik. Di atas UI Klasik, penginstal kemudian menginstal UI Edge.
Login ke UI Edge dengan membuka URL berikut di browser:
```
http://new_edge_UI_IP:3001
```
Dengan new_edge_UI_IP adalah alamat IP node yang menghosting UI Edge baru.

Edge akan meminta kredensial IdP eksternal Anda.
Masukkan kredensial Anda.
UI Edge baru akan muncul. Untuk informasi tentang cara menggunakan UI Edge, lihat UI Edge baru untuk Cloud Pribadi.

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

Meng-uninstal UI baru

Untuk meng-uninstal UI baru dari node-nya, Anda harus meng-uninstal UI Edge baru dan UI Klasik dasar (shoehorn) yang diinstal di node selama proses penginstalan UI.

Untuk meng-uninstal UI Edge baru:

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

Untuk meng-uninstal UI Klasik dasar (shoehorn):

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

Untuk menghapus semua komponen Edge dari node:

Hentikan semua layanan Edge yang berjalan di mesin:
```
/opt/apigee/apigee-service/bin/apigee-all stop
```
Menghapus cache yum:
```
sudo yum clean all
```

Hapus semua RPM Apigee:

sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")

Hapus direktori utama penginstalan:
```
sudo rm -rf /opt/apigee
```