Portalı yükleme

Apigee Geliştirici Hizmetleri portalını (veya basitçe portalı) yüklemeden önce aşağıdakilerden emin olun:

1. Postgres'i, portalı yüklemeden önce yüklemeniz gerekir. Postgres'i yükleme işlemi veya portal tarafından kullanılmak üzere Postgres'i bağımsız olarak yükleyin.
   • Postgres'i bağımsız olarak yüklerseniz platform, portalla aynı düğümde olabilir.
   • Edge'in bir parçası olarak yüklü Postgres'e bağlanıyorsanız ve Postgres yapılandırılmışsa ana Postgres sunucusunun IP adresini belirtin.
2. Yükleme işlemini Red Hat'ın desteklenen bir sürümünün 64 bit sürümünde gerçekleştiriyorsanız Enterprise Linux, CentOS veya Oracle. Desteklenen sürümlerin listesini şu adreste bulabilirsiniz: Desteklenen yazılımlar ve desteklenen sürümler.
3. Yum yüklendi.

Yükleyici yalnızca Apigee Developer Services portalı (ya da basitçe portal) olabilir. Katkıda bulunulan diğer modülleri yüklemeyle ilgili bilgi edinmek için Drupal 7'yi Uzatma.

Yüklemeye genel bakış

Portalı yüklemek için aşağıdaki adımları uygulayın. Bu adımların her biri daha ayrıntılı değineceğiz.

1. Bağlantınızı test edin
2. PHP'nin 7.0'dan önceki sürümlerini kaldırma
3. Postgres'i yükleme
4. Portalı yükleme
5. Güncelleme Yöneticisi'nin etkinleştirildiğinden emin olun
6. (İsteğe bağlı) Apache Solr'ı yapılandırma
7. (İsteğe bağlı) SmartDokümanlar'ı yükleme
8. (İsteğe bağlı) JQuery'yi yapılandırma

SMTPSSL özelliğinin kullanımdan kaldırılması

Önceki sürümlerde SMTPSSL mülkünü şu amaçlarla kullandınız: portala bağlı SMTP sunucusu tarafından kullanılan protokolü ayarlayın. Bu mülk desteği sonlandırıldı.

Artık SMTP_PROTOCOL özelliğini kullanıyorsunuz. özelliğini ayarlamak için SMTPSSL özelliği yerine portala bağlı SMTP sunucusu tarafından kullanılan protokol olacaktır. Geçerli değerler şunlardır: "standard", "ssl" veya "tls".

Portal yapılandırma dosyası oluşturma

Aşağıda, portal kurulumu için örnek bir sessiz yapılandırma dosyası gösterilmektedir. Bu dosyayı düzenle gerektiği şekilde güncelleyin. Bunu dahil etmek için setup.sh için -f seçeneğini kullanın dosyası olarak kaydedebilirsiniz.

IP1=IPorDNSnameOfNode

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Specify the name of the portal database in Postgres.
PG_NAME=devportal

# Specify the Postgres admin credentials.
# The portal connects to Postgres by using the 'apigee' user.
# If you changed the Postgres password from the default of 'postgres'
# then set PG_PWD accordingly.
# If connecting to a Postgres node installed with Edge,
# contact the Edge sys admin to get these credentials.
PG_USER=apigee
PG_PWD=postgres

# The IP address of the Postgres server.
# If it is installed on the same node as the portal, specify that IP.
# If connecting to a remote Postgres server,specify its IP address.
PG_HOST=$IP1

# The Postgres user credentials used by the portal
# to access the Postgres database,
# This account is created if it does not already exist.
DRUPAL_PG_USER=drupaladmin
DRUPAL_PG_PASS=portalSecret

# Specify 'postgres' as the database.
DEFAULT_DB=postgres

# Specify the Drupal admin account details.
# DO NOT set DEVPORTAL_ADMIN_USERNAME=admin.
# The installer creates this user on the portal.
DEVPORTAL_ADMIN_FIRSTNAME=firstName
DEVPORTAL_ADMIN_LASTNAME=lastName
DEVPORTAL_ADMIN_USERNAME=userName
DEVPORTAL_ADMIN_PWD=PORTAL_ADMIN_PASSWORD
DEVPORTAL_ADMIN_EMAIL=foo@bar.com

# Edge connection details.
# If omitted, you can set them in the portal UI.
# Specify the Edge organization associated with the portal.
EDGE_ORG=edgeOrgName

# Specify the URL of the Edge management API.
# For a Cloud based installation of Edge, the URL is:
# https://api.enterprise.apigee.com/v1
# For a Private Cloud installation, it is in the form:
# http://ms_IP_or_DNS:8080/v1 or
# https://ms_IP_or_DNS:TLSport/v1
MGMT_URL=https://api.enterprise.apigee.com/v1

# The org admin credentials for the Edge organization in the form
# of Edge emailAddress:pword.
# The portal uses this information to connect to Edge.
DEVADMIN_USER=orgAdmin@myCorp.com
DEVADMIN_PWD=ORG_ADMIN_PASSWORD

# The PHP port.
# If omitted, it defaults to 8888.
PHP_FPM_PORT=8888

# Optionally configure the SMTP server used by the portal.
# If you do, the properties SMTPHOST and SMTPPORT are required.
# The others are optional with a default value as notated below.
# SMTP hostname. For example, for the Gmail server, use smtp.gmail.com.
SMTPHOST=smtp.gmail.com

# Set the SMTP protocol as "standard", "ssl", or "tls",
# where "standard" corresponds to HTTP.
# Note that in previous releases, this setting was controlled by the
# SMTPSSL property. That property has been deprecated.
SMTP_PROTOCOL="standard"

# SMTP port (usually 25).
# The value can be different based on the selected encryption protocol.
# For example, for Gmail, the port is 465 when using SSL and 587 for TLS.
SMTPPORT=25

# Username used for SMTP authentication, defaults is blank.
SMTPUSER=your@email.com

# Password used for SMTP authentication, default is blank.
SMTPPASSWORD=YOUR_EMAIL_PASSWORD

1. Apigee Edge bağlantınızı test etme

Portalı yükleyeceğiniz sunucu ile Edge arasındaki bağlantıyı test edin portal sunucusunda aşağıdaki curl komutunu çalıştırarak yönetim sunucusuna gidin:

curl -u EMAIL:PASSWORD http://ms_IP_or_DNS:8080/v1/organizations/ORGNAME

veya:

curl -u EMAIL:PASSWORD https://ms_IP_or_DNS:TLSPort/v1/organizations/ORGNAME

Burada EMAIL ve PASSWORD, ORGNAME yöneticisi.

Edge yüklemenize özgü ana makine adını ve bağlantı noktası numarasını belirttiğinizden emin olun. Bağlantı noktası 8080, Edge tarafından kullanılan varsayılan bağlantı noktasıdır. Buluttaki bir kuruluşa bağlanıyorsanız istek URL'si şöyle olur: https://api.enterprise.apigee.com/v1/organizations/ORGNAME.

İşlem başarılı olursa curl aşağıdakine benzer bir yanıt döndürür:

{
  "createdAt" : 1348689232699,
  "createdBy" : "USERNAME",
  "displayName" : "cg",
  "environments" : [ "test", "prod" ],
  "lastModifiedAt" : 1348689232699,
  "lastModifiedBy" : "foo@bar.com",
  "name" : "cg",
  "properties" : {
    "property" : [ ]
  },
  "type" : "trial"
}

2. PHP'nin 7.0'dan önceki sürümlerini kaldırma

Yükleme komut dosyası, çalıştırmadan önce sistemde PHP'nin 7.0 öncesi sürümlerini kontrol eder teşekkür ederiz. PHP'nin 7.0'dan önceki sürümleri varsa aşağıdaki uyarı mesajı görüntülenir:

The following packages present on your system conflict with software we are
about to install. You will need to manually remove each one, then re-run this install script.

php
php-cli
php-common
php-gd
php-mbstring
php-mysql
php-pdo
php-pear
php-pecl-apc
php-process
php-xml

Aşağıdaki komutu kullanarak PHP paketlerini kaldırın:

yum remove package_name

Sunucunuzda PHP'nin yüklü olup olmadığından emin değilseniz aşağıdaki komutu kullanın:

rpm -qa | grep -i php

Portalın 4.18.01-0.0.49 PHP sürümünü kullandığını unutmayın. Bu, Private Cloud için Apigee Edge'in sürüm numarası.

3. Postgres'i yükle

Portal, yüklenmeden önce Postgres'in yüklenmiş olmasını gerektirir. Aşağıdaki yöntemlerden birini uygulayabilirsiniz yüklemenin bir parçası olarak Postgres'i yükleyebilir veya portalında yer alır.

• Edge'in bir parçası olarak yüklenen Postgres'e bağlanıyorsanız ve Postgres ana Postgres sunucusunun IP adresini belirtin.
• Postgres'i bağımsız olarak yüklerseniz platform, portalla aynı düğümde olabilir.

Edge'in yüklenmesinin bir parçası olarak Postgres'in yüklenmesi hakkında bilgi edinmek için bkz. Edge bileşenlerini bir düğüme yükleyin.

Postgres bağımsız sürümünü yüklemek için:

1. Şunu kullanarak düğüme Edge apigee-setup yardımcı programını yükleyin: internette olup olmadığını kontrol edin. Görüntüleyin Daha fazlası için Edge Apigee-setup yardımcı programını yükleyin.
2. Aşağıdaki örnekte gösterildiği gibi bir Postgres yapılandırma dosyası oluşturun:

   # Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost
   HOSTIP=$(hostname -i)
   
   # The pod and region of Postgres. Use the default values shown below.
   MP_POD=gateway
   REGION=dc-1
   
   # Set the Postgres password. The default value is 'postgres'.
   PG_PWD=postgres

3. Postgres'i yüklemek için komut isteminde kurulum komut dosyasını çalıştırın:

   /opt/apigee/apigee-setup/bin/setup.sh -p pdb -f postgres_config_file

   -p pdb seçeneği Postgre'nin yükleneceğini belirtir. Yapılandırma dosyası "Apigee" tarafından erişilebilir veya okunabilir olmalıdır. belirtir.

4. Portalı yükleme

Portalı yüklemeden önce aşağıda açıklandığı şekilde aşağıdakileri yaptığınızdan emin olun: 3. Postgres'i yükleyin:

1. Portalın düğümüne Edge apigee-setup yardımcı programını yükleyin
2. Postgres'i bağımsız olarak veya Edge yükleme işleminin bir parçası olarak yükleyin

Portalı yüklemek için:

1. Komut isteminde setup komut dosyasını çalıştırın:

   /opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile

   Burada:

   • configFile, aşağıda açıklandığı gibi portal yapılandırma dosyasıdır Portal yapılandırma dosyası oluşturun.
   • -p dp, setup komut dosyasına portalı yükleme talimatı verir.

Portal yüklemesinin başarılı olduğunu doğrulamak için:

1. http://localhost:8079 adresindeki portal ana sayfasına veya DNS adına gidin birçok yolu vardır.
2. Portalda ayarladığınız yönetici kimlik bilgilerini kullanarak portala giriş yapın yapılandırma dosyası.
3. Raporlar > Drupal menüsündeki Durum Raporu'nu ziyaret edin. portalın mevcut durumunu görebilir.
4. Yönetim Sunucusu bağlantısının başarılı olduğundan emin olun. Yayınlanmadıysa:
   1. Portal Bağlantı Yapılandırması sayfasına gidin (örneğin, http://portal_IP:8079/admin/config/devconnect) bilgileri gösterilir.
   2. Bağlantıyı Test Et düğmesini tıklayın. Bağlantı başarılı olursa bitti. Bağlantı kurulamazsa devam edin.
   3. Uç nokta ve kimlik doğrulama ayarlarını kontrol edin:
      • Management API uç nokta URL'si: Protokolün (HTTP veya HTTPS), IP veya DNS adı ve bağlantı noktası numarasının doğru olduğundan emin olun. örneğin:

        http://10.10.10.10:8080/v1

      • Uç nokta kimliği doğrulanmış kullanıcı: Kuruluş yöneticisinin kullanıcı adı.
      • Kimliği doğrulanmış kullanıcının şifresi: Kuruluş yöneticisinin şifresi şifre.

      Varsayılan değerler, portal yapılandırma dosyanızdaki daha önce güncellediğiniz otomatik olarak oluşturulur.

      Bu değerler ms_IP_or_DNS, email ve Adımda kullandığınız password değer 1: Apigee Edge bağlantınızı test edin. Kullanıcı adı ve şifre de USER_NAME değerleriyle eşleşmelidir. ve USER_PWD mülk ilk katılım yapılandırma dosyası veya kimlik bilgileri ile birlikte yeniden etkinleştirilmelidir.

   4. Yönetim Sunucusu'na başarıyla bağlandıktan sonra, Yönetici Konsolu'ndaki Kaydet yapılandırma düğmesini tıklayın.

5. Güncelleme yöneticisi modülünün etkin

Drupal güncellemeleriyle ilgili bildirim almak için Drupal Update yönetici modülünün etkin. Drupal menüsünden Modüller'i seçin ve aşağı kaydırarak Yöneticiyi güncelleyin. Etkin değilse etkinleştirin.

Bu özelliği etkinleştirdikten sonra Raporlar > Uygun Güncellemeler menü öğesi. Aşağıdaki Drush komutunu da kullanabilirsiniz:

drush pm-info update

Bu komutu sitenin kök dizininden çalıştırmanız gerekir. Varsayılan olarak portal, /opt/apigee/apigee-drupal/wwwroot adresinde yüklendi. Dolayısıyla, dizini /opt/apigee/apigee-drupal/wwwroot olarak değiştirmeniz gerekir komutunu çalıştırın. Portalı, varsayılan dizine yüklemediyseniz yükleme dizinini oluşturur.

Raporlar > Mevcut Güncellemeler > Yapılandırılacak Ayarlar menü öğesi güncellemeler olduğunda size e-posta gönderecek ve güncellemeleri kontrol etme sıklığını güncellemelerine göz atın.

6. Apache Solr arama motorunu yapılandırma (İsteğe bağlı)

Apache Solr arama motoruna bağlanan Drupal modülleri, varsayılan olarak devre dışıdır. portalı yüklemeniz gerekir. Çoğu portal dahili Drupal arama motoru kullandığından gerekir.

Arama motorunuz olarak Solr'ı kullanmaya karar verirseniz sunucunuza yerel olarak Solr'ı yüklemeniz gerekir ve ardından portalda Drupal Solr modüllerini etkinleştirip yapılandıracaksınız.

Drupal Solr modüllerini etkinleştirmek için:

1. Portalınıza, yönetici veya içerik oluşturma ayrıcalıklarına sahip bir kullanıcı olarak giriş yapın.
2. Drupal menüsünde Modüller'i seçin.
3. Apache Solr Framework modülünü ve Apache Solr'ı etkinleştirin Arama modülü.
4. Değişikliklerinizi kaydedin.
5. Solr'ı https://drupal.org/node/1999280 adresinde açıklandığı şekilde yapılandırın.

7. SmartDokümanlar'ı Yükle (İsteğe Bağlı)

SmartDokümanlar, API'lerinizi portalda belgelemenizi sağlayacak şekilde API belgeleri tamamen etkileşimlidir. Ancak, SmartDokümanlar'ı portalla kullanmak için öncelikle Edge'de SmartDokümanlar'ı yükleyeceksiniz.

• Portalı bir Edge Cloud kurulumuna bağlıyorsanız SmartDokümanlar zaten yüklenir ve başka yapılandırma gerekmez.
• Portalı, Private Cloud kurulumu için bir Edge'e bağlıyorsanız Edge'de yüklü olduğundan emin olun. Edge ve SmartDokümanlar'ı yüklemeyle ilgili daha fazla bilgi için bkz. SmartDokümanlar'ı yükleyin.

Portalda SmartDokümanlar'ı da etkinleştirmeniz gerekir. SmartDokümanlar hakkında daha fazla bilgi için bkz. Doküman oluşturmak için SmartDokümanlar'ı kullanma API'ler.

8. Şunu yapılandır: İnternet dışı yüklemeler için JQuery Güncelleme modülü (İsteğe bağlı)

JQuery Update modülünü internet harici bir kurulumda yükleyip kullanırsanız modülü JQuery'nin yerel sürümünü kullanacak şekilde yapılandırın. Modülü bir CDN kullanacak şekilde yapılandırırsanız bu, internet harici bir kurulumda CDN'ye erişmeye çalışır ve sayfada gecikmelere neden olur. yükleniyor. JQuery Güncelleme modülü hakkında daha fazla bilgi için bkz. https://www.drupal.org/project/jquery_update.

JQuery Güncelleme modülünü JQuery'nin yerel sürümünü kullanacak şekilde yapılandırmak için:

1. Portalınıza, yönetici veya içerik oluşturma ayrıcalıklarına sahip bir kullanıcı olarak giriş yapın.
2. Yapılandırma > Geliştirme > JQuery Güncellemesi'ni tıklayın.
3. Soldaki gezinme menüsünden Performans'ı tıklayın.
4. JQuery ve JQuery kullanıcı arayüzü CDN açılır menüsünden None'u (Yok) seçin.
5. Yapılandırmayı kaydet'i tıklayın.

9. Sonraki adımlar

Aşağıdaki tabloda yükleme işleminden sonra gerçekleştirdiğiniz ve ve daha fazla bilgi bulabileceğiniz Apigee belgelerinin bağlantılarını içerir: