Para Kazanma Hizmetlerini Yükleme

Private Cloud için Edge v. 4.16.05

Para kazanma hizmetleri, Apigee Edge'in bir uzantısı olduğundan bağımsız bir işlem olarak çalışmaz. Mevcut Apigee Edge kurulumlarında çalışır.

Para kazanma koşulları

  • Para Kazanma'yı, birden fazla Yönetim Sunucusu düğümü kullanan bir Edge topolojisine (ör. 13 düğümlü kurulum) yüklüyorsanız Para Kazanma'yı yüklemeden önce her iki Edge Yönetim Sunucusu düğümünü de yüklemeniz 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. Birden fazla Postgres ana düğümünüz varsa Para Kazanma'yı Edge'e yükleyemezsiniz. Daha fazla bilgi için Set-Standby Replication for Postgre'ler.

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:

  • Para kazanma hizmetlerini (ör. katalog yönetimi, sınırlar ve bildirimler 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.

    Birden fazla Yönetim Sunucusu düğümünüz varsa (ör. 13 düğümlü bir kurulum) Para Kazanma'yı yüklemeden önce her iki Edge Yönetim Sunucusu düğümünü de yüklemeniz gerekir.
  • 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ı). Birden fazla mesaj işleyiciniz varsa Para Kazanma'yı hepsine 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.

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

Aşağıda, para kazanma kurulumu için sessiz yapılandırma dosyası örneği verilmiştir. 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: Genellikle bu özellikleri, Edge bileşenlerini bir düğüme 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 belirtilmediyse bunları 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 gözlemci olarak yapılandırılı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ı, birden fazla Yönetim Sunucusu düğümü kullanan bir Edge topolojisine (ör. 13 düğümlü kurulum) 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/Apigee-setup/bin/setup.sh -p mo -f configFile

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

    "apigee" kullanıcısı, yapılandırma dosyasına erişebilmelidir veya dosyayı okuyabilmelidir. Örneğin, dosyayı düğümdeki /tmp dizinine yerleştirin.
  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 Mesaj İşleyen düğümlerine entegre etmek için aşağıdaki prosedürü uygulayın.

  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. Örneğin, dosyayı düğümdeki /tmp dizinine yerleştirin.
  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 işlem, Para Kazanma Hizmetleri ve ilişkili bileşenlerinin Mesaj İşlemcileri ile entegrasyonunu tamamlar.

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 üzere ek ilk katılım

Bir kuruluşun para kazanmaya ilk katılımını tamamlamak için:

  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.

Tüm bu görevleri 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.

Notlar:

  • CASS_HOSTS ve REGION'u, Para Kazanma'yı yüklerken kullandığınız değerlerle aynı olacak şekilde ayarlayın.
  • 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 yapılandırılan veri merkezindeki Qpid düğümlerini listelemelidir.

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

  1. Komut dosyasını çağırın:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision enable-monetization -f configFile

    "apigee" kullanıcısı yapılandırma dosyasına erişebilmelidir veya dosyayı okuyabilmelidir. Örneğin, /tmp dizinindeki dosya birleştirebilirsiniz.

    Birden fazla yönetim sunucunuz varsa bu komut dosyasını yalnızca birinde çalıştırmanız yeterlidir.

    Bu komut dosyası, kuruluşu, ürünleri, geliştiricileri ve uygulamaları Cassandra veritabanından Monetization PostgreSQL veritabanına kopyalar. 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 işlemi tekrarlayın.
  3. Birden çok veri merkezi ortamındaysanız bu işlemi Yönetim Sunucu diğer veri merkezinde. Yapılandırma dosyasında yalnızca yapılandırılmakta olan veri merkezindeki Qpid düğümlerinin listelendiğinden emin olun.

Edge kullanıcı arayüzüne tekrar 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 adresine bakın.

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 sunucusunda aşağıdaki komutu çağırın:
    > /opt/apigee/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/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 sunucusunu yeniden başlatın:
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Ek yapılandırma

Faturalandırma Belgelerini PDF Dosyası Olarak Gönderme

Para kazanma, faturalandırma dokümanlarını son kullanıcılara HTML biçiminde gösterir. Faturalandırma olanağı sağlamak 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ş ayarlarını yapılandırma

Arka uç ayarları: Aşağıdaki tabloda kuruluş düzeyindeki özellikler listelenmektedir. yapılandırmanın ne kadar kolay olduğunu gösterir. Aşağıda gösterildiği gibi bu özellikleri eklemek/güncellemek için 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

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

MINT_CURRENCY

ISO para birimi kodu (varsayılan olarak null)

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 olarak null)

MINT_IS_GROUP_ORG

IS grubu kuruluşu (varsayılan olarak yanlıştır)

MINT_HAS_BROKER

Has broken (varsayılan değer false)

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 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 CALENDAR_MONTH)

MINT_SUPPORTED_BILLING_TYPE

ÖN ÖDEMELİ/SON ÖDEMELİ/İKİSİ DE (varsayılan olarak ÖN ÖDEMELİ)

MINT_IS_SEPARATE_INV_FOR_FEES

Ayrı bir ücret faturası oluşturulup oluşturulmayacağını belirtir (varsayılan değer false'tır).

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

Netleştirme beyanının para birimi başına oluşturulup oluşturulmayacağını belirtir (varsayılan değer false'tır)

MINT_HAS_SELF_BILLING

Kuruluşun kendi kendine faturalandırma özelliği olup olmadığını belirtir (varsayılan değer yanlıştır)

MINT_SELF_BILLING_FOR_ALL_DEV

Kuruluşun tüm geliştiriciler için kendi kendine faturalandırma kullanıp kullanmadığını belirtir (varsayılan değer false'tır)

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 faturalandırma 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ıyı Operatör olarak göstermek için yönetim kullanıcı arayüzü tarafından kullanılır.

(varsayılan değer true)

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ı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 oluşturur. 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 bulunur. Proxy geliştiricisinin Mesaj akışına mint politikası ekleyin. Bu politikanın uygulanmasının ardından, politikaya uygun olarak hata yanıtıyla birlikte hata oluşturulur. ContinueOnError doğru olarak ayarlanırsa hata oluşturulmaz ve "mint.limitsViolated", "mint.isDeveloperSuspended" ve "mint.limitsPolicyError" akış değişkenleri ayarlanır. Bu değişkenler, gerekirse daha fazla istisna işleme için kullanılabilir.