Para Kazanma Hizmetlerini Yükleme

Edge for Private Cloud v. 4.17.01

Monetization Services, Apigee Edge'in bir uzantısı olduğundan bağımsız bir süreç olarak çalışmaz. Mevcut herhangi bir Apigee Edge kurulumunda çalışır.

Para kazanma koşulları

  • 13 düğümlü yükleme gibi birden fazla Yönetim Sunucusu düğümü kullanan bir Edge topolojisine Para Kazanma'yı yüklüyorsanız Monetization'ı yüklemeden önce her iki Uç Yönetim Sunucusu düğümünü de yüklemeniz gerekir.
  • Uç yüklemenin birden fazla Postgres düğümüne sahip olduğu Uçta Para Kazanma özelliğini yüklemek için Postgres düğümlerinin Ana/Bekleme modunda yapılandırılması gerekir. Birden fazla Postgres ana düğümünüz varsa Edge'de Para Kazanma'yı yükleyemezsiniz. Daha fazla bilgi için Edge Apigee-setup yardımcı programını yükleme konusuna bakın.

Yüklemeye genel bakış

Aşağıdaki adımlarda, mevcut Apigee Edge kurulumuna Para Kazanma Hizmetleri'nin nasıl ekleneceği gösterilmektedir:

  • Para Kazanma Hizmetleri'ni (ör. katalog yönetimi, sınırlar ve bildirim yapılandırması, faturalandırma ve raporlama) etkinleştirmek için Apigee Yönetim Sunucusu düğümünü güncellemek üzere apigee-setup yardımcı programını kullanın.

    13 düğümlü yükleme gibi birden fazla Yönetim Sunucusu düğümünüz varsa Monetization'ı yüklemeden önce her iki Edge Yönetim Sunucusu düğümünü de yüklemeniz gerekir.
  • Para Kazanma Hizmetleri'nin çalışma zamanı bileşenlerini (ör. işlem kaydetme politikası ve sınır uygulama) etkinleştirmek için Apigee Mesaj İşleyici'yi güncellemek amacıyla apigee-setup yardımcı programını kullanın. Birden fazla Mesaj İşleyiciniz varsa hepsine Para Kazanma'yı yükleyin.
  • Edge kuruluşlarınız için Para Kazanma'ya ilk katılım sürecini gerçekleştirin.
  • Geliştirici Hizmetleri portalını para kazanma özelliğini destekleyecek şekilde yapılandırın. Daha fazla bilgi için http://apigee.com/docs/monetization/content/configure-monetization-developer-portal adresine bakın.

Para Kazanma için sessiz bir yapılandırma dosyası oluşturma

Aşağıda, Monetization kurulumu için örnek bir sessiz yapılandırma dosyası gösterilmektedir. Bu dosyayı yapılandırmanız için gereken şekilde düzenleyin. Bu dosyayı eklemek üzere setup.sh dosyasını eklemek için -f seçeneğini kullanın.

Not: Bu özellikleri genellikle Düğüme Edge bileşenlerini yükleme bölümünde gösterildiği gibi, Edge'i yüklemek için kullandığınız yapılandırma dosyasına eklersiniz.

# Edge configuration properties
# Specify IP address or DNS name of node.
IP1=192.168.1.1  # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra
IP2=192.168.1.2  # ZooKeeper, Cassandra
IP3=192.168.1.3  # ZooKeeper, Cassandra
IP4=192.168.1.4  # Router, Message Processor
IP5=192.168.1.5  # Router, Message Processor
IP6=192.168.1.6  # Qpid
IP7=192.168.1.7  # Qpid
IP8=192.168.1.8  # Postgres
IP9=192.168.1.9  # Postgres

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

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

# Specify the Management Server port.
APIGEE_PORT_HTTP_MS=8080

#
# Monetization configuration properties.
#
# Postgres credentials from Edge installation.
PG_USER=apigee    # Default from Edge installation
PG_PWD=postgres    # Default from Edge installation

# Specify Postgres server.
MO_PG_HOST="$IP8"    # Only specify one Postgres node.

# Create a Postgres user for Monetization.
# Default username is "postgre". 
# If you specify a different user, that user must already exist.
MO_PG_USER=postgre    
MO_PG_PASSWD=moUserPWord

# Specify one ZooKeeper host.
# Ensure this is a ZooKeeper leader node in a multi-datacenter environment.
ZK_HOSTS="$IP2"

# Specify Cassandra information.
# Ensure CASS_HOSTS is set to the same value as when you installed Edge.
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"

# Default is "Apigee", unless it was changed during Edge install.  
CASS_CLUSTERNAME=Apigee

# Cassandra uname/pword required only if you enabled Cassandra authentication. 
# CASS_USERNAME= 
# CASS_PASSWORD= 

# Specify the region. 
# Default is dc-1 unless you are in a multi-datacenter environment. 
REGION=dc-1 

# If your Edge config file did not specify SMTP information, add it. 
# Monetization requires an SMTP server. 
SMTPHOST=smtp.gmail.com 
SMTPPORT=465 
SMTPUSER=your@email.com 
SMTPPASSWORD=yourEmailPassword 
SMTPSSL=y
Notlar:
  • Edge yapılandırma dosyanızda SMTP bilgileri belirtilmemişse dosyayı ekleyin. Para kazanma özelliği için SMTP sunucusu gerekir.
  • Tek bir veri merkezi kurulumunda, tüm ZooKeeper düğümleri varsayılan olarak lider şeklinde yapılandırılır. Edge'i birden fazla veri merkezine yüklerken bazı ZooKeeper düğümleri gözlemci olarak yapılandırılır. Yukarıdaki ZK_HOSTS özelliğinin, çoklu veri merkezi kurulumunda öncü düğüm belirttiğinden emin olun.
  • Cassandra kimlik doğrulamasını etkinleştirirseniz aşağıdaki özellikleri kullanarak Cassandra kullanıcı adını ve şifresini iletebilirsiniz:
    CASS_USERNAME
    CASS_PASSWORD

Para Kazanma Hizmetleri'ni tüm yönetim sunucularıyla entegre edin

Yönetim Sunucusu düğümlerinde para kazanma özelliğini entegre etmek için aşağıdaki prosedürü kullanın.

  1. Para Kazanma özelliğini, 13 düğümlü yükleme gibi birden fazla Yönetim Sunucusu düğümü kullanan bir Edge topolojisine yüklüyorsanız Para Kazanma'yı yüklemeden önce her iki Yönetim Sunucusu düğümünü de yüklediğinizden emin olun.
  2. Yönetim Sunucusu düğümünde kurulum komut dosyasını çalıştırın:
    > /opt/../..//Apigee-setup/bin/setup.sh -p mo -f configFile

    "-p mo" seçeneği, Para kazanmanın entegre edilmesini belirtir.

    Yapılandırma dosyası, "Apigee" kullanıcısı tarafından erişilebilir ve okunabilir olmalıdır.
  3. Para Kazanma özelliğini birden fazla Yönetim Sunucusu düğümüne yüklüyorsanız ikinci Yönetim Sunucusu düğümünde 2. adımı tekrarlayın.

Başarılı yapılandırmada, PostgreSQL veritabanında Para Kazanma Hizmetleri için bir RDBMS şeması oluşturulur. Bu işlem, Para Kazanma Hizmetleri'nin ve ilişkili bileşenlerinin Postgres Sunucusu ile entegrasyonunu tamamlar.

Para Kazanma Hizmetleri'ni tüm Mesaj İşleyicilere entegre edin

Para kazanmayı tüm Mesaj İşleyici düğümlerine entegre etmek için aşağıdaki prosedürü kullanın.

  1. İlk Mesaj İşleyen düğümünde, komut isteminde kurulum komut dosyasını çalıştırın:
    > /opt/../..//Apigee-setup/bin/setup.sh -p mo -f configFile

    "-p mo" seçeneği, Para Kazanma'nın entegre edilmesini belirtir.

    Yapılandırma dosyası, "Apigee" kullanıcısı tarafından erişilebilir ve okunabilir olmalıdır.
  2. Bu prosedürü tüm İleti İşleyici düğümlerinde tekrarlayın.

Başarılı yapılandırma sonrasında Mesaj İşleyici, Para Kazanma Hizmetleri ile güncellenir. Bu işlem, Para Kazanma Hizmetleri'nin ve ilişkili bileşenlerinin Mesaj İşleyiciler ile entegrasyonunu tamamlar.

Para Kazanma Özelliğine İlk Katılım

Para kazanma özelliğinin etkin olduğu yeni bir kuruluş oluşturmak için önce kuruluşu herhangi bir yeni kuruluşta yapacağınız şekilde oluşturmanız gerekir. Daha fazla bilgi için Kuruluşa katılma başlıklı makaleyi inceleyin.

Kuruluşlarda para kazanma özelliğini etkinleştirmek için ek ilk katılım

Kuruluşların para kazanmaya ilk katılım sürecini tamamlamak için şunları yapmanız gerekir:

  1. Şu para kazanma grubunu oluşturun: mxgroup.
  2. Gruba Qpid ekleyin.
  3. Kuruluş için para kazanma özelliğini etkinleştirin.
  4. Kuruluş için bildirim ayarlarını etkinleştirin.
  5. Para Kazanma özelliğini etkinleştirmek istediğiniz tüm kuruluşlar için bu işlemi tekrarlayın.

Bu görevlerin tümünü gerçekleştirmek için enable-monetization komutunu kullanın. Bu komut dosyası, aşağıdaki özellikleri içeren bir yapılandırma dosyası alır:

MSIP=IPorDNSofManagementServer
APIGEE_PORT_HTTP_MS=8080    # Default is 8080.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=yourPassword    # If omitted, you are prompted for it.
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"
# Space-separated list IP/DNS names of all Qpid nodes in the data center being configured.
QPID_HOST="$IP6 $IP7"    
QPID_PORT=8083     # Default is 8083.
REGION=dc-1
ORG_NAME=myorg    # The Edge org where you want to enable monetization. 
MX_GROUP=mxgroup    # Default Monetization group.

Notes:

  • CASS_HOSTS ve REGION değerlerini Para Kazanma'yı yüklerken kullandığınız değerlerle aynı olacak şekilde ayarlayın.
  • Para kazanma özelliğini birden çok veri merkezi yapılandırmasında etkinleştiriyorsanız:
    • İlk katılım işlemini her veri merkezindeki Yönetim Sunucusu'nda tekrarlamanız gerekir.
    • Yapılandırma dosyası, yalnızca yapılandırılmakta olan veri merkezindeki Qpid düğümlerini listelemelidir.

Komut dosyasını çalıştırmak için:

  1. Şu komut dosyasını çağırın:
    > /opt/../..//Apigee-service/bin/Apigee-service Apigee- prensibi-enable-monetization -f configFile

    Yapılandırma dosyası, "Apigee" kullanıcısı tarafından erişilebilir veya okunabilir olmalıdır.

    Birden fazla Yönetim Sunucunuz varsa bu komut dosyasını bunlardan yalnızca birinde çalıştırmanız gerekir.

    Bu komut dosyası; kuruluşu, ürünleri, geliştiricileri ve uygulamaları Cassandra veritabanından Monetization PostgreSQL veritabanına çoğaltır. Para Kazanma Hizmetleri başarıyla yüklendikten sonra veriler otomatik olarak senkronize edilir.
  2. Para kazanma özelliğini etkinleştirmek istediğiniz her kuruluş için bu prosedürü tekrarlayın.
  3. Birden fazla veri merkezi ortamındaysanız bu işlemi diğer veri merkezindeki Yönetim Sunucusu'nda tekrarlayın. Yapılandırma dosyasının yalnızca yapılandırılmakta olan veri merkezindeki Qpid düğümlerini listelediğinden emin olun.

Edge kullanıcı arayüzüne bir sonraki giriş yaptığınızda, kuruluşun üst düzey menüsünde Para Kazanma girişini görürsünüz:

Geliştirici Hizmetleri portalını yapılandırma

Geliştirici Hizmetleri portalını para kazanmayı destekleyecek şekilde yapılandırmak için http://apigee.com/docs/monetization/content/configure-monetization-developer-portal adresini ziyaret edin.

Para Kazanma Yüklemesine Yönetim Sunucusu düğümü ekleme

Mevcut bir uç kurulumuna Yönetim Sunucusu eklerseniz yeni Yönetim Sunucusu'na Para Kazanma hizmetleri eklediğinizden ve tüm Yönetim Sunucularını iletişim kurabilecekleri şekilde yapılandırdığınızdan emin olun.

Yönetim Sunucusu eklemek için:

  1. Yeni Yönetim Sunucusu'nu yükleyin.
  2. Yeni Yönetim Sunucusu'na Para Kazanma'yı yükleyin.
  3. Orijinal Yönetim Sunucusu'nda şu çağrıyı yapın:
    > /opt/../..//Apigee-service/bin/Apigee-service Edge-mint-management-server mint-configure-mgmt-cluster
  4. Orijinal Yönetim Sunucusu'nu yeniden başlatın:
    > /opt/../..//Apigee-service/bin/Apigee-service kenar-management-server yeniden başlatma
  5. new Yönetim Sunucusu'nda şu çağrıyı yapın:
    > /opt/../..//become-service/bin/Apigee-service Edge-mint-management-server mint-configure-mgmt-cluster
  6. Yeni Yönetim Sunucusu'nu yeniden başlatın:
    > /opt/../..//Apigee-service/bin/Apigee-service kenar-management-server yeniden başlatma

Ek yapılandırma

Faturalandırma Belgelerini PDF Dosyaları Olarak Sağlayın

Para Kazanma, faturalandırma dokümanlarını son kullanıcılara HTML biçiminde gösterir. Faturalandırma belgelerini PDF dosyası olarak sağlamak için Monetization'ı PDF oluşturma olanağı sunan bir faturalandırma sistemiyle entegre edebilir veya desteklenen bir üçüncü taraf PDF kitaplığını lisanslayabilirsiniz.

Kuruluş Ayarlarını Yapılandırın

Arka uç ayarları: Aşağıdaki tabloda, bir mint kuruluşu yapılandırmak için kullanılabilecek kuruluş düzeyindeki özellikler listelenmiştir. Bu özellikleri aşağıda gösterildiği gibi eklemek/güncellemek için bir PUT çağrısı kullanabilirsiniz:

> curl -u ${ADMIN_EMAIL}:${ADMINPW} -v http://<management-ip>:8080/v1/organizations/{orgId} -d '{org object with attributes}' -X PUT

Örneğin, yukarıdaki CURL komutunun çıkışı aşağıdaki gibi görünür:

{
...
    "displayName": "Orgnization name",
    "name": "org4",
    "properties": {
        "property": [
...
            {
                "name": "MINT_CURRENCY",
                "value": "USD"
            },
            {
                "name": "MINT_COUNTRY",
                "value": "US"
            },
            {
                "name": "MINT_TIMEZONE",
                "value": "GMT"
            }
        ]
    }
}

Özellikler

Açıklama

MINT_TAX_MODEL

Kabul edilen değerler DISCLOSED,

UNDISCLOSED, HYBRID (varsayılan değer boştur)

MINT_CURRENCY

ISO para birimi kodu (varsayılan değer boştur)

MINT_TAX_NEXUS

Vergi bağlantı noktası (varsayılan değer boştur)

MINT_DEFAULT_PROD_TAX_CATEGORY

Varsayılan ürün vergi kategorisi (varsayılan değer boştur)

MINT_IS_GROUP_ORG

GP grubu kuruluşu (varsayılan değer "false"tur)

MINT_HAS_BROKER

Bozuk (varsayılan değer yanlıştır)

MINT_TIMEZONE

Saat dilimi (varsayılan değer null)

MINT_TAX_ENGINE_EXTERNAL_ID

Vergi motoru kimliği (varsayılan değer, boştur)

MINT_COUNTRY

Kuruluşun ülkesi (varsayılan değer boştur)

MINT_REG_NO

Kuruluşun tescil numarası, Birleşik Krallık'ta vergi numarasından farklı bir numara verilir (varsayılan değer boştur)

MINT_BILLING_CYCLE_TYPE

PRORATED, CALENDAR_MONTH (varsayılan değer: CALENDAR_MONTH)

MINT_SUPPORTED_BILLING_TYPE

ÖN ÖDENDİ/Sonradan Ödenmiş/İKİ (varsayılan, ÖN ÖDENDİ)

MINT_IS_SEPARATE_INV_FOR_FEES

Ayrı bir ücret faturasının oluşturulup oluşturulmayacağını belirtir (varsayılan değer "yanlış)"

MINT_ISSUE_NETTING_STMT

Ağ ifadesinin yayınlanıp yayınlanmayacağını belirtir (varsayılan değer yanlıştır)

MINT_NETTING_STMT_PER_CURRENCY

Ağ ifadesinin para birimi başına oluşturulup oluşturulmayacağını belirtir (varsayılan değer "yanlış"tır)

MINT_HAS_SELF_BILLING

Kuruluşun kendi kendine faturalandırma kullanıp kullanmadığını belirtir (varsayılan değer yanlıştır)

MINT_SELF_BILLING_FOR_ALL_DEV

Kuruluşun tüm geliştiriciler için self servis faturalandırma kullanıp kullanmadığını belirtir(varsayılan değer "false"tur)

MINT_HAS_SEPARATE_INV_FOR_PROD

Kuruluşun her ürün için ayrı faturası olup olmadığını belirtir (varsayılan değer "false")

MINT_HAS_BILLING_ADJUSTMENT

Kuruluşun fatura ayarlamalarını destekleyip desteklemediğini belirtir (varsayılan değer yanlıştır)

features.isMonetizationEnabled

Para kazanmaya özel menüyü görüntülemek için yönetim kullanıcı arayüzü tarafından kullanılır (varsayılan değer yanlıştır)

ui.config.isOperator

Sağlayıcı - Kuruluş yerine Operatör olarak görüntülemek için yönetim kullanıcı arayüzü tarafından kullanılır

(varsayılan değer, doğrudur)

Yönetim kullanıcı arayüzünü kullanarak işletme kuruluş ayarlarını yapılandırmak için http://apigee.com/docs/monetization-services/content/get-started-using-monetization-services adresini ziyaret edin.

Not: Para Kazanma Hizmet Sınırları ve Bildirim özelliklerini kullanıyorsanız geliştiricilerinize, erişim jetonu doğrulama politikasından sonra proxy akışına bir Sınır Politikası eklemeleri yönünde talimat verin.

Sınır Politikası, belirli bir sınıra ulaşıldığında API çağrısını engellemek için tasarlanmış açık bir politikadır. Politika, işletme sınırlarını kontrol eder ve yapılandırılmış değeri aşan sınırlar varsa hata verir. Bu, hata artırma politikasının bir uzantısıdır ancak koşullar, işletme değişkenlerinden türetilir.

Proxy geliştiricileri için yönetim kullanıcı arayüzünde bir kullanıcı arayüzü şablonu mevcuttur. Proxy geliştiricisi, mesaj akışına mint politikası eklemelidir. Bu politika uygulandıktan sonra politikaya göre hata yanıtı ile birlikte hata bildirilecek. ContinueOnError Doğru değerine ayarlanırsa hata bildirilmez ve "mint.limitsViolated", "mint.isDevelopersuspended" ve "mint.limitsPolicyError" değişkenleri ayarlanır. Bunlar, gerekirse daha ayrıntılı istisna yönetimi için kullanılabilir.