Mengaktivasi organisasi

Edge for Private Cloud v. 4.17.09

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

Sebagai bagian dari proses orientasi, skrip:

  • Membuat organisasi.
  • Menetapkan pengguna yang ditentukan sebagai admin organisasi.
    • Pengguna ini harus berbeda dengan pengguna sys admin. Artinya, jangan gunakan pengguna admin sistem sebagai pengguna admin organisasi.
    • Anda dapat menentukan pengguna yang sudah ada untuk admin organisasi, atau mengonfigurasi skrip untuk membuat pengguna baru.
  • Mengaitkan organisasi dengan pod, secara default mengaitkannya dengan pod "gateway".
  • Buat lingkungan.
  • Membuat host virtual untuk lingkungan.
  • Kaitkan lingkungan dengan semua Message Processor.
  • Mengaktifkan analisis.

File konfigurasi untuk orientasi

Teruskan file konfigurasi ke perintah setup-org. Panggil perintah setup-org dan tentukan opsi -f, termasuk jalur ke file konfigurasi otomatis:

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

Satu-satunya persyaratan pada penginstalan otomatis adalah file konfigurasi harus dapat diakses atau dibaca oleh pengguna "apigee".

Berikut adalah contoh file konfigurasi otomatis. Edit seperlunya sesuai kebutuhan 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=adminPassword     # 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
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

# 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.

Prosedur orientasi

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

    File konfigurasi harus dapat diakses atau dibaca oleh pengguna "apigee".

Verifikasi 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 mengeluarkan perintah CURL 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/<orgname>/deployments
  2. Jika Anda mengaktifkan analisis, gunakan perintah ini:
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provisioning/axstatus
  3. Anda juga dapat memeriksa status database PostgreSQL dengan menjalankan perintah berikut di Mesin 2 untuk memulai psql:
    > psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    Pada command prompt, masukkan perintah berikut untuk melihat tabel analisis untuk organisasi Anda:
    apigee=# : \d analytics."<orgname>.prod.fact"

    Gunakan perintah berikut untuk keluar dari psql:
    apigee=# \q
  4. Akses antarmuka pengguna 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 akan mirip dengan berikut, di mana alamat IP adalah untuk Mesin 1, atau untuk mesin 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

      Catatan: Pastikan port 9000 terbuka.
    2. Di halaman login konsol, tentukan nama pengguna/sandi admin sistem Apigee.
      Catatan: Ini adalah sandi administrator sistem global yang telah Anda tetapkan selama penginstalan. Atau, Anda dapat:
  5. Daftar untuk mendapatkan akun pengguna Apigee baru dan gunakan kredensial pengguna baru untuk login.
    1. Klik Login, browser akan mengalihkan ke:
      http://192.168.56.111:9000/platform/#/<orgname>/

      dan membuka dasbor yang memungkinkan Anda mengonfigurasi organisasi yang dibuat sebelumnya (jika login menggunakan kredensial admin Apigee).
    2. Jika Anda baru menggunakan Edge, Anda kini dapat membuat proxy API pertama Anda. Untuk mengetahui informasi selengkapnya, lihat Membangun proxy API pertama Anda.

      Lihat juga bagian tentang contoh, termasuk Daftar contoh, dan RESTful API target tiruan yang dapat Anda gunakan dalam eksperimen pembuatan API Anda sendiri di Mock Target API.