Mengaktivasi organisasi

Edge for Private Cloud v4.18.05

Gunakan skrip setup-org untuk melakukan proses aktivasi. Anda harus menjalankan skrip di node Server Pengelolaan.

Untuk melakukan orientasi organisasi:

  1. Instal apigee-provision di node Server Pengelolaan: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. Jalankan skrip setup-org di node Server Pengelolaan: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    File konfigurasi harus dapat dibaca oleh pengguna "apigee". Untuk contoh file konfigurasi, lihat File konfigurasi orientasi.

  3. Pastikan Anda telah berhasil melakukan orientasi organisasi. Salah satu cara untuk melakukannya adalah dengan login ke UI dengan meminta URL berikut di browser: 
    http://IP_address:9000/login

    Dengan IP_address adalah alamat IP server tempat Anda menginstal UI Edge.

    Untuk langkah-langkah verifikasi tambahan, lihat Memverifikasi aktivasi.

  4. Buat proxy pertama Anda

File konfigurasi aktivasi

Untuk melakukan konfigurasi otomatis dengan skrip setup-org, teruskan file konfigurasi dengan opsi -f, seperti yang ditunjukkan contoh berikut:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

Bagian ini menyertakan contoh file konfigurasi untuk melakukan orientasi organisasi dengan setup-org.

Saat melakukan orientasi organisasi, skrip setup-org akan melakukan hal berikut:

  • Membuat organisasi baru.
  • Membuat lingkungan.
  • Membuat host virtual untuk lingkungan.
  • Menetapkan pengguna yang ditentukan sebagai admin organisasi. Perhatikan bahwa:
    • Anda dapat menggunakan pengguna yang sudah ada atau membuat pengguna baru untuk admin organisasi.
    • Admin organisasi tidak boleh sama dengan admin sistem.
  • Mengaitkan organisasi dengan pod "gateway". (Ini adalah setelan default dan tidak dapat diubah.)
  • Mengaitkan lingkungan dengan semua Message Processor.
  • Mengaktifkan analisis.

Salin contoh berikut dan edit seperlunya untuk mengaktivasi organisasi Anda:

IP1=192.168.1.1

# Specify the IP or DNS name of the Management Server.
MSIP="$IP1"

# Specify the Edge sys admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=admin_password  # If omitted, you are prompted for it.

# Specify organization name.
ORG_NAME=myorg  # lowercase only, no spaces, underscores, or periods.

# Specify the organization administrator user.
# Either specify an existing user, or specify the information
# necessary to create a new user.
# Do not use the sys admin as the organization administrator.
#
# Create a new user for the organization administrator.
NEW_USER="y"
# New user information if NEW_USER="y".
USER_NAME=new@user.com
FIRST_NAME=new
LAST_NAME=user
# Org admin password must be at least 8 characters long and contain one uppercase
# letter, one lowercase letter, and one digit or special character
USER_PWD="newUserPword"
ORG_ADMIN=new@user.com
#
# Or, specify an existing user as the organization admin,
# omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD.
# NEW_USER="n"
# ORG_ADMIN=existing@user.com

# Specify environment name.
ENV_NAME=prod  # lowercase only

# Specify virtual host information.
VHOST_PORT=9001
VHOST_NAME=default

# If you have a DNS entry for the virtual host.
VHOST_ALIAS=myorg-test.apigee.net

# If you do not have a DNS entry for the virtual host,
# specify the IP and port of each router as a space-separated list:
# VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001"

# Optionally configure TLS/SSL for virtual host.
# VHOST_SSL=y     # Set to "y" to enable TLS/SSL on the virtual host.
# KEYSTORE_JAR=   # JAR file containing the cert and private key.
# KEYSTORE_NAME=  # Name of the keystore.
# KEYSTORE_ALIAS= # The key alias.
# KEY_PASSWORD=   # The key password, if it has one.

# Specify the analytics group.
# AXGROUP=axgroup-001 # Default name is axgroup-001.

Catatan:

  • Untuk VHOST_ALIAS, jika Anda sudah memiliki data DNS yang akan digunakan untuk mengakses host virtual, tentukan alias host dan port secara opsional, misalnya, "myapi.example.com". Jika belum memiliki data DNS, Anda dapat menggunakan alamat IP Router.

    Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi host virtual, lihat Menyiapkan host virtual.

  • Untuk konfigurasi TLS/SSL, lihat Keystore dan Truststore serta Mengonfigurasi akses TLS ke API untuk cloud pribadi guna mengetahui informasi selengkapnya tentang cara membuat file JAR, dan aspek lain dalam mengonfigurasi TLS/SSL.
  • Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi host virtual, lihat Mengonfigurasi akses TLS ke API untuk cloud pribadi.
  • Anda tidak dapat membuat dua organisasi dengan nama yang sama. Dalam hal ini, pembuatan kedua akan gagal.

Untuk mengetahui informasi selengkapnya tentang cara menggunakan Management API untuk melakukan aktivasi organisasi, lihat Membuat organisasi, lingkungan, dan host virtual.

Memverifikasi orientasi

Setelah menyelesaikan orientasi, verifikasi status sistem dengan mengeluarkan perintah CURL berikut pada node Server Pengelolaan:

  1. Periksa status pengguna dan organisasi di Server Pengelolaan dengan menjalankan perintah berikut: 
    curl -u adminEmail:admin_passwd http://localhost:8080/v1/users
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations/org_name/deployments
  2. Periksa analisis dengan menjalankan perintah berikut: 
    curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
  3. Periksa status database PostgreSQL dengan menjalankan perintah berikut di Node 2 (seperti yang ditunjukkan dalam topologi penginstalan): 
    psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    Pada command prompt, masukkan perintah berikut untuk melihat tabel analisis untuk organisasi Anda:

    \d analytics."org_name.env_name.fact"

    Gunakan perintah berikut untuk keluar dari psql:

    \q
  4. Akses UI Apigee Edge menggunakan browser web. Ingat bahwa Anda telah mencatat URL konsol pengelolaan di akhir penginstalan.
    1. Luncurkan browser pilihan Anda dan masukkan URL UI Edge. Tampilannya mirip dengan berikut, di mana alamat IP adalah untuk Node 1 (seperti yang ditunjukkan dalam topologi penginstalan), atau node mana pun tempat Anda menginstal UI untuk konfigurasi alternatif: 
      http://192.168.56.111:9000/login

      9000 adalah nomor port yang digunakan oleh UI.

      Jika Anda memulai browser langsung di server yang menghosting UI Edge, Anda dapat menggunakan URL dalam bentuk: 

      http://localhost:9000/login
    2. Di halaman login konsol, tentukan nama pengguna/sandi admin sistem Apigee.
  5. Daftar untuk mendapatkan akun pengguna Apigee baru dan gunakan kredensial pengguna baru untuk login. Di halaman login konsol, klik tombol Sign In.

    Browser akan mengalihkan ke http://192.168.56.111:9000/platform/#/org_name/ dan membuka dasbor yang memungkinkan Anda mengonfigurasi organisasi yang Anda buat (jika Anda login menggunakan kredensial admin Apigee).

Membuat proxy pertama Anda

Setelah melakukan aktivasi organisasi baru dan memverifikasi bahwa proses aktivasi berhasil, Anda kini dapat membuat proxy pertama. Untuk mengetahui informasi selengkapnya, lihat Membangun proxy API pertama Anda.

Referensi lain yang mungkin berguna bagi Anda meliputi: