このページは Cloud Translation API によって翻訳されました。

Monetization Services のインストール

Edge for Private Cloud v. 4.17.05

Monetization Services は Apigee Edge の拡張機能であるため、スタンドアロンでは実行されません。プロセスです既存の Apigee Edge 設定内で実行されます。

収益化の要件

複数の Management Server を使用する Edge トポロジに Monetization をインストールする場合 Edge Management Server ノードを両方ともインストールする必要があります。まず Monetization をインストールする前に、
Edge 環境に複数の Postgres ノードがある Edge に Monetization をインストールするには、次の操作を行います。 Postgres ノードをマスター/スタンバイモードで構成する必要があります。Monetization をインストールできません Postgres マスターノードが複数ある場合は、エッジ上に作成します。詳細については、マスター / スタンバイレプリケーションを設定する Postgres。

インストールの概要

次の手順は、既存の Apigee Edge に Monetization Services を追加する方法を示しています。インストール:

apigee-setup を使用するユーティリティを使用して Apigee Management Server ノードを更新し、Monetization Services を有効にするたとえば、カタログ管理、制限と通知の構成、請求と通知、レポート

13 ノード構成など、複数の Management Server ノードがある場合は、 Monetization をインストールする前に、両方の Edge Management Server ノードをインストールします。
apigee-setup を使用するユーティリティを使用して Apigee Message Processor を更新し、収益化サービス（トランザクション記録ポリシー、制限の適用など）もし複数の Message Processor がある場合は、そのすべてに Monetization をインストールします。
Edge 組織に対して Monetization オンボーディングプロセスを実行します。
収益化をサポートするように Developer Services ポータルを構成します。詳細については、次をご覧ください: http://apigee.com/docs/monetization/content/configure-monetization-developer-portal.

Cloud Shell でサイレント構成ファイルを作成し、収益化

以下に、Monetization のインストール用のサイレント構成ファイルの例を示します。これを編集構成ファイルを必要に応じて変更します。このファイルを含めるには、setup.sh の -f オプションを使用します。

注: 通常、これらのプロパティは、 Edge をインストールする際に使用した認証情報（Edge のインストールを参照）ノードに配置されます。

# 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
SMTPMAILFROM="My Company <myco@company.com>"

注: <ph type="x-smartling-placeholder">

Edge 構成ファイルに SMTP 情報が指定されていない場合は、追加します。収益化には SMTP サーバー。
単一データセンター環境では、すべての ZooKeeper ノードはデフォルトで次のように構成されます。います。複数のデータセンターに Edge をインストールする場合、一部の ZooKeeper ノードはオブザーバーとして構成できます。上記の ZK_HOSTS プロパティでは、必ず次の ZK_HOSTS プロパティに複数のデータセンターを設置した場合です。
Cassandra 認証を有効にする場合は、Cassandra のユーザー名とパスワードを次のプロパティを使用します。
CASS_USERNAME
CASS_PASSWORD

収益化サービスを統合するすべての管理サーバーと

Management Server ノードで Monetization を統合するには、次の操作を行います。

複数の Management Server を使用する Edge トポロジに Monetization をインストールする場合 Management Server がインストールされていることを確認し、 Monetization をインストールする前に、コンテナイメージを確認してください。
Management Server ノードで、セットアップスクリプトを実行します。
> /opt/apigee/apigee-setup/bin/setup.sh -p mo -f configFile

「-p mo」オプションは、Monetization を統合するよう指定します。

構成ファイルは、apigee からアクセス可能または読み取り可能である必要があります。できます。
複数の Management Server ノードに Monetization をインストールする場合は、各ノードで手順 2 を繰り返します。 2 番目の Management Server ノードで起動されます。

構成が正常に行われると、Monetization Services の RDBMS スキーマが PostgreSQL データベースです。これで、Monetization Services とそれに関連する Postgres Server を使用する方法を説明します

収益化サービスを統合するすべての Message Processor

すべての Message Processor で Monetization を統合するには、次の操作を行います。説明します。

最初の Message Processor ノードで、コマンドプロンプトで設定スクリプトを実行します。
> /opt/apigee/apigee-setup/bin/setup.sh -p mo -f configFile

「-p mo」オプションは、Monetization を統合するよう指定します。

構成ファイルは、apigee からアクセス可能または読み取り可能である必要があります。できます。
すべての Message Processor ノードで、この手順を繰り返します。

構成が成功すると、Message Processor が Monetization Services によって更新されます。この Monetization Services とその関連コンポーネントがメッセージと統合されている決済代行業者。

収益化のオンボーディング

収益化が有効な新しい組織を作成するには、まず組織を新しい組織の場合と同様に行います詳細については、組織のオンボーディングをご覧ください。

組織の収益化を可能にする追加のオンボーディング

組織の収益化オンボーディングを完了するには、次のことを行う必要があります。

収益化グループ mxgroup を作成します。
Qpid をグループに追加します。
組織の収益化を有効にする。
組織の通知設定を有効にします。
収益化を有効にするすべての組織に対して、この手順を繰り返します。

enable-monetization コマンドを実行することで、これらのタスクをすべて実施できます。このスクリプトは、次のプロパティがあります。

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.

注:

CASS_HOSTS と REGION は、 Monetization のインストール時に使用したパスです。
マルチデータセンター構成で収益化を有効にする場合: <ph type="x-smartling-placeholder">
- Management Server で、データごとにオンボーディングプロセスを繰り返す必要があります。選択します。
- 構成ファイルには、対象のデータセンター内の Qpid ノードのみを構成されます。

このスクリプトを実行するには、次のようにします。

スクリプト
を呼び出します。 > /opt/apigee/apigee-service/bin/apigee-service apigee-provision enable-monetization -f configFile

構成ファイルは、apigee からアクセス可能または読み取り可能である必要があります。できます。

複数の Management Server がある場合、このスクリプトを実行する必要があるのはそのうちの 1 つだけです。

このスクリプトは、Cassandra から組織、製品、デベロッパー、アプリケーションを複製します。 Monetization PostgreSQL データベースにマッピングします。Monetization のインストールが正常に完了した後データが自動的に同期されるサービス。
収益化を有効にする組織ごとに、この手順を繰り返します。
複数のデータセンターを運用している場合は、管理ページでこのプロセスを繰り返します。別のデータセンターのサーバー。構成ファイルに構成されているデータセンターです。

次回 Edge UI にログインすると、最上位レベルのメニューに [Monetization] エントリが表示されます。必要があります。

デベロッパーを構成するサービスポータル

収益化をサポートするように Developer Services ポータルを構成するには、http://apigee.com/docs/monetization/content/configure-monetization-developer-portal をご覧ください。

Management Server ノードの追加収益化のインストールに

既存の Edge インストールに Management Server を追加する場合は、新しい Management Server への収益化サービスを作成し、すべての Management Server で、通信できるようになります。

Management Server を追加するには:

新しい Management Server をインストールします。
新しい Management Server に Monetization をインストールします。
元の Management Server で、次のコマンドを実行します。
> /opt/apigee/apigee-service/bin/apigee-service edge-mint-management-server mint-configure-mgmt-cluster
元の Management Server を再起動します。
> /opt/apigee/apigee-service/bin/apigee-service edge-management-server の再起動
新しい Management Server で、次の呼び出しを行います。
> /opt/apigee/apigee-service/bin/apigee-service edge-mint-management-server mint-configure-mgmt-cluster
新しい Management Server を再起動します。
> /opt/apigee/apigee-service/bin/apigee-service edge-management-server の再起動

追加構成

請求書類の送信先 PDF ファイル

収益化では、請求書類が HTML 形式でエンドユーザーに表示されます。支払い情報の提供 Monetization を、PDF を提供する課金システムと統合できます。サードパーティ製の PDF ライブラリを生成したり、ライセンスを供与したりできます。

組織の構成設定

バックエンドの設定: 次の表に、組織レベルの属性を示します。 Mint 組織の構成に使用できますPUT 呼び出しを使用して、これらを追加または更新できます。次のように指定します。

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

たとえば、上記の CURL コマンドの出力は次のようになります。

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

属性	説明
MINT_TAX_MODEL	指定可能な値は「DISCLOSED」、 UNDISCLOSED、HYBRID（デフォルトは null）
MINT_CURRENCY	ISO 通貨コード（デフォルトは null）
MINT_TAX_NEXUS	税金ネクサス（デフォルトは null）
MINT_DEFAULT_PROD_TAX_CATEGORY	デフォルトの商品税のカテゴリ（デフォルトは null）
MINT_IS_GROUP_ORG	IS グループの組織（デフォルトは false）
MINT_HAS_BROKER	破損あり（デフォルトは false）
MINT_TIMEZONE	タイムゾーン（デフォルトは null）
MINT_TAX_ENGINE_EXTERNAL_ID	税務エンジン ID（デフォルトは null）
MINT_COUNTRY	組織の国（デフォルトは null）
MINT_REG_NO	組織の登録番号（英国では納税者番号とは異なる番号）（デフォルトは null）
MINT_BILLING_CYCLE_TYPE	PRORATED、CALENDAR_MONTH（デフォルトは CALENDAR_MONTH）
MINT_SUPPORTED_BILLING_TYPE	PREPAID/POSTPAID/BoTH（デフォルトは PREPAID）
MINT_IS_SEPARATE_INV_FOR_FEES	個別の料金請求書を生成するかどうかを示します（デフォルトは false）
MINT_ISSUE_NETTING_STMT	相殺明細書を発行するかどうかを示します（デフォルトは false）
MINT_NETTING_STMT_PER_CURRENCY	相殺明細書を通貨ごとに生成するかどうかを示します（デフォルトは false）
MINT_HAS_SELF_BILLING	組織に自己請求があるかどうかを示します（デフォルトは false）
MINT_SELF_BILLING_FOR_ALL_DEV	組織ですべてのデベロッパーを自己請求できるかどうかを示します（デフォルトは自己請求） false）
MINT_HAS_SEPARATE_INV_FOR_PROD	組織にプロダクトごとに個別の請求書があるかどうかを示します（デフォルトは false）
MINT_HAS_BILLING_ADJUSTMENT	組織が請求額の調整をサポートしているかどうかを示します（デフォルトは false）
features.isMonetizationEnabled	Monetization 固有のメニューを表示するために管理 UI で使用されます（デフォルトは false）
ui.config.isOperator	プロバイダをオペレーターと組織として表示するために管理 UI によって使用されます（デフォルトは true）

管理 UI を使用してビジネス組織の設定を構成する方法については、http://apigee.com/docs/monetization-services/content/get-started-using-monetization-services をご覧ください。

注: Monetization Services の制限と通知を使用している場合プロキシフローで制限ポリシーを追加するようデベロッパーに指示し、アクセストークン検証ポリシーです。

制限ポリシーは、特定の制限に達した場合に API 呼び出しをブロックするように設計された明示的なポリシーです。できます。このポリシーでは、ビジネスの上限を確認し、超過した上限がある場合はエラーを発生させます。表示されます。これは障害ポリシーを拡張したものですが、条件はビジネス変数から導き出されます。

プロキシデベロッパー向けの管理 UI で UI テンプレートが利用可能です。プロキシ開発者は Mint ポリシーを接続しますこのポリシーを実行すると、エラーが発生します。レスポンスが返されます。ContinueOnError が true に設定されている場合、障害は値が返されず、フロー変数「mint.limitsViolated」、「mint.isDeveloperPending」が渡されます。「mint.limitsPolicyError」変数が設定されます。必要に応じて追加の例外処理に使用できます。

Monetization Services のインストール

収益化の要件

インストールの概要

Cloud Shell でサイレント構成ファイルを作成し、 収益化

収益化サービスを統合する すべての管理サーバーと

収益化サービスを統合する すべての Message Processor