本頁面由 Cloud Translation API 翻譯而成。

安裝營利服務

Private Cloud v. 4.17.01 版

營利服務是 Apigee Edge 的延伸功能，因此不會單獨執行上傳資料集之後，您可以運用 AutoML 自動完成部分資料準備工作可在任何現有的 Apigee Edge 設定中執行。

營利相關規定

如果要在使用多個管理伺服器的 Edge 拓撲中安裝營利服務因此，如要安裝 13 個節點等節點，您必須同時安裝這兩個 Edge Management Server 節點再安裝營利功能
如要在 Edge 上安裝 Edge 包含多個 Postgres 節點的 Monetization 功能，必須在主要/待命模式下設定 Postgres 節點。無法安裝營利服務如果您有多個 Postgres 主要節點，則位於 Edge 上。詳情請參閱安裝 Edge apigee-setup 公用程式。

安裝總覽

下列步驟說明如何在現有的 Apigee Edge 中新增營利服務安裝：

使用 apigee-setup 公用程式來更新 Apigee 管理伺服器節點以啟用營利服務，例如目錄管理、限制和通知設定、帳單報表。

如果您有多個管理伺服器節點 (例如安裝 13 個節點)，您必須請先安裝 Edge Management Server 節點，再安裝營利服務。
使用 apigee-setup 公用程式來更新 Apigee 訊息處理器，以便啟用營利服務，例如交易記錄政策和限制強制執行。如果發生以下情況：有多個訊息處理器，請在所有元件上安裝「營利」功能。
為您的 Edge 機構執行營利新手上路流程。
設定支援營利的開發人員服務入口網站。若需更多資訊，請參閲 http://apigee.com/docs/monetization/content/configure-monetization-developer-portal.

為營利

以下為營利安裝項目的靜音設定檔範例。編輯檔案。如要加入這個檔案，請使用 -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

注意：

如果您的 Edge 設定檔未指定 SMTP 資訊，請新增該檔案。如要營利，必須具備 SMTP 伺服器。
在單一資料中心安裝作業中，所有 ZooKeeper 節點都會預設為主管。在多個資料中心安裝 Edge 時，有些 ZooKeeper 節點設為觀察器確保上述 ZK_HOSTS 屬性在可安裝多個資料中心
如果啟用 Cassandra 驗證功能，您就能傳送 Cassandra 使用者名稱和密碼方法是使用下列屬性：
CASS_USERNAME
CASS_PASSWORD

整合營利服務部署伺服器

如要在管理伺服器節點上整合營利功能，請按照下列程序操作。

如果要在使用多個管理伺服器的 Edge 拓撲中安裝營利服務節點 (例如安裝 13 個節點) 再安裝「營利」
在 Management Server 節點上執行設定指令碼：
> /opt/apigee/apigee-setup/bin/setup.sh -p mo -f configFile

「-p mo」選項可指定整合營利方式。

設定檔必須可由「apigee」存取或讀取內容。
如果要在多個管理伺服器節點中安裝營利服務，請在以下項目中重複執行步驟 2：建立第二個管理伺服器節點

設定成功後，系統會在 PostgreSQL 資料庫營利服務和相關與 Postgres Server 搭配使用

整合營利服務訊息處理器

請按照下列程序整合所有訊息處理器的營利功能節點。

在第一個訊息處理器節點的命令提示字元中，執行設定指令碼：
> /opt/apigee/apigee-setup/bin/setup.sh -p mo -f configFile

「-p mo」選項可指定整合營利方式。

設定檔必須可由「apigee」存取或讀取內容。
對所有訊息處理器節點重複此程序。

成功設定後，「訊息處理者」會更新為「營利服務」。這個完成整合營利服務及其相關元件處理器：

啟用營利功能

如要建立新的機構並啟用營利功能，請先以下列名稱建立機構：確保所有新機構都能受益詳情請參閱「為機構加入計畫」。

為機構啟用營利功能的其他新手上路說明

如要完成機構營利的新手上路程序，您必須：

建立營利群組：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 設為與。
如果您透過多個資料中心設定啟用營利功能：
- 您必須在每一項資料中重複進行新手上路程序中央。
- 設定檔應僅列出資料中心內的 Qpid 節點專案。

如要執行指令碼，請按照下列步驟操作：

叫用指令碼：
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision enable-monetization -f configFile

設定檔必須可由「apigee」存取或讀取內容。

如果你有多個管理伺服器，只需在其中一個管理伺服器上執行這個指令碼即可。

這個指令碼會從 Cassandra 複製機構、產品、開發人員和應用程式到營利 PostgreSQL 資料庫成功安裝營利功能後系統會自動同步處理資料的服務。
針對您要啟用營利功能的每個機構重複執行這項程序。
如果您在多個資料中心環境，請在「管理」部分重複執行這項程序其他資料中心的伺服器。請確認設定檔中只列出正在設定資料中心

下次登入 Edge UI 時，您會看到機構：

設定開發人員服務入口網站

如要設定開發人員服務入口網站來支援營利功能，請參閱 http://apigee.com/docs/monetization/content/configure-monetization-developer-portal。

新增 Management Server 節點藉此營利

如要在現有 Edge 安裝項目中新增管理伺服器，請務必使用新版管理伺服器的營利服務，並設定所有管理伺服器，能夠溝通無礙

如要新增管理伺服器，請按照下列步驟操作：

安裝新的管理伺服器。
在新版管理伺服器上安裝營利服務。
在「原始」管理伺服器上呼叫以下內容：
> /opt/apigee/apigee-service/bin/apigee-service Edge-mint-management-server mint-configure-mgmt-cluster
重新啟動原始管理伺服器：
> /opt/apigee/apigee-service/bin/apigee-service Edge-management-server restart
在新的管理伺服器上，呼叫下列指令：
> /opt/apigee/apigee-service/bin/apigee-service Edge-mint-management-server mint-configure-mgmt-cluster
重新啟動新版管理伺服器：
> /opt/apigee/apigee-service/bin/apigee-service Edge-management-server restart

其他設定

提供帳單文件做為 PDF 檔案

營利服務會以 HTML 格式向使用者顯示帳單文件。提供帳單的 PDF 檔，就可以將營利與提供 PDF 的結帳系統整合產生或授權支援的第三方 PDF 程式庫

設定機構設定

後端設定：下表列出機構層級的屬性個人設定公司提供的工具你可以使用 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 (預設為空值)
MINT_CURRENCY	ISO 貨幣代碼 (預設為空值)
MINT_TAX_NEXUS	課稅關聯 (預設為空值)
MINT_DEFAULT_PROD_TAX_CATEGORY	預設產品類別 (預設為空值)
MINT_IS_GROUP_ORG	IS 群組機構 (預設值為 false)
MINT_HAS_BROKER	毀損 (預設為 false)
MINT_TIMEZONE	時區 (預設為空值)
MINT_TAX_ENGINE_EXTERNAL_ID	稅務引擎 ID (預設為空值)
MINT_COUNTRY	機構所在的國家/地區 (預設為空值)
MINT_REG_NO	機構組織的登記編號，英國提供的編號與稅號不同 (預設為空值)
MINT_BILLING_CYCLE_TYPE	PRORATED，calendar_MONTH (預設為 calendar_MONTH)
MINT_SUPPORTED_BILLING_TYPE	PREPAID/POSTPAID/BOTH (預設為 PREPAID)
MINT_IS_SEPARATE_INV_FOR_FEES	用於表示是否要另外產生費用發票 (預設為否)
MINT_ISSUE_NETTING_STMT	用於表示是否應發出淨額陳述式 (預設值為 false)
MINT_NETTING_STMT_PER_CURRENCY	表示是否應按貨幣產生淨額陳述式 (預設值為錯誤)
MINT_HAS_SELF_BILLING	表示機構是否採用自行計費 (預設值為 false)
MINT_SELF_BILLING_FOR_ALL_DEV	表示機構是否開放所有開發人員自行計費(預設為錯誤)
MINT_HAS_SEPARATE_INV_FOR_PROD	表示機構是否針對每項產品有不同的應付憑據 (預設為錯誤)
MINT_HAS_BILLING_ADJUSTMENT	指出機構是否支援帳單調整項 (預設為 false)
features.isMonetizationEnabled	管理 UI 會使用此選單顯示營利專用選單 (預設為 false)
ui.config.isOperator	管理 UI 會使用這項設定，將提供者顯示為操作者反向機構 (預設值為 true)

如要瞭解如何使用管理 UI 調整業務機構設定，請參閱 http://apigee.com/docs/monetization-services/content/get-started-using-monetization-services。

注意：如果您目前使用營利服務限制和通知功能，請指示開發人員在導入存取權杖驗證政策。

限制政策是一項明確的政策，旨在在達到特定限制時封鎖 API 呼叫。政策會檢查業務限制，如果發現任何超出上限的情況，會引發錯誤設定好的值這項擴充錯誤政策的擴充內容衍生自。

Proxy 開發人員的管理 UI 中提供了 UI 範本。Proxy 開發人員在訊息流程中附加薄荷政策。執行這項政策時，系統會提出錯誤按照政策顯示錯誤回應。如果將 ContinueOnError 設為 true，即表示錯誤不會增加，且流程變數：「mint.limitsViolated」、「mint.isDevelopersuspended」和「mint.limitsPolicyError」系統會設定變數視需要用於進一步處理例外狀況

安裝營利服務

營利相關規定

安裝總覽

為 營利

整合營利服務 部署伺服器

整合營利服務 訊息處理器