Portalı yükleme

Edge for Private Cloud 4.19.01 sürümü

Apigee Developer Services portalını (veya kısaca portalı) yüklemeden önce şunlardan emin olun:

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

Yükleyici yalnızca Apigee Geliştirici Hizmetleri portalı (veya kısaca portal) için gerekli olan Drupal katkılı modülleri içerir. Katkıda bulunulan diğer modülleri yükleme hakkında bilgi edinmek için Drupal 7'yi genişletme başlıklı makaleyi inceleyin.

Yüklemeye genel bakış

Portalı yüklemek için aşağıdaki adımları uygulayacaksınız. Bu adımların her biri aşağıdaki bölümlerde daha ayrıntılı olarak açıklanmıştır.

1. Bağlantınızı test etme
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öneticisinin etkinleştirildiğinden emin olma
6. (İsteğe bağlı) Apache Solr'u yapılandırma
7. (İsteğe bağlı) SmartDocs'u yükleme
8. (İsteğe bağlı) JQuery'yi yapılandırma

SMTPSSL özelliğinin desteğinin sonlandırılması

Önceki sürümlerde, portala bağlı SMTP sunucusu tarafından kullanılan protokolü ayarlamak için SMTPSSL özelliğini kullanıyordunuz. Bu özelliğin desteği sonlandırıldı.

Portala bağlı SMTP sunucusu tarafından kullanılan protokolü ayarlamak için artık SMTPSSL özelliği yerine SMTP_PROTOCOL özelliğini kullanabilirsiniz. Geçerli değerler: "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ı yapılandırmanız için gerektiği şekilde düzenleyin. Bu dosyayı eklemek için setup.sh ile -f seçeneğini kullanın.

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 yönetim sunucusu arasındaki bağlantıyı test etmek için portal sunucusunda aşağıdaki curl komutunu çalıştırın:

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

EMAIL ve PASSWORD, ORGNAME için yöneticinin e-posta adresi ve şifresidir.

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

İş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ı, yüklemeyi başlatmadan önce sistemde PHP'nin 7.0 öncesi sürümlerinin olup olmadığını kontrol eder. PHP'nin 7.0'dan önceki sürümleri mevcutsa aşağıdaki uyarı mesajı gösterilir:

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 PHP 4.18.01-0.0.49 sürümünü kullandığını unutmayın. Bu sürüm numarası, Apigee Edge for Private Cloud'un sürüm numarasıyla eşleşecek şekilde tasarlanmamıştır.

3. Postgres'i yükleme

Portalın yüklenebilmesi için önce Postgres'in yüklenmesi gerekir. Postgres'i Edge'i yükleme işleminin bir parçası olarak yükleyebilir veya portal tarafından kullanılmak üzere bağımsız olarak yükleyebilirsiniz.

• Edge'in bir parçası olarak yüklenen Postgres'e bağlanıyorsanız ve Postgres, ana/bekleme modunda yapılandırılmışsa ana Postgres sunucusunun IP adresini belirtin.
• Postgres'i bağımsız olarak yüklerseniz portal ile aynı düğümde olabilir.

Edge'i yükleme kapsamında Postgres'i yükleme hakkında bilgi için Edge bileşenlerini bir düğüme yükleme başlıklı makaleyi inceleyin.

Postgres'i bağımsız olarak yüklemek için:

1. İnternet veya internet dışı prosedürü kullanarak düğüme Edge apigee-setup yardımcı programını yükleyin. Daha fazla bilgi için Edge apigee-setup yardımcı programını yükleme başlıklı makaleyi inceleyin.
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. Komut isteminde, Postgres'i yüklemek için 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üklenmesini belirtir. Yapılandırma dosyası, "apigee" kullanıcısı tarafından erişilebilir veya okunabilir olmalıdır.

4. Portalı yükleme

Portalı yükleyebilmek için 3. adımda Postgres'i yükleyin:

1. Edge apigee-setup yardımcı programını portalın düğümüne yükleyin
2. Postgres'i bağımsız olarak veya Edge'i yükleme kapsamında 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, Portal yapılandırma dosyası oluşturma bölümünde açıklandığı şekilde portal yapılandırma dosyasıdır.
   • -p dp, setup komut dosyasına portalı yükleme talimatı verir.

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

1. http://localhost:8079 adresindeki portal ana sayfasına veya portalınızın DNS adına gidin.
2. Portal yapılandırma dosyasında ayarladığınız yönetici kimlik bilgilerini kullanarak portalda oturum açın.
3. Portalın mevcut durumunu görebilmek için Drupal menüsünde Reports > Status Report'u (Raporlar > Durum Raporu) seçin.
4. Yönetim sunucusu bağlantısının başarılı olduğundan emin olun. İşlem size ait değilse:
   1. Portalın Connection Configuration (Bağlantı Yapılandırması) sayfasına (ör. http://portal_IP:8079/admin/config/devconnect) gidin.
   2. Bağlantıyı test et düğmesini tıklayın. Bağlantı başarılı olursa işlem tamamlanmıştır. Bağlantı kurulamadıysa 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 ya da DNS adının ve bağlantı noktası numarasının doğru olup olmadığını kontrol edin. Ö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.

      Varsayılan değerler, yükleme işlemi sırasında oluşturduğunuz portal yapılandırma dosyanızdaki ayarları yansıtır.

      Bu değerler, 1. adım: Apigee Edge bağlantınızı test etme bölümünde kullandığınız ms_IP_or_DNS, email ve password değerleriyle eşleşmelidir. Kullanıcı adı ve şifre, oryantasyon yapılandırma dosyasındaki USER_NAME ve USER_PWD özelliklerinin değerleriyle veya rolü kuruluş yöneticisi olan herhangi bir kullanıcının kimlik bilgileriyle de eşleşmelidir.

   4. Yönetim Sunucusu'na başarıyla bağlandıktan sonra, değişikliklerinizi kaydetmek için sayfanın alt kısmındaki Save configuration (Yapılandırmayı kaydet) düğmesini tıklayın.

5. Güncelleme yöneticisi modülünün etkinleştirildiğinden emin olun.

Drupal güncellemeleriyle ilgili bildirim almak için Drupal Update Manager modülünün etkinleştirildiğinden emin olun. Drupal menüsünden Modules'ı (Modüller) seçin ve aşağı kaydırarak Update manager (Güncelleme yöneticisi) modülüne gidin. Etkinleştirilmemişse etkinleştirin.

Etkinleştirildikten sonra, Raporlar > Mevcut Güncellemeler menü öğesini kullanarak mevcut güncellemeleri görebilirsiniz. Aşağıdaki Drush komutunu da kullanabilirsiniz:

drush pm-info update

Bu komutu sitenin kök dizininden çalıştırmanız gerekir. Portal varsayılan olarak /opt/apigee/apigee-drupal/wwwroot dizinine yüklenir. Bu nedenle, komutu çalıştırmadan önce dizini /opt/apigee/apigee-drupal/wwwroot olarak değiştirmeniz gerekir. Portalı varsayılan dizine yüklemediyseniz yükleme dizininize geçin.

Modülü, güncellemeler kullanıma sunulduğunda size e-posta gönderecek ve güncellemeleri kontrol etme sıklığını ayarlayacak şekilde yapılandırmak için Raporlar > Mevcut Güncellemeler > Ayarlar menü öğesini kullanın.

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

Varsayılan olarak, portalı yüklediğinizde Apache Solr arama motoruna bağlanan Drupal modülleri devre dışı bırakılır. Çoğu portal, dahili Drupal arama motorunu kullandığından Drupal Solr modüllerine ihtiyaç duymaz.

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

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

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

7. SmartDocs'u yükleme (isteğe bağlı)

SmartDocs, API belgelerini tamamen etkileşimli hale getirecek şekilde API'lerinizi portalda belgelemenize olanak tanır. Ancak SmartDocs'u portalda kullanmak için öncelikle Edge'e SmartDocs'u yüklemeniz gerekir.

• Portalı bir Edge Cloud kurulumuna bağlıyorsanız SmartDocs zaten yüklüdür ve başka bir yapılandırma gerekmez.
• Portalı bir Edge for Private Cloud kurulumuna bağlıyorsanız SmartDocs'un Edge'de yüklü olduğundan emin olmanız gerekir. Edge ve SmartDocs'u yükleme hakkında daha fazla bilgi için SmartDocs'u yükleme başlıklı makaleyi inceleyin.

Ayrıca portalda SmartDocs'u da etkinleştirmeniz gerekir. SmartDocs hakkında daha fazla bilgi için API'leri belgelemek için SmartDocs'u kullanma başlıklı makaleyi inceleyin.

8. İnternet dışı yüklemeler için JQuery Update modülünü yapılandırma (İsteğe bağlı)

JQuery Update modülünü internet bağlantısı olmayan bir yüklemede yükleyip kullanırsanız modülü JQuery'nin yerel sürümünü kullanacak şekilde yapılandırmanız gerekir. Modülü, internet dışı bir yükleme için CDN kullanacak şekilde yapılandırırsanız CDN'ye erişmeye çalışır ve sayfa yüklemede gecikmelere neden olur. JQuery Update modülü hakkında daha fazla bilgi için https://www.drupal.org/project/jquery_update adresini ziyaret edin.

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

1. Yönetici veya içerik üretme ayrıcalıklarına sahip bir kullanıcı olarak portalınıza giriş yapın.
2. Drupal menüsünde Configuration > Development > JQuery Update'i (Yapılandırma > Geliştirme > JQuery Güncellemesi) seçin.
3. Soldaki gezinme menüsünde Performans'ı tıklayın.
4. JQuery ve JQuery UI CDN açılır menüsünde Yok'u seçin.
5. Save configuration'ı (Yapılandırmayı kaydet) tıklayın.

9. Sonraki adımlar

Aşağıdaki tabloda, yükleme işleminden sonra gerçekleştirdiğiniz en yaygın görevlerden bazıları listelenmiştir ve daha fazla bilgi bulabileceğiniz Apigee belgelerinin bağlantıları yer almaktadır: