‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

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

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

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

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

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

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

برای مثال، برای نصب «سرور مدیریت Edge»:

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

ملاحظات نصب

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

درحال راه‌اندازی Postgres تکثیر master-standby

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

می‌توانید تکثیر آماده‌باش اصلی را در زمان نصب بااستفاده از دارایی‌ها در فایل پیکربندی بی‌صدا فعال و پیکربندی کنید. یا می‌توانید تکثیر اصلی-آماده‌به‌کار را پس‌از نصب فعال کنید. برای اطلاعات بیشتر، راه‌اندازی تکثیر «اصلی-آماده‌به‌کار» برای Postgres را ببینید.

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

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

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

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

مقید کردن «رهیاب» به درگاه محافظت‌شده

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

برای اجرای «مسیریاب» به‌عنوان کاربر دیگر:

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

مشخص کردن اجزای نصب

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

عنصر	شرح
c	فقط Cassandra را نصب کنید.
zk	فقط ZooKeeper را نصب کنید.
ds	‫ZooKeeper و Cassandra را نصب کنید.
ld	فقط OpenLDAP را نصب کنید.
ms	«سرور مدیریت Edge» را نصب کنید که «میانای کاربری Edge» و OpenLDAP را نیز نصب می‌کند. اگر USE_LDAP_REMOTE_HOST=y را در فایل پیکربندی تنظیم کنید، نصب OpenLDAP رد می‌شود و «سرور مدیریت» از OpenLDAP نصب‌شده در گره دیگری استفاده می‌کند.
r	فقط «رهیاب لبه» را نصب کنید.
mp	فقط «پردازشگر پیام Edge» را نصب کنید.
rmp	«رهیاب لبه» و «پردازشگر پیام» را نصب کنید.
ui	واسط کاربر Edge را نصب کنید.
qs	فقط «سرور Qpid» را نصب کنید.
ps	فقط «سرور Postgres» را نصب کنید.
ساکس	عناصر Analytics، یعنی Qpid و Postgres را نصب کنید. از این گزینه فقط برای توسعه و آزمایش استفاده کنید، نه برای تولید.
ماهانه	«درآمدزایی» را نصب کنید.
sa	‫Edge مستقل را نصب کنید، یعنی Cassandra،‏ ZooKeeper،‏ Management Server،‏ OpenLDAP، واسط کاربر Edge،‏ Router، و Message Processor. این گزینه اجزای تجزیه‌وتحلیل Edge را حذف می‌کند: Qpid و Postgres. از این گزینه فقط برای توسعه و آزمایش استفاده کنید، نه برای تولید.
aio	همه عناصر را در یک گره نصب کنید. از این گزینه فقط برای توسعه و آزمایش استفاده کنید، نه برای تولید.

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

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

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

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

هشدار: ایجاد فایل پیکربندی در ماشین Windows و سپس کپی کردن آن در ماشین Linux می‌تواند نویسه‌های اضافی پایان خط، برگشت به ابتدا، یا خط جدید به فایل اضافه کند که با همه ابزارهای Linux سازگار نیست. این وضعیت همچنین می‌تواند زمانی رخ دهد که نوشتاری را از ویرایشگر Windows کپی کنید و در پنجره Linux جای‌گذاری کنید. به‌عنوان جایگزین، می‌توانید از ابزار dos2unix در Linux برای پاک‌سازی فایل پیکربندی ایجادشده در Windows استفاده کنید. یا مطمئن شوید که همه ویرایش‌های فایل‌های پیکربندی را در ویرایشگر Linux انجام دهید.

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

در زیر نمونه‌ای از فایل پیکربندی کامل بی‌صدا برای نصب 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 هنگام نصب «سرور مدیریت»، 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	نام واحد پردازشگر پیام و مسیریاب را مشخص کنید. به‌طور پیش‌فرض، نام دروازه است.
REGION	نام منطقه. طبق قرارداد، نام‌ها معمولاً به‌صورت dc-# هستند که # با مقدار عدد صحیح مطابقت دارد. برای مثال، dc-1، dc-2، و غیره. می‌توانید از dc-1 استفاده کنید، مگر اینکه در محیط چندمرکز داده نصب کنید. در نصب چند مرکز داده، مقدار dc-1 یا dc-2 و غیره است، بسته به اینکه کدام مرکز داده را نصب می‌کنید. بااین‌حال، محدود به استفاده از نام‌ها فقط در قالب dc-# نیستید. می‌توانید از هر نامی برای منطقه استفاده کنید.
ZK_HOSTS	نشانی‌های IP یا نام‌های ساناد گره‌های ZooKeeper. نشانی‌های IP یا نام‌های ساناد باید در همه گره‌های ZooKeeper به یک ترتیب فهرست شوند. در محیط چند مرکز داده، همه گره‌های ZooKeeper را از هر دو مرکز داده فهرست کنید. اصلاح‌گر «:observer» را فقط در گره‌های ZooKeeper هنگام ایجاد چندین مرکز داده همان‌گونه که در نصب ۱۲ میزبانی توضیح داده شده است مشخص کنید. در نصب تک‌مرکز داده، این اصلاح‌گر را حذف کنید. برای اطلاعات بیشتر، نصب خوشه‌ای ۱۲ میزبان را ببینید.
ZK_CLIENT_HOSTS	نشانی‌های IP یا نام‌های ساناد گره‌های 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 = مرکز داده ۲ و قفسه/منطقه دردسترس ۱. در محیط چند مرکز داده، برای غلبه بر مشکلات دیوار آتش، CASS_HOSTS باید به گونه‌ای مرتب شوند (همان‌طور که در مثال بالا نشان داده شده است) که گره‌های مرکز داده فعلی در ابتدا قرار گیرند. برای اطلاعات بیشتر، نصب خوشه‌ای ۱۲ میزبان را ببینید.
CASS_AUTH CASS_USERNAME CASS_PASSWORD	اگر اصالت‌سنجی Cassandra را فعال کنید، CASS_AUTH=y، می‌توانید نام کاربری و گذرواژه Cassandra را بااستفاده از این دارایی‌ها ارسال کنید.
PG_MASTER PG_STANDBY	برای فعال کردن تکثیر آماده‌باش اصلی Postgres تنظیم کنید، به‌این شکل: PG_MASTER=*IPorDNSofNewMaster* PG_STANDBY=*IPorDNSofOldMaster*
SKIP_SMTP SMTPHOST SMTPUSER SMTPPASSWORD SMTPSSL SMTPPORT	‫SMTP را پیکربندی کنید تا Edge بتواند ایمیل‌های مربوط به گذرواژه‌های گم‌شده و اعلان‌های دیگر را ارسال کند. اگر اطلاعات اعتباری کاربر SMTP لازم نیست، SMTPUSER و SMTPPASSWORD را حذف کنید.

ترتیب نصب عنصر

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

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

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

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

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

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

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

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