Para Kazanma Hizmetlerini Yükleme

Edge for Private Cloud s. 4.17.01

Para Kazanma Hizmetleri, Apigee Edge'in bir uzantısı olduğundan bağımsız olarak çalışmaz bahsedeceğim. Mevcut Apigee Edge kurulumlarında çalışır.

Para kazanma koşulları

  • Para kazanma özelliğini çoklu yönetim sunucusu kullanan bir uç topolojiye yüklüyorsanız Düğümleri (ör. 13 düğümlü kurulum) yüklemeniz durumunda yapmanız gerekir.
  • Edge yüklemesinin birden fazla Postgres düğümüne sahip olduğu Edge'de Monetization'ı yüklemek için Postgres düğümleri Ana/Bekleme modunda yapılandırılmalıdır. Para kazanma özelliğini yükleyemezsiniz birden fazla Postgres ana düğümünüz varsa Edge'i kullanabilirsiniz. Daha fazla bilgi için Edge Apigee-setup yardımcı programını yükleme bölümüne bakın.

Yüklemeye genel bakış

Aşağıdaki adımlar, mevcut bir Apigee Edge'e Para Kazanma Hizmetleri'nin nasıl ekleneceğini göstermektedir kurulum:

  • Apigee-setup kullanma para Kazanma Hizmetleri'ni etkinleştirmek üzere Apigee Yönetim Sunucusu düğümünü güncelleme yardımcı programını, Örneğin, katalog yönetimi, sınırlar ve bildirim yapılandırması, faturalandırma ve raporlama.
    .
    . 13 düğümlü kurulum gibi birden fazla Yönetim Sunucusu düğümünüz varsa Para Kazanma'yı yüklemeden önce her iki Uç Yönetim Sunucusu düğümünü de yükleyin.
  • Apigee-setup kullanma yardımcı programını kullanarak Apigee Mesaj İşlemcisini güncellemek için Para Kazanma Hizmetleri (ör. işlem kaydetme politikası ve sınır yaptırımı). Şu durumda: Birden fazla Mesaj İşleyiciniz varsa hepsine Para Kazanma uygulamasını 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 bkz. http://apigee.com/docs/monetization/content/configure-monetization-developer-portal.

Şunun için sessiz bir yapılandırma dosyası oluşturuluyor: Para kazanma

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

Not: Bu özellikleri genellikle Edge'yi Yükle" bölümünde gösterildiği gibi, Edge'i yüklemek için kullandığınız bir düğümdeki bileşenlerin birbirinden farklı olması gerekir.

# 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 bu bilgileri ekleyin. Para kazanmak için gerekenler: SMTP sunucusu.
  • Tek bir veri merkezi yüklemesinde, tüm ZooKeeper düğümleri varsayılan olarak liderler. Edge'i birden fazla veri merkezine yüklerken bazı ZooKeeper düğümleri yapılandırılmalıdır. Yukarıdaki ZK_HOSTS özelliğinin birden çok veri merkezi kurulumuna değinmelisiniz.
  • Cassandra kimlik doğrulamasını etkinleştirirseniz Cassandra kullanıcı adı ve şifresini iletebilirsiniz. aşağıdaki özellikleri kullanarak:
    CASS_USERNAME
    CASS_PASSWORD

Para Kazanma Hizmetlerini Entegre Etme tüm Yönetim Sunucuları ile

Yönetim Sunucusu düğümlerine para kazanmayı entegre etmek için aşağıdaki prosedürü kullanın.

  1. Para Kazanma'yı çoklu Yönetim Sunucusu kullanan bir Uç topolojisine yüklüyorsanız düğümlerini kurmalısınız, ardından her iki Yönetim Sunucusu'nu da yüklediğinizden emin olun. düğümleri kontrol edin.
  2. Yönetim Sunucusu düğümünde kurulum komut dosyasını çalıştırın:
    > /opt/Apigee/Apigee-setup/bin/setup.sh -p mo -f configFile

    . "-p mo" seçeneği, Para Kazanma'nın entegre edilip edilmeyeceğini belirtir.
    .
    . Yapılandırma dosyası "Apigee" tarafından erişilebilir veya okunabilir olmalıdır belirtir.
  3. Para Kazanma özelliğini birden fazla Yönetim Sunucusu düğümüne yüklüyorsanız şurada 2. adımı tekrarlayın: ikinci Yönetim Sunucusu düğümünü kullandı.

Başarılı yapılandırmanın ardından, PostgreSQL veritabanı. Böylece, Para Kazanma Hizmetleri ve ilişkili raporlamasına da olanak tanır.

Para Kazanma Hizmetlerini Entegre Etme tüm Mesaj İşleyicilerle

Para kazanma özelliğini tüm İleti İşleyenlere entegre etmek için aşağıdaki prosedürü kullanın düğüm.

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

    . "-p mo" seçeneği, Para Kazanma'nın entegre edilip edilmeyeceğini belirtir.
    .
    . Yapılandırma dosyası "Apigee" tarafından erişilebilir veya okunabilir olmalıdır belirtir.
  2. Bu prosedürü tüm İleti İşleyici düğümlerinde tekrarlayın.

Yapılandırma başarılı olduğunda Mesaj İşleyici, Para Kazanma Hizmetleri ile güncellenir. Bu Para Kazanma Hizmetleri'nin ve ilişkili bileşenlerinin Mesaj ile entegrasyonunu tamamlar İşlemciler.

Para Kazanmaya İlk Katılım

Para kazanma özelliğinin etkin olduğu yeni bir kuruluş oluşturmak için öncelikle kuruluşu aynı şekilde faydalı olabilir. Daha fazla bilgi için Kuruluşta ilk katılım başlıklı makaleyi inceleyin.

Bir kuruluş için Para Kazanma özelliğini etkinleştirmek için ek ilk katılım

Bir kuruluşun para kazanma özelliğine ilk katılım işlemini tamamlamak için şunları yapmanız gerekir:

  1. Para kazanma grubunu oluşturun: mxgroup.
  2. Qpid'i gruba ekleyin.
  3. Kuruluş için para kazanma özelliğini etkinleştirmek.
  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.

enable-monetization komutunu kullanmanız gerekir. Bu komut dosyası, şu özellikleri kullanın:

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.

Notlar:

  • CASS_HOSTS olarak ayarla ve REGION alanıyla aynı değerlere kullandığınız paranın karşılığını alırsınız.
  • Para kazanma özelliğini birden fazla veri merkezi yapılandırmasında etkinleştiriyorsanız:
    • Yönetim Sunucusu'nda her veri için ilk katılım işlemini tekrarlamanız gerekir yardım etmek istiyorum.
    • Yapılandırma dosyası, yalnızca çalıştırılmakta olan veri merkezindeki Qpid düğümlerini yapılandırıldı.

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

  1. Komut dosyasını çağırın:
    > /opt/Apigee/Apigee-service/bin/potansiyel-service connector-onay etkinleştirin-monetization -f configFile

    . Yapılandırma dosyası "Apigee" tarafından erişilebilir veya okunabilir olmalıdır belirtir.
    .
    . Birden fazla Yönetim Sunucunuz varsa bu komut dosyasını yalnızca bu sunuculardan birinde çalıştırmanız gerekir.
    .
    . Bu komut dosyası Cassandra'nın kuruluşunu, ürünlerini, geliştiricileri ve uygulamalarını çoğaltır veritabanından Monetization PostgreSQL veritabanına. Para Kazanma'yı başarıyla yükledikten sonra Hizmetlerde 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 çok veri merkezi ortamındaysanız bu işlemi Yönetim Sunucu diğer veri merkezinde. Yapılandırma dosyasının yalnızca yapılandırılıyor.

Edge kullanıcı arayüzünde bir sonraki oturum açışınızda fayda sağlar:

Geliştiriciyi yapılandırma Hizmetler portalı

Geliştirici Hizmetleri portalını para kazanma özelliğini destekleyecek şekilde yapılandırmak için http://apigee.com/docs/monetization/content/configure-monetization-developer-portal adresini ziyaret edebilirsiniz.

Yönetim Sunucusu düğümü ekleme para kazanma kurulumuna

Mevcut bir Edge kurulumuna Yönetim Sunucusu eklerseniz yeni Yönetim Sunucusu'na para kazanma hizmetlerini aktarabilir ve tüm Yönetim Sunucularını yapılandırarak iletişim kurabiliyoruz.

Yönetim Sunucusu eklemek için:

  1. Yeni Yönetim Sunucusu'nu yükleyin.
  2. Para Kazanma'yı yeni Yönetim Sunucusu'na yükleyin.
  3. Orijinal Yönetim Sunucusu'nda aşağıdaki komutu çalıştırın:
    > /opt/Apigee/Apigee-service/bin/potansiyel-service Edge-mint-management-server mint-configure-mgmt-cluster
  4. Orijinal Yönetim Sunucusu'nu yeniden başlatın:
    > /opt/Apigee/Apigee-service/bin/potansiyel-service Edge-management-server restart
  5. Yeni Yönetim Sunucusu'nda aşağıdaki komutu çalıştırın:
    > /opt/Apigee/Apigee-service/bin/potansiyel-service Edge-mint-management-server mint-configure-mgmt-cluster
  6. Yeni Yönetim Sunucusu'nu yeniden başlatın:
    > /opt/Apigee/Apigee-service/bin/potansiyel-service Edge-management-server restart

Ek yapılandırma

Faturalandırma belgelerini şu şekilde sağlayın: PDF Dosyaları

Para kazanma özelliği, fatura belgelerini son kullanıcılara HTML biçiminde gösterir. Faturalandırma hizmeti sunmak için PDF dosyası olarak PDF haline getirerek, Monetization'ı PDF dosyası sunan bir faturalandırma sistemine entegre edebilirsiniz. desteklenen bir üçüncü taraf PDF kitaplığı oluşturma veya lisanslama.

Kuruluşu Yapılandırma Ayarlar

Arka uç ayarları: Aşağıdaki tabloda kuruluş düzeyindeki özellikler listelenmektedir. yapılandırmanın ne anlama geldiğini ele alacağız. Bunları eklemek/güncellemek için bir PUT çağrısı kullanabilirsiniz özellikleri aşağıda gösterildiği gibidir:

> 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 çıktısı şuna benzer:

{
...
    "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

KAPATILMADI, HYBRID (varsayılan değer null'dur)

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 ürün, boştur)

MINT_IS_GROUP_ORG

GP grup kuruluşu (varsayılan değer yanlış)

MINT_HAS_BROKER

Bozuk (varsayılan değer: false)

MINT_TIMEZONE

Saat dilimi (varsayılan değer null'dur)

MINT_TAX_ENGINE_EXTERNAL_ID

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

MINT_COUNTRY

Kuruluşun ülkesi (varsayılan değer null'dur)

MINT_REG_NO

Kuruluşun tescil numarası (Birleşik Krallık) vergi numarasından farklı bir numara verir (varsayılan değer null'dur)

MINT_BILLING_CYCLE_TYPE

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

MINT_SUPPORTED_BILLING_TYPE

ÖN ÖDEMELİ/SONRAKİ/BOTH (varsayılan değer ÖN ÖDEMELİ)

MINT_IS_SEPARATE_INV_FOR_FEES

Ayrı bir ücret faturası oluşturulması gerekip gerekmediğini belirtir (varsayılan değer false'tur)

MINT_ISSUE_NETTING_STMT

Netting deyiminin yayınlanıp yayınlanmayacağını belirtir (varsayılan değer yanlış'tır)

MINT_NETTING_STMT_PER_CURRENCY

Netting deyiminin para birimine göre oluşturulup oluşturulmayacağını belirtir (varsayılan değer: yanlış)

MINT_HAS_SELF_BILLING

Kuruluşun faturalandırma özelliğini 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 faturalandırma yapıp yapmadığını belirtir(varsayılan değer: yanlış)

MINT_HAS_SEPARATE_INV_FOR_PROD

Kuruluşun ürün başına ayrı faturası olup olmadığını belirtir (varsayılan yanlış)

MINT_HAS_BILLING_ADJUSTMENT

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

features.isMonetizationEnabled

Yönetim kullanıcı arayüzü tarafından para kazanmaya özel menüyü görüntülemek için kullanılır (varsayılan değer false'tur)

ui.config.isOperator

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

(varsayılan değer doğrudur)

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

Not: Para Kazanma Hizmetleri Sınırlamaları ve Bildirimleri'ni kullanıyorsanız özellikleri hakkında daha fazla bilgi edinmek istiyorsanız lütfen geliştiricilerinizden erişim jetonu doğrulama politikası.

Sınırlama Politikası, belirli bir sınırın üstündeyken bir API çağrısını engellemek için tasarlanmış açık bir politikadır. ulaştı. Politika, işletme sınırlarını kontrol eder ve yapılandırıldı. Bu, Hata Bildirme politikasının uzantısıdır ancak koşullar türetilmiştir olabilir.

Proxy geliştiricileri için yönetim kullanıcı arayüzünde bir kullanıcı arayüzü şablonu mevcuttur. Proxy geliştiricisinin Mesaj akışına mint politikası ekleyin. Bu politikanın uygulanmasıyla birlikte hata bildirilecek hata yanıtıyla karşılaştırın. ContinueOnError (Devam) değerine ayarlanırsa hata yükseltilmez ve "mint.limitsViolated", "mint.isDeveloperAssistant" şeklindeki akış değişkenlerini içerir. ve "mint.limitsPolicyError" değişkenler ayarlanacak Bu makale, gerektiğinde daha fazla istisna ele almak için kullanılabilir.