Cài đặt các thành phần Edge trên một nút

Edge for Private Cloud phiên bản 4.16.05

Sau khi bạn cài đặt tiện ích apigee-setup của Edge trên một nút, hãy sử dụng tiện ích apigee-setup để cài đặt một hoặc nhiều thành phần Edge trên nút đó.

Tiện ích apigee-setup sử dụng lệnh có dạng:

> /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

trong đó Component là thành phần Edge cần cài đặt và configFile là tệp cấu hình im lặng chứa thông tin cài đặt. Tệp cấu hình phải truy cập được hoặc đọc được bởi người dùng "apigee". Ví dụ: đặt tệp trong thư mục /tmp trên nút.

Ví dụ: để cài đặt Máy chủ quản lý cạnh:

> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f /tmp/myConfig

Những điều cần cân nhắc khi cài đặt

Khi bạn viết tệp cấu hình, hãy xem xét các lựa chọn sau.

Thiết lập tính năng sao chép chính của chế độ chờ cho Postgres

Theo mặc định, Edge sẽ cài đặt tất cả các nút Postgres ở chế độ chính. Tuy nhiên, trong các hệ thống sản xuất có nhiều nút Postgres, bạn phải định cấu hình các nút này để sử dụng tính năng sao chép chính của chế độ chờ sao cho nếu nút chính bị lỗi, nút chờ có thể tiếp tục phân phát lưu lượng truy cập.

Bạn có thể bật và định cấu hình bản sao chính của chế độ chờ tại thời điểm cài đặt bằng cách sử dụng các thuộc tính trong tệp cấu hình im lặng. Hoặc bạn có thể bật tính năng sao chép chế độ chờ chính sau khi cài đặt. Để biết thêm thông tin, hãy xem phần Thiết lập tính năng Sao chép dự phòng chính cho Postgres.

Bật tính năng xác thực Cassandra

Theo mặc định, Cassandra cài đặt mà không bật tính năng xác thực. Điều đó có nghĩa là bất cứ ai cũng có thể truy cập vào Cassandra. Bạn có thể bật tính năng xác thực sau khi cài đặt Edge hoặc trong quá trình cài đặt.

Bạn có thể bật phương thức xác thực Cassandra dưới dạng thời gian cài đặt bằng cách sử dụng các thuộc tính trong tệp cấu hình im lặng. Hoặc bạn có thể bật tính năng này sau khi cài đặt.

Để biết thêm, hãy xem phần Bật tính năng xác thực Cassandra.

Liên kết Bộ định tuyến với một cổng được bảo vệ

Nếu muốn liên kết Bộ định tuyến với một cổng được bảo vệ, chẳng hạn như số cổng nhỏ hơn 1024, thì bạn phải định cấu hình Bộ định tuyến để chạy với tư cách người dùng có quyền truy cập vào các cổng đó. Theo mặc định, Bộ định tuyến chạy dưới dạng người dùng "apigee" không có quyền truy cập vào các cổng đặc quyền.

Cách chạy Bộ định tuyến với tư cách người dùng khác:

  1. Ở cấp độ gốc, tạo tệp /opt/apigee/etc/edge-router.d/RUN_USER.sh.
  2. Thêm mục sau đây vào tệp:
    RUN_USER=root
    Nếu bạn không muốn chạy Bộ định tuyến ở cấp độ gốc, hãy chỉ định một người dùng có quyền truy cập vào cổng.
  3. Lưu tệp.
  4. Nếu bạn đã chỉ định một người dùng không phải là người dùng gốc, hãy thay đổi chủ sở hữu tệp thành người dùng đó:
    > chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
  5. Khởi động lại bộ định tuyến:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-router khởi động lại

Chỉ định thành phần cần cài đặt

Bảng sau đây liệt kê các tuỳ chọn bạn chuyển đến tuỳ chọn -p của tiện ích apigee-service để chỉ định thành phần nào cần cài đặt trên nút:

Thành phần

Mô tả

c

Chỉ cài đặt Cassandra.

zk chỉ cài đặt ZooKeeper.

ds

Cài đặt ZooKeeper và Cassandra.

ld

Chỉ cài đặt OpenLDAP.

ms

Cài đặt Máy chủ quản lý Edge. Thao tác này cũng cài đặt giao diện người dùng Edge và OpenLDAP.

Nếu bạn đặt USE_LDAP_REMOTE_HOST=y trong tệp cấu hình, thì quá trình cài đặt Open LDAP sẽ bị bỏ qua và Máy chủ quản lý sử dụng Open LDAP được cài đặt trên một nút khác.

r

Chỉ cài đặt Bộ định tuyến cạnh.

mp

Chỉ cài đặt Trình xử lý thư Edge.

phòng tắm

Cài đặt Bộ định tuyến cạnh và Bộ xử lý tin nhắn.

ui

Cài đặt giao diện người dùng Edge.

qs

Chỉ cài đặt Máy chủ Qpid.

ps

Chỉ cài đặt Máy chủ Postgres.

kèn sax

Cài đặt các thành phần phân tích, nghĩa là Qpid và Postgres.

Bạn chỉ nên sử dụng tuỳ chọn này cho mục đích phát triển và thử nghiệm, không dùng cho phiên bản chính thức.

tháng

Cài đặt tính năng Kiếm tiền.

sa

Cài đặt Edge độc lập, nghĩa là Cassandra, ZooKeeper, Máy chủ quản lý, OpenLDAP, Giao diện người dùng Edge, Bộ định tuyến và Trình xử lý thư. Tuỳ chọn này bỏ qua các thành phần phân tích Edge: Qpid và Postgres.

Bạn chỉ nên sử dụng tuỳ chọn này cho mục đích phát triển và thử nghiệm, không dùng cho phiên bản chính thức.

aio

Cài đặt tất cả thành phần trên một nút duy nhất.

Bạn chỉ nên sử dụng tuỳ chọn này cho mục đích phát triển và thử nghiệm, không dùng cho phiên bản chính thức.

Tạo tệp cấu hình

Tệp cấu hình chứa tất cả thông tin cần thiết để cài đặt Edge. Thường thì bạn có thể sử dụng cùng một tệp cấu hình để cài đặt tất cả thành phần trong một bản cài đặt Edge.

Tuy nhiên, bạn sẽ phải sử dụng các tệp cấu hình khác nhau hoặc sửa đổi tệp cấu hình, nếu:

  • Bạn đang cài đặt nhiều máy chủ Open LDAP và cần định cấu hình sao chép trong quá trình cài đặt 13 nút. Mỗi tệp yêu cầu các giá trị khác nhau cho LDAP_SIDLDAP_PEER.
  • Bạn đang tạo nhiều trung tâm dữ liệu trong quá trình cài đặt 12 nút. Mỗi trung tâm dữ liệu yêu cầu các chế độ cài đặt khác nhau cho các thuộc tính như ZK_CLIENT_HOSTSCASS_HOSTS.

Tệp cấu hình mẫu

Dưới đây là ví dụ về tệp cấu hình im lặng hoàn toàn để cài đặt Edge 9 nút. Chỉnh sửa tệp này nếu cần cho cấu hình của bạn. Sử dụng tuỳ chọn -f để setup.sh để thêm tệp này. Ngoài ra, bạn cũng có thể xem các tệp cấu hình mẫu cho từng cấu trúc liên kết Edge.

# IP address or DNS name of nodes.
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)

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

# Location of Edge license file.
LICENSE_FILE=/tmp/license.txt

# Management Server information.
MSIP=$IP1    # IP or DNS name of Management Server node. 
# Specify the port the Management Server listens on for API calls.
# APIGEE_PORT_HTTP_MS=8080    # Default is 8080.

#
# OpenLDAP information.
#
# Set to y if you are connecting to a remote LDAP server. 
# If n, Edge installs OpenLDAP when it installs the Management Server.
USE_LDAP_REMOTE_HOST=n 

# If connecting to remote OpenLDAP server, specify the IP/DNS name and port.
# LDAP_HOST=$IP1    # IP or DNS name of OpenLDAP node.
# LDAP_PORT=10389   # Default is 10389.
APIGEE_LDAPPW=yourLdapPassword

# Specify OpenLDAP without replication, 1, or with replication, 2.
LDAP_TYPE=1 

# Set only if using replication.
# LDAP_SID=1    # Unique ID for this LDAP server. 
# LDAP_PEER=    # IP or DNS name of LDAP peer.

BIND_ON_ALL_INTERFACES=y 

# The Message Processor and Router pod.
MP_POD=gateway 

# The name of the region, corresponding to the data center name.
REGION=dc-1 # Use dc-1 unless installing in a 
            # multi-data center environment. 

# ZooKeeper information.
# See table below if installing in a multi-data center environment.
ZK_HOSTS="$IP1 $IP2 $IP3"         # IP/DNS names of all ZooKeeper nodes. 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"  # IP/DNS names of all ZooKeeper nodes.

# Cassandra information.
CASS_CLUSTERNAME=Apigee    # Default name is Apigee.

# IP addresses of the Cassandra hosts separated by spaces.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"

# Set to enable Cassandra authentication.
# CASS_AUTH=y    # The default value is n.
# Cassandra uname/pword required if you enabled Cassandra authentication.
# CASS_USERNAME=
# CASS_PASSWORD=

# Use to enable Postgres master-standby replication
# when you have multiple Postgres nodes. 
# PG_MASTER=IPorDNSofNewMaster
# PG_STANDBY=IPorDNSofOldMaster

# SMTP information.
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.gmail.com
SMTPUSER=your@email.com
SMTPPASSWORD=yourEmailPassword
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.

Bảng sau đây chứa thông tin bổ sung về các thuộc tính này:

Thuộc tính

Lưu ý

Tên IP/DNS

Không sử dụng ánh xạ tên máy chủ tới 127.0.0.1 hoặc địa chỉ IP 127.0.0.1 khi chỉ định địa chỉ IP của một nút.

QUẢN TRỊ_EMAIL
APIGEE_ADMINPW

Mật khẩu của quản trị viên hệ thống phải dài ít nhất 8 ký tự và có chứa một chữ hoa, một chữ cái viết thường, một chữ số hoặc một ký tự đặc biệt. Nếu bỏ qua mật khẩu, bạn sẽ được nhắc nhập mật khẩu đó.

LICENSE_FILE

Vị trí của tệp giấy phép, phải có thể truy cập được đối với người dùng "apigee". Ví dụ: lưu trữ tệp trong thư mục /tmp và chmod 777 trên tệp. Tệp này được sao chép vào thư mục cài đặt Edge.

USE_ LDAP_REMOTE_HOST
LDAP_HOST
LDAP_Port

Nếu USE_LDAP_REMOTE_HOST là n, Edge sẽ tự động cài đặt OpenLDAP khi cài đặt Máy chủ quản lý.

Đặt USE_LDAP_REMOTE_HOST thành y nếu bạn đang kết nối với máy chủ LDAP từ xa. OpenLDAP chưa được cài đặt cùng với Máy chủ quản lý.

Nếu bạn đang kết nối với một máy chủ OpenLDAP từ xa, hãy sử dụng LDAP_HOST
và LDAP_Port để chỉ định địa chỉ IP hoặc tên DNS và số cổng của máy chủ.

LDAP_TYPE
LDAP_SID
LDAP_PEER

Đặt LDAP_TYPE=1 cho Open LDAP mà không sao chép. LDAP_TYPE=2 tương ứng với OpenLDAP với tính năng sao chép.

Nếu cấu trúc liên kết của Edge sử dụng một máy chủ OpenLDAP, hãy chỉ định 1. Nếu quá trình cài đặt Edge sử dụng nhiều nút OpenLDAP, chẳng hạn như trong bản cài đặt phiên bản chính thức 13 nút, hãy chỉ định 2.

Nếu bạn bật tính năng nhân bản, hãy đặt các thuộc tính sau:

  • LDAP_SID=1 - ID duy nhất cho máy chủ LDAP này. Mỗi nút LDAP sử dụng một mã nhận dạng khác nhau. Ví dụ: đặt thành 2 cho ứng dụng ngang hàng LDAP.
  • LDAP_PEER=10.0.0.1 - IP hoặc tên DNS của ngang hàng LDAP.

BIND_ON_ALL_INTERFACES

Nếu bạn đặt thành "y" thì Bộ định tuyến/Bộ xử lý thư sẽ liên kết (nghe) trên mọi giao diện (IP). Nếu được đặt thành “n” thì Bộ định tuyến/Bộ xử lý thư sẽ liên kết (nghe) trên một giao diện cụ thể, IP được trả về bởi lệnh "tên máy chủ -i").

MP_POD

Chỉ định tên của nhóm Bộ định tuyến và Bộ xử lý tin nhắn. Theo mặc định, tên là cổng.

KHU VỰC

Tên khu vực. Theo quy ước, tên thường có dạng dc-#, trong đó # tương ứng với một giá trị số nguyên. Ví dụ: dc-1, dc-2, v.v. Bạn có thể sử dụng dc-1 trừ phi cài đặt trong môi trường trung tâm đa dữ liệu.

Khi cài đặt nhiều trung tâm dữ liệu, giá trị là dc-1 hoặc dc-2, v.v. tuỳ thuộc vào trung tâm dữ liệu bạn đang cài đặt. Tuy nhiên, bạn không bị hạn chế chỉ sử dụng các tên ở dạng dc-#. Bạn có thể dùng bất kỳ tên nào cho khu vực.

ZK_HOSTS

Địa chỉ IP hoặc tên DNS của các nút ZooKeeper. Địa chỉ IP hoặc tên DNS phải được liệt kê theo cùng một thứ tự trên tất cả các nút ZooKeeper.

Trong môi trường trung tâm dữ liệu, hãy liệt kê tất cả các nút ZooKeeper từ cả hai trung tâm dữ liệu.

Chỉ chỉ định đối tượng sửa đổi “:observer” trên các nút ZooKeeper khi tạo nhiều trung tâm dữ liệu như mô tả trong một bản cài đặt gồm 12 máy chủ. Trong một lần cài đặt trung tâm dữ liệu, hãy bỏ qua đối tượng sửa đổi đó. Xem nội dung cài đặt theo nhóm 12 máy chủ để biết thêm thông tin.

ZK_CLIENT_HOSTS

Địa chỉ IP hoặc tên DNS của các nút ZooKeeper mà trung tâm dữ liệu này sử dụng. Địa chỉ IP hoặc tên DNS phải được liệt kê theo cùng một thứ tự trên tất cả các nút ZooKeeper.

Trong một trường hợp cài đặt trung tâm dữ liệu, đây chính là các nút do ZK_HOSTS chỉ định.

Trong môi trường trung tâm đa dữ liệu, chỉ liệt kê các nút ZooKeeper trong trung tâm dữ liệu này. Xem nội dung cài đặt theo nhóm 12 máy chủ để biết thêm thông tin.

CASS_HOSTS

Địa chỉ IP (không phải tên DNS) của các nút Cassandra. 2 nút đầu tiên sẽ được dùng làm máy chủ gốc. Các địa chỉ IP phải được liệt kê theo cùng một thứ tự trên tất cả các nút Cassandra.

Các nút Cassandra có thể có hậu tố “:dc,ra” (không bắt buộc) chỉ định trung tâm dữ liệu và giá trị của nút Cassandra. Chỉ chỉ định đối tượng sửa đổi này khi tạo nhiều trung tâm dữ liệu như mô tả trong quy trình cài đặt gồm 12 máy chủ lưu trữ. Trong một lần cài đặt trung tâm dữ liệu, hãy bỏ qua đối tượng sửa đổi đó.

Ví dụ: "192.168.124.201:1,1 = trung tâm dữ liệu 1 và vùng giá/khả năng lập chỉ mục 1, và "192.168.124.204:2,1 = trung tâm dữ liệu 2 và vùng giá/khả năng lập chỉ mục 1".

Trong môi trường đa trung tâm dữ liệu, để khắc phục các vấn đề liên quan đến tường lửa, CASS_HOSTS phải được sắp xếp theo cách (như trong ví dụ trên) sao cho các nút của trung tâm dữ liệu hiện tại được đặt ở đầu. Xem nội dung cài đặt theo nhóm 12 máy chủ để biết thêm thông tin.

CASS_AUTH
CASS_USERNAME

CASS_PASSWORD

Nếu bật tính năng xác thực Cassandra, CASS_AUTH=y, bạn có thể chuyển tên người dùng và mật khẩu Cassandra bằng cách sử dụng các thuộc tính này.

PG_MASTER

PG_STANDBY

Thiết lập để bật tính năng sao chép chính cho thẻ chờ Postgres có dạng như sau:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
MẬT KHẨU SMTP
SMTPSSL
Cổng SMTP

Định cấu hình SMTP để Edge có thể gửi email về mật khẩu bị mất và các thông báo khác.

Nếu không bắt buộc phải cung cấp thông tin xác thực của người dùng SMTP, hãy bỏ qua SMTPUSERSMTP MẬT.

Thứ tự cài đặt thành phần

Thứ tự cài đặt thành phần dựa trên cấu trúc liên kết mong muốn của bạn.

Tất cả ví dụ về cách cài đặt hiển thị bên dưới giả định rằng bạn đang cài đặt:

  • Khi tắt tính năng xác thực Cassandra (mặc định). Xem phần Bật tính năng xác thực Cassandra để biết thêm thông tin.
  • Khi tắt tính năng sao chép chính của chế độ chờ Postgres (mặc định). Hãy xem bài viết Thiết lập tính năng Sao chép dự phòng chính cho Postgres để biết thêm thông tin.
  • Bộ xử lý thư và Bộ định tuyến trên cùng một nút. Nếu bạn cài đặt Bộ định tuyến và Bộ xử lý thông báo trên các nút khác nhau, trước tiên, hãy cài đặt tất cả Bộ xử lý thông báo rồi cài đặt tất cả Bộ định tuyến.

Tệp nhật ký cài đặt

Theo mặc định, tiện ích setup.sh ghi thông tin nhật ký về quá trình cài đặt vào:

/opt/apigee/var/log/apigee-setup/setup.log

Nếu người dùng đang chạy tiện ích setup.sh không có quyền truy cập vào thư mục đó, thì tiện ích đó sẽ ghi nhật ký vào thư mục setup.sh dưới dạng tệp có tên là setup.sh.

Nếu người dùng không có quyền truy cập vào /tmp, thì tiện ích setup.sh sẽ không hoạt động.

Cài đặt tích hợp

  1. Cài đặt tất cả thành phần trên một nút duy nhất bằng lệnh:
    > /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. Xóa bất kỳ tệp nào trong /opt/nginx/conf.d:
    > rm -f /opt/nginx/conf.d/*
  3. Khởi động lại Bộ định tuyến cạnh:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router khởi động lại
  4. Hãy kiểm thử việc cài đặt như mô tả trong bài viết Kiểm thử việc cài đặt.
  5. Giới thiệu tổ chức của bạn như mô tả trong phần Giới thiệu một tổ chức.

Dưới đây là tệp cấu hình im lặng cho cấu trúc liên kết này:

# With SMTP
IP1=IPorDNSnameOfNode
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd    
# omit for no password
SMTPSSL=n
SMTPPORT=25

Cài đặt độc lập qua 2 máy chủ

Hãy xem phần Cấu trúc liên kết đã cài đặt để biết danh sách các cấu trúc liên kết và số nút của Edge.

  1. Cài đặt Cổng vào độc lập và nút 1
    > /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile
  2. Trên nút 1:
    1. Xóa bất kỳ tệp nào trong /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    2. Khởi động lại Bộ định tuyến cạnh:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router khởi động lại
  3. Cài đặt Analytics trên nút 2:
    > /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  4. Hãy kiểm thử việc cài đặt như mô tả trong bài viết Kiểm thử việc cài đặt.
  5. Giới thiệu tổ chức của bạn như mô tả trong phần Giới thiệu một tổ chức.

Dưới đây là tệp cấu hình im lặng cho cấu trúc liên kết này:

# With SMTP
IP1=IPorDNSnameOfNode1
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd    
# omit for no password
SMTPSSL=n
SMTPPORT=25

Cài đặt theo cụm 5 máy chủ

Hãy xem phần Cấu trúc liên kết đã cài đặt để biết danh sách các cấu trúc liên kết và số nút của Edge.

  1. Cài đặt cụm Datastore trên các nút 1, 2 và 3:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Cài đặt Máy chủ quản lý trên nút 1:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Trên nút 2 và 3:
    1. Cài đặt Bộ định tuyến và Bộ xử lý thư:
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. Xóa bất kỳ tệp nào trong /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    3. Khởi động lại Bộ định tuyến cạnh:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router khởi động lại
  4. Cài đặt Analytics trên nút 4 và 5:
    > /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  5. Hãy kiểm thử việc cài đặt như mô tả trong bài viết Kiểm thử việc cài đặt.
  6. Giới thiệu tổ chức của bạn như mô tả trong phần Giới thiệu một tổ chức.

Dưới đây là tệp cấu hình im lặng cho cấu trúc liên kết này:

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
PG_MASTER=$IP4
PG_STANDBY=$IP5
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password 
SMTPSSL=n
SMTPPORT=25

Cài đặt theo cụm 9 máy chủ

Hãy xem phần Cấu trúc liên kết đã cài đặt để biết danh sách các cấu trúc liên kết và số nút của Edge.

  1. Cài đặt Nút cụm Datastore trên nút 1, 2 và 3:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Cài đặt Máy chủ quản lý Apigee trên nút 1:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Trên nút 4 và 5:
    1. Cài đặt Bộ định tuyến và Bộ xử lý thư:
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. Xóa bất kỳ tệp nào trong /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    3. Khởi động lại Bộ định tuyến cạnh:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router khởi động lại
  4. Cài đặt máy chủ Apigee Analytics Qpid trên nút 6 và 7:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Cài đặt Máy chủ Apigee Analytics Postgres trên nút 8 và 9:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Hãy kiểm thử việc cài đặt như mô tả trong bài viết Kiểm thử việc cài đặt.
  7. Giới thiệu tổ chức của bạn như mô tả trong phần Giới thiệu một tổ chức.

Dưới đây là tệp cấu hình im lặng cho cấu trúc liên kết này:

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
SKIP_SMTP=n
PG_MASTER=$IP8
PG_STANDBY=$IP9
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password
SMTPSSL=n
SMTPPORT=25

Cài đặt theo cụm 13 máy chủ

Hãy xem phần Cấu trúc liên kết đã cài đặt để biết danh sách các cấu trúc liên kết và số nút của Edge.

  1. Cài đặt Nút cụm Datastore trên nút 1, 2 và 3:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Cài đặt OpenLDAP trên nút 4 và 5:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
  3. Cài đặt Máy chủ quản lý Apigee trên nút 6 và 7:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. Cài đặt Máy chủ Apigee Analytics Postgres trên nút 8 và 9:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  5. Trên nút 10 và 11:
    1. Cài đặt Bộ định tuyến và Bộ xử lý thư:
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. Xóa bất kỳ tệp nào trong /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    3. Khởi động lại Bộ định tuyến cạnh:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router khởi động lại
  6. Cài đặt máy chủ Apigee Analytics Qpid trên nút 12 và 13:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. Hãy kiểm thử việc cài đặt như mô tả trong bài viết Kiểm thử việc cài đặt.
  8. Giới thiệu tổ chức của bạn như mô tả trong phần Giới thiệu một tổ chức.

Dưới đây là tệp cấu hình im lặng cho cấu trúc liên kết này:

# For all components except OpenLDAP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
# First Management Server on IP6
MSIP=$IP6 
USE_LDAP_REMOTE_HOST=y
LDAP_HOST=$IP4
LDAP_PORT=10389
# Second Management Server on IP7
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=y
# LDAP_HOST=$IP5
# LDAP_PORT=10389
# Same password for both OpenLDAPs.
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
PG_MASTER=$IP8
PG_STANDBY=$IP9
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password
SMTPSSL=n
SMTPPORT=25
# For OpenLDAP on IP4 and IP5
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
# First OpenLDAP Server on IP4
MSIP=$IP6 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5
# Second OpenLDAP Server on IP5
# MSIP=$IP7 
# USE_LDAP_REMOTE_HOST=n 
# LDAP_TYPE=2
# LDAP_SID=2
# LDAP_PEER=$IP4
# Set same password for both OpenLDAPs.
APIGEE_LDAPPW=secret 

Cài đặt theo cụm 12 máy chủ

Trước khi cài đặt Edge trên cấu trúc liên kết phân cụm máy chủ a12 (hai trung tâm dữ liệu), bạn phải tìm hiểu cách đặt các thuộc tính ZooKeeper và Cassandra trong tệp cấu hình im lặng.

  • ZooKeeper

    Đối với thuộc tính ZK_HOSTS cho cả hai trung tâm dữ liệu, hãy chỉ định địa chỉ IP hoặc tên DNS của tất cả các nút ZooKeeper từ cả hai trung tâm dữ liệu, theo cùng thứ tự và đánh dấu bất kỳ nút nào bằng đối tượng sửa đổi ":observer". Các nút không có đối tượng sửa đổi ":observer" được gọi là "voter". Bạn phải có một số "cái phiếu" lẻ trong cấu hình của mình.

    Trong cấu trúc liên kết này, máy chủ ZooKeeper trên máy chủ 9 là đối tượng tiếp nhận dữ liệu:

    Đối với thuộc tính ZK_CLIENT_HOSTS cho mỗi trung tâm dữ liệu, chỉ định địa chỉ IP hoặc tên DNS của các nút ZooKeeper trong trung tâm dữ liệu, theo cùng thứ tự, cho tất cả các nút ZooKeeper trong trung tâm dữ liệu. Trong tệp cấu hình ví dụ minh hoạ bên dưới, nút 9 được gắn thẻ bằng đối tượng sửa đổi ":observer" để bạn có 5 cử tri: Nút 1, 2, 3, 7 và 8.
  • Cassandra
    Tất cả các trung tâm dữ liệu phải có cùng số nút Cassandra.

    Đối với CASS_HOSTS cho mỗi trung tâm dữ liệu, hãy đảm bảo rằng bạn chỉ định tất cả địa chỉ IP Cassandra (không phải tên DNS) cho cả hai trung tâm dữ liệu. Đối với trung tâm dữ liệu 1, trước tiên, hãy liệt kê các nút Cassandra trong trung tâm dữ liệu đó. Đối với trung tâm dữ liệu 2, trước tiên, hãy liệt kê các nút Cassandra trong trung tâm dữ liệu đó. Liệt kê các nút Cassandra theo cùng một thứ tự cho tất cả các nút Cassandra trong trung tâm dữ liệu.


    Ví dụ: "192.168.124.201:1,1 192.168.124.202:1,1 192.168.124.203:1,1 192.168.124.204:2,1 192.168.6.24" sẽ xuất hiện trong vùng 1.168.168.12, 192.168.12, 192.168.12



    Trong mô hình triển khai này, cách thiết lập Cassandra sẽ có dạng như sau:

Hãy xem phần Cấu trúc liên kết đã cài đặt để biết danh sách các cấu trúc liên kết và số nút của Edge.

  1. Cài đặt Nút cụm Datastore trên nút 1, 2, 3, 7, 8 và 9:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Cài đặt Máy chủ quản lý Apigee bằng phương pháp sao chép Open LDAP trên nút 1 và 7:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Trên nút 2, 3, 8 và 9:
    1. Cài đặt Bộ định tuyến và Bộ xử lý thư:
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. Xóa bất kỳ tệp nào trong /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    3. Khởi động lại Bộ định tuyến cạnh:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router khởi động lại
  4. Cài đặt Máy chủ Qpid Analytics của Apigee trên nút 4, 5, 10 và 11:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Cài đặt Máy chủ Apigee Analytics Postgres trên nút 6 và 12:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Hãy kiểm thử việc cài đặt như mô tả trong bài viết Kiểm thử việc cài đặt.
  7. Giới thiệu tổ chức của bạn như mô tả trong phần Giới thiệu một tổ chức.

Hiển thị bên dưới là tệp cấu hình im lặng cho cấu trúc liên kết này. Xin lưu ý rằng tệp cấu hình này:

  • Định cấu hình OpenLDAP bằng cách sao chép trên hai nút OpenLDAP.
  • Chỉ định công cụ sửa đổi “:observer” trên một nút ZooKeeper. Trong một lần cài đặt trung tâm dữ liệu, hãy bỏ qua đối tượng sửa đổi đó.
# Datacenter 1
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
IP12=IPorDNSnameOfNode12 
HOSTIP=$(hostname -i)
MSIP=$IP1
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP7
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway-1
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1"
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
# omit for no username
SMTPPASSWORD=smtppwd   
# omit for no password
SMTPSSL=n
SMTPPORT=25
# Datacenter 2
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9 
IP12=IPorDNSnameOfNode12
HOSTIP=$(hostname -i)
MSIP=$IP7
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=2
LDAP_PEER=$IP1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway-2
REGION=dc-2
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP7 $IP8 $IP9"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1"
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
# omit for no username
SMTPPASSWORD=smtppwd   
# omit for no password
SMTPSSL=n
SMTPPORT=25