نصب کردن عناصر Edge در گره

Edge for Private Cloud نسخه ۴.۱۶.۰۵

پس‌از نصب ابزار کمکی Edge apigee-setup در گره، از ابزار کمکی apigee-setup برای نصب یک یا چند مؤلفه Edge در گره استفاده کنید.

ابزار کمکی apigee-setup از فرمانی به این شکل استفاده می‌کند:

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

که در آن component مؤلفه Edge برای نصب است، و configFile فایل پیکربندی بی‌صدا حاوی اطلاعات نصب است. فایل پیکربندی باید برای کاربر «apigee» قابل‌دسترسی یا خواندن باشد. برای مثال، فایل را در دایرکتوری /tmp در گره قرار دهید.

برای مثال، برای نصب Edge Management Server:

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

ملاحظات نصب

هنگام نوشتن فایل پیکربندی، گزینه‌های زیر را درنظر بگیرید.

درحال راه‌اندازی تکرار اصلی-آماده‌به‌کار Postgres

به‌طور پیش‌فرض، Edge همه گره‌های Postgres را در حالت اصلی نصب می‌کند. اما در سیستم‌های تولیدی با چندین گره Postgres، باید آن‌ها را برای استفاده از تکرار اصلی-آماده‌به‌کار پیکربندی کنید تا اگر گره اصلی ازکار افتاد، گره آماده‌به‌کار بتواند به ارائه ترافیک ادامه دهد.

می‌توانید تکرار اصلی-آماده‌به‌کار را در زمان نصب بااستفاده از ویژگی‌های موجود در فایل پیکربندی بی‌صدا فعال و پیکربندی کنید. یا می‌توانید پس‌از نصب، تکرار اصلی-آماده‌به‌کار را فعال کنید. برای اطلاعات بیشتر، به راه‌اندازی تکرار Master-Standby برای Postgres مراجعه کنید.

درحال فعال کردن اصالت‌سنجی Cassandra

به‌طور پیش‌فرض، Cassandra بدون فعال بودن اصالت‌سنجی نصب می‌شود. یعنی هرکسی می‌تواند به Cassandra دسترسی داشته باشد. می‌توانید اصالت‌سنجی را پس‌از نصب Edge یا به‌عنوان بخشی از فرایند نصب فعال کنید.

می‌توانید اصالت‌سنجی Cassandra را به‌عنوان زمان نصب بااستفاده از ویژگی‌ها در فایل پیکربندی بی‌صدا فعال کنید. یا می‌توانید آن را بعداز نصب فعال کنید.

برای اطلاعات بیشتر، فعال کردن اصالت‌سنجی Cassandra را ببینید.

اتصال رهیاب به درگاه محافظت‌شده

اگر می‌خواهید «رهیاب» را به درگاه محافظت‌شده‌ای، مثل شماره درگاه‌های کمتر از ۱۰۲۴، متصل کنید، باید «رهیاب» را به‌گونه‌ای پیکربندی کنید که به‌عنوان کاربری با دسترسی به آن درگاه‌ها اجرا شود. به‌طور پیش‌فرض، «مسیریاب» به‌عنوان کاربر «apigee» اجرا می‌شود که به درگاه‌های ممتاز دسترسی ندارد.

برای اجرای Router به‌عنوان کاربری دیگر:

  1. به‌عنوان root، فایل /opt/apigee/etc/edge-router.d/RUN_USER.sh را ایجاد کنید.
  2. ورودی زیر را به فایل اضافه کنید:
    RUN_USER=root
    اگر نمی‌خواهید «مسیریاب» را به‌عنوان root اجرا کنید، کاربری را مشخص کنید که به درگاه دسترسی داشته باشد.
  3. فایل را ذخیره کنید.
  4. اگر کاربری غیراز root مشخص کرده‌اید، مالک فایل را به آن کاربر تغییر دهید:
    > chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
  5. رهیاب را بازراه‌اندازی کنید:
    > /opt/apigee/apigee-service/bin/apigee-service edge-router restart

مشخص کردن مؤلفه‌ها برای نصب

جدول زیر گزینه‌هایی را که به گزینه -p ابزار apigee-service ارسال می‌کنید فهرست می‌کند تا مشخص کنید کدام مؤلفه‌ها در گره نصب شوند:

عنصر

شرح

c

فقط Cassandra را نصب کنید.

zk فقط ZooKeeper را نصب کنید.

ds

ZooKeeper و Cassandra را نصب کنید.

ld

فقط OpenLDAP را نصب کنید.

ms

Edge Management Server را نصب کنید که Edge UI و OpenLDAP را نیز نصب می‌کند.

اگر USE_LDAP_REMOTE_HOST=y را در فایل پیکربندی تنظیم کنید، نصب OpenLDAP رد می‌شود و «سرور مدیریت» از OpenLDAP نصب‌شده در گره دیگری استفاده می‌کند.

r

فقط Edge Router را نصب کنید.

مگاپیکسل

فقط Edge Message Processor را نصب کنید.

rmp

Edge Router و Message Processor را نصب کنید.

ui

رابط کاربری Edge را نصب کنید.

qs

فقط Qpid Server را نصب کنید.

ps

فقط Postgres Server را نصب کنید.

ساکسوفون

مؤلفه‌های analytics، یعنی Qpid و Postgres را نصب کنید.

از این گزینه فقط برای توسعه و آزمایش استفاده کنید، نه برای تولید.

ماهانه

«درآمدزایی» را نصب کنید.

sa

Edge را به‌صورت مستقل نصب کنید، یعنی Cassandra،‏ ZooKeeper،‏ Management Server،‏ OpenLDAP، Edge UI،‏ Router، و Message Processor. این گزینه مؤلفه‌های تجزیه‌وتحلیل Edge را حذف می‌کند: Qpid و Postgres.

از این گزینه فقط برای توسعه و آزمایش استفاده کنید، نه برای تولید.

aio

همه مؤلفه‌ها را در یک گره نصب کنید.

از این گزینه فقط برای توسعه و آزمایش استفاده کنید، نه برای تولید.

ایجاد فایل پیکربندی

فایل پیکربندی حاوی همه اطلاعات لازم برای نصب Edge است. اغلب می‌توانید از همان فایل پیکربندی برای نصب همه مؤلفه‌ها در نصب Edge استفاده کنید.

بااین‌حال، در شرایط زیر باید از فایل‌های پیکربندی متفاوتی استفاده کنید یا فایل پیکربندی‌تان را اصلاح کنید:

  • درحال نصب چند سرور OpenLDAP هستید و باید تکرار را به‌عنوان بخشی از نصب ۱۳ گره پیکربندی کنید. هر فایل به مقادیر متفاوتی برای LDAP_SID و LDAP_PEER نیاز دارد.
  • درحال ایجاد چندین مرکز داده به‌عنوان بخشی از نصب ۱۲ گره هستید. هر مرکز داده به تنظیمات متفاوتی برای ویژگی‌هایی مانند ZK_CLIENT_HOSTS و CASS_HOSTS نیاز دارد.

نمونه فایل پیکربندی

در زیر نمونه‌ای از فایل پیکربندی بی‌صدای کامل برای نصب Edge با ۹ گره نشان داده شده است. این فایل را درصورت لزوم برای پیکربندی‌تان ویرایش کنید. از گزینه -f برای setup.sh استفاده کنید تا این فایل را اضافه کنید. همچنین در زیر، نمونه فایل‌های پیکربندی برای هر توپولوژی 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.

جدول زیر حاوی اطلاعات تکمیلی درباره این ویژگی‌ها است:

دارایی

توجه

نام‌های IP/ساناد

هنگام مشخص کردن نشانی IP گره، از نام میزبانی که به 127.0.0.1 یا نشانی IP‏ 127.0.0.1 نگاشت شده است استفاده نکنید.

ADMIN_EMAIL
APIGEE_ADMINPW

گذرواژه سرپرست سیستم باید حداقل ۸ نویسه داشته باشد و شامل یک حرف بزرگ، یک حرف کوچک، یک رقم، یا یک نویسه خاص باشد. اگر گذرواژه را حذف کنید، از شما خواسته می‌شود آن را وارد کنید.

LICENSE_FILE

مکان فایل پروانه که باید برای کاربر «apigee» دردسترس باشد. برای مثال، آن را در دایرکتوری /tmp ذخیره کنید و chmod 777 را روی فایل اجرا کنید. فایل در فهرست نصب Edge کپی می‌شود.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

اگر USE_LDAP_REMOTE_HOST برابر با n باشد، Edge هنگام نصب Management Server، به‌طور خودکار OpenLDAP را نصب می‌کند.

اگر به سرور LDAP راه دور متصل می‌شوید، USE_LDAP_REMOTE_HOST را روی y تنظیم کنید. OpenLDAP با «سرور مدیریت» نصب نشده است.

اگر به سرور OpenLDAP راه دور متصل می‌شوید، از LDAP_HOST
و LDAP_PORT برای مشخص کردن نشانی IP یا نام ساناد و شماره درگاه میزبان استفاده کنید.

LDAP_TYPE
LDAP_SID
LDAP_PEER

برای OpenLDAP بدون تکرار، LDAP_TYPE=1 را تنظیم کنید. LDAP_TYPE=2 با OpenLDAP با تکرار مطابقت دارد.

اگر توپولوژی Edge شما از یک سرور OpenLDAP استفاده می‌کند، عدد ۱ را مشخص کنید. اگر نصب Edge شما از چند گره OpenLDAP استفاده می‌کند، مثلاً در نصب تولیدی ۱۳ گره‌ای، ۲ را مشخص کنید.

اگر تکرار را فعال می‌کنید، ویژگی‌های زیر را تنظیم کنید:

  • LDAP_SID=1 - شناسه یکتا برای این سرور LDAP. هر گره LDAP از شناسه متفاوتی استفاده می‌کند. برای مثال، برای همتای LDAP روی ۲ تنظیم کنید.
  • LDAP_PEER=10.0.0.1 - IP یا نام ساناد همتای LDAP.

BIND_ON_ALL_INTERFACES

اگر روی «y» تنظیم شود، «رهیاب/پردازشگر پیام» به همه میاناهای (IP) متصل می‌شود (گوش می‌دهد). اگر روی «n» تنظیم شود، «رهیاب/پردازشگر پیام» به میانای خاصی متصل می‌شود (گوش می‌دهد)، IP برگردانده‌شده توسط فرمان «hostname -i»).

MP_POD

نام پاد «پردازشگر پیام» و «مسیریاب» را مشخص کنید. به‌طور پیش‌فرض، نام آن gateway است.

REGION

نام منطقه. طبق قرارداد، نام‌ها معمولاً به‌صورت dc-# هستند که # با مقدار عدد صحیح مطابقت دارد. برای مثال، dc-1،‏ dc-2، و غیره. می‌توانید از dc-1 استفاده کنید، مگراینکه در محیط چندمرکز داده نصب کنید.

در نصب مرکز داده چندگانه، مقدار dc-1، یا dc-2، و غیره است، بسته به اینکه کدام مرکز داده را نصب می‌کنید. بااین‌حال، محدود به استفاده از نام‌ها به‌شکل dc-# نیستید. می‌توانید از هر نامی برای منطقه استفاده کنید.

ZK_HOSTS

نشانی‌های IP یا نام‌های DNS گره‌های ZooKeeper. نشانی‌های IP یا نام‌های DNS باید در همه گره‌های ZooKeeper با همان ترتیب فهرست شوند.

در محیط چندمرکز داده، همه گره‌های ZooKeeper را از هر دو مرکز داده فهرست کنید.

اصلاح‌کننده «:observer» را در گره‌های ZooKeeper فقط هنگام ایجاد چندین مرکز داده، همان‌طور که در نصب ۱۲ میزبان شرح داده شده است، مشخص کنید. در نصب مرکز داده تکی، آن اصلاح‌کننده را حذف کنید. برای اطلاعات بیشتر، نصب خوشه‌ای ۱۲ میزبان را ببینید.

ZK_CLIENT_HOSTS

نشانی‌های IP یا نام‌های DNS گره‌های ZooKeeper که این مرکز داده از آن‌ها استفاده می‌کند. نشانی‌های IP یا نام‌های ساناد باید در همه گره‌های ZooKeeper با ترتیب یکسان فهرست شوند.

در نصب مرکز داده تکی، این گره‌ها همان گره‌هایی هستند که توسط ZK_HOSTS مشخص شده‌اند.

در محیط چند مرکز داده، فقط گره‌های ZooKeeper را در این مرکز داده فهرست کنید. برای اطلاعات بیشتر، نصب خوشه‌ای ۱۲ میزبان را ببینید.

CASS_HOSTS

نشانی‌های IP (نه نام‌های ساناد) گره‌های Cassandra. دو گره اول به‌عنوان سرورهای بذر استفاده خواهند شد. نشانی‌های IP باید با همان ترتیب در همه گره‌های Cassandra فهرست شوند.

گره‌های Cassandra می‌توانند پسوند اختیاری «:dc,ra» داشته باشند که مرکز داده و قفسه گره Cassandra را مشخص می‌کند. این اصلاح‌کننده را فقط هنگام ایجاد چند مرکز داده همان‌طور که در نصب ۱۲ میزبان شرح داده شده است مشخص کنید. در نصب یک مرکز داده، آن اصلاح‌کننده را حذف کنید.

برای مثال، «192.168.124.201:1,1» یعنی مرکز داده ۱ و قفسه/منطقه دردسترس ۱، و «192.168.124.204:2,1» یعنی مرکز داده ۲ و قفسه/منطقه دردسترس ۱.

In a multi-datacenter environment, to overcome firewall issues, CASS_HOSTS have to be ordered in a manner (as shown in above example) such that the nodes of the current datacenter are placed at the beginning. برای اطلاعات بیشتر، نصب خوشه‌ای ۱۲ میزبان را ببینید.

CASS_AUTH
CASS_USERNAME

CASS_PASSWORD

اگر اصالت‌سنجی Cassandra را فعال کنید (CASS_AUTH=y)، می‌توانید نام کاربری و گذرواژه Cassandra را بااستفاده از این ویژگی‌ها ارسال کنید.

PG_MASTER

PG_STANDBY

تنظیم برای فعال کردن تکرار Postgres master-standby، در فرم:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT

SMTP را پیکربندی کنید تا Edge بتواند برای گذرواژه‌های گم‌شده و سایر اعلان‌ها ایمیل ارسال کند.

اگر اطلاعات کاربری کاربر SMTP لازم نیست، SMTPUSER و SMTPPASSWORD را حذف کنید.

ترتیب نصب مؤلفه

ترتیب نصب مؤلفه براساس توپولوژی موردنظر شما است.

همه نمونه‌های نصب نشان‌داده‌شده در زیر فرض می‌کنند که درحال نصب این موارد هستید:

  • با اصالت‌سنجی Cassandra غیرفعال (پیش‌فرض). برای اطلاعات بیشتر، فعال کردن اصالت‌سنجی Cassandra را ببینید.
  • با غیرفعال بودن تکرار Postgres master-standby (پیش‌فرض). برای اطلاعات بیشتر، به راه‌اندازی تکرار Master-Standby برای Postgres مراجعه کنید.
  • پردازشگر پیام و مسیریاب در یک گره. اگر «پردازشگرهای پیام» و «رهیاب‌ها» را در گره‌های مختلف نصب می‌کنید، ابتدا همه «پردازشگرهای پیام» و سپس همه «رهیاب‌ها» را نصب کنید.

فایل‌های گزارش نصب

به‌طور پیش‌فرض، ابزار setup.sh اطلاعات گزارش مربوط به نصب را در اینجا می‌نویسد:

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

اگر کاربری که ابزار کمکی setup.sh را اجرا می‌کند به آن فهرست راهنما دسترسی نداشته باشد، گزارش را در فهرست راهنمای /tmp به‌عنوان فایلی با نام setup_username.log می‌نویسد.

اگر کاربر به tmp /دسترسی نداشته باشد، ابزار setup.sh ناموفق خواهد بود.

نصب همه‌کاره

  1. Install all components on a single node using the command:
    > /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. همه فایل‌های موجود در /opt/nginx/conf.d را حذف کنید:
    > rm -f /opt/nginx/conf.d/*
  3. Edge Router را بازراه‌اندازی کنید:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  4. نصب را طبق روشی که در آزمودن نصب توضیح داده شده است آزمایش کنید.
  5. سازمانتان را همان‌طور که در آماده‌سازی سازمان شرح داده شده است آماده کنید.

در زیر فایل پیکربندی بی‌صدا برای این توپولوژی نشان داده شده است:

# 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

نصب مستقل با ۲ میزبان

برای مشاهده فهرست توپولوژی‌های Edge و شماره‌های گره، به توپولوژی‌های نصب مراجعه کنید.

  1. Install Standalone Gateway and node 1
    > /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile
  2. در گره ۱:
    1. همه فایل‌های موجود در /opt/nginx/conf.d را حذف کنید:
      > rm -f /opt/nginx/conf.d/*
    2. Edge Router را بازراه‌اندازی کنید:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  3. Analytics را در گره ۲ نصب کنید:
    > /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  4. نصب را طبق روشی که در آزمودن نصب توضیح داده شده است آزمایش کنید.
  5. سازمانتان را همان‌طور که در آماده‌سازی سازمان شرح داده شده است آماده کنید.

در زیر فایل پیکربندی بی‌صدا برای این توپولوژی نشان داده شده است:

# 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

نصب خوشه‌ای با ۵ میزبان

برای مشاهده فهرست توپولوژی‌های Edge و شماره‌های گره، به توپولوژی‌های نصب مراجعه کنید.

  1. خوشه Datastore را در گره‌های ۱، ۲، و ۳ نصب کنید:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Install Management Server on node 1:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. در گره‌های ۲ و ۳:
    1. Install Router and Message Processor:
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. همه فایل‌های موجود در /opt/nginx/conf.d را حذف کنید:
      > rm -f /opt/nginx/conf.d/*
    3. Edge Router را بازراه‌اندازی کنید:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  4. Analytics را در گره ۴ و ۵ نصب کنید:
    > /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  5. نصب را طبق روشی که در آزمودن نصب توضیح داده شده است آزمایش کنید.
  6. سازمانتان را همان‌طور که در آماده‌سازی سازمان شرح داده شده است آماده کنید.

در زیر فایل پیکربندی بی‌صدا برای این توپولوژی نشان داده شده است:

# 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

نصب خوشه‌ای ۹ میزبان

برای مشاهده فهرست توپولوژی‌های Edge و شماره‌های گره، به توپولوژی‌های نصب مراجعه کنید.

  1. Install Datastore Cluster Node on node 1, 2 and 3:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Install Apigee Management Server on node 1:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. در گره‌های ۴ و ۵:
    1. Install Router and Message Processor:
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. همه فایل‌های موجود در /opt/nginx/conf.d را حذف کنید:
      > rm -f /opt/nginx/conf.d/*
    3. Edge Router را بازراه‌اندازی کنید:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  4. «سرور Apigee Analytics Qpid» را در گره ۶ و ۷ نصب کنید:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Apigee Analytics Postgres Server را در گره ۸ و ۹ نصب کنید:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. نصب را طبق روشی که در آزمودن نصب توضیح داده شده است آزمایش کنید.
  7. سازمانتان را همان‌طور که در آماده‌سازی سازمان شرح داده شده است آماده کنید.

در زیر فایل پیکربندی بی‌صدا برای این توپولوژی نشان داده شده است:

# 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

نصب خوشه‌ای ۱۳ میزبان

برای مشاهده فهرست توپولوژی‌های Edge و شماره‌های گره، به توپولوژی‌های نصب مراجعه کنید.

  1. Install Datastore Cluster Node on node 1, 2 and 3:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Install OpenLDAP on node 4 and 5:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
  3. «سرور مدیریت Apigee» را در گره ۶ و ۷ نصب کنید:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. Apigee Analytics Postgres Server را در گره ۸ و ۹ نصب کنید:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  5. در گره‌های ۱۰ و ۱۱:
    1. Install Router and Message Processor:
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. همه فایل‌های موجود در /opt/nginx/conf.d را حذف کنید:
      > rm -f /opt/nginx/conf.d/*
    3. Edge Router را بازراه‌اندازی کنید:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  6. Apigee Analytics Qpid Server را در گره ۱۲ و ۱۳ نصب کنید:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. نصب را طبق روشی که در آزمودن نصب توضیح داده شده است آزمایش کنید.
  8. سازمانتان را همان‌طور که در آماده‌سازی سازمان شرح داده شده است آماده کنید.

در زیر فایل پیکربندی بی‌صدا برای این توپولوژی نشان داده شده است:

# 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 

نصب خوشه‌ای ۱۲ میزبان

قبل‌از نصب Edge در توپولوژی خوشه‌ای ۱۲ میزبان (دو مرکز داده)، باید بدانید چگونه ویژگی‌های ZooKeeper و Cassandra را در فایل پیکربندی بی‌صدا تنظیم کنید.

  • ZooKeeper

    برای ویژگی ZK_HOSTS برای هر دو مرکز داده، نشانی‌های IP یا نام‌های ساناد همه گره‌های ZooKeeper را از هر دو مرکز داده، با همان ترتیب، مشخص کنید و هر گره‌ای را با اصلاح‌کننده «:observer» علامت‌گذاری کنید. به گره‌های بدون اصلاح‌کننده «:observer» «رأی‌دهنده» می‌گویند. باید تعداد فردی «رأی‌دهنده» در پیکربندی‌تان داشته باشید.

    In this topology, the ZooKeeper host on host 9 is the observer:

    For the ZK_CLIENT_HOSTS property for each data center, specify the IP addresses or DNS names of only the ZooKeeper nodes in the data center, in the same order, for all ZooKeeper nodes in the data center. در نمونه فایل پیکربندی نشان‌داده‌شده در زیر، گره ۹ با اصلاح‌کننده «:observer» برچسب‌گذاری شده است تا پنج رأی‌دهنده داشته باشید: گره‌های ۱، ۲، ۳، ۷، و ۸.
  • Cassandra
    همه مراکز داده باید تعداد گره‌های Cassandra یکسانی داشته باشند.

    برای CASS_HOSTS برای هر مرکز داده، مطمئن شوید که همه نشانی‌های IP مربوط به Cassandra (نه نام‌های ساناد) را برای هر دو مرکز داده مشخص کنید. برای مرکز داده ۱، ابتدا گره‌های Cassandra را در آن مرکز داده فهرست کنید. برای مرکز داده ۲، ابتدا گره‌های Cassandra را در آن مرکز داده فهرست کنید. گره‌های Cassandra را با همان ترتیب برای همه گره‌های Cassandra در مرکز داده فهرست کنید.

    همه گره‌های Cassandra باید پسوند «:<d>,<r>» داشته باشند، برای مثال «<ip>:1,1 = مرکز داده ۱ و قفسه/منطقه دردسترس ۱ و «<ip>:2,1 = مرکز داده ۲ و قفسه/منطقه دردسترس ۱.
    برای مثال، «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.124.205:2,1 192.168.124.206:2,1»

    اولین گره در قفسه/منطقه دردسترس بودن ۱ هر مرکز داده به‌عنوان سرور اولیه استفاده خواهد شد.

    در این مدل استقرار، راه‌اندازی Cassandra به این شکل خواهد بود:

برای مشاهده فهرست توپولوژی‌های Edge و شماره‌های گره، به توپولوژی‌های نصب مراجعه کنید.

  1. «گره خوشه پایگاه داده» را در گره ۱، ۲، ۳، ۷، ۸، و ۹ نصب کنید:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Install Apigee Management Server with OpenLDAP replication on node 1 and 7:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. در گره‌های ۲، ۳، ۸، و ۹:
    1. Install Router and Message Processor:
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. همه فایل‌های موجود در /opt/nginx/conf.d را حذف کنید:
      > rm -f /opt/nginx/conf.d/*
    3. Edge Router را بازراه‌اندازی کنید:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  4. Apigee Analytics Qpid Server را روی گره ۴، ۵، ۱۰، و ۱۱ نصب کنید:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Apigee Analytics Postgres Server را روی گره ۶ و ۱۲ نصب کنید:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. نصب را طبق روشی که در آزمودن نصب توضیح داده شده است آزمایش کنید.
  7. سازمانتان را همان‌طور که در آماده‌سازی سازمان شرح داده شده است آماده کنید.

در زیر، فایل پیکربندی بی‌صدا برای این توپولوژی نشان داده شده است. توجه داشته باشید که این فایل پیکربندی:

  • ال‌دپ باز را با تکرار در دو گره ال‌دپ باز پیکربندی می‌کند.
  • اصلاح‌کننده «:observer» را در یک گره ZooKeeper مشخص می‌کند. در نصب مرکز داده تکی، آن اصلاح‌کننده را حذف کنید.
# 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