Geliştirici Hizmetleri portalı kurulumu

Geliştirici Hizmetleri Portalı sürüm 4.16.05

Geliştirici Kanal Hizmetleri portalını yüklemek için aşağıdaki adımları uygulayın.

Yükleme işlemine devam etmeden önce Drupal web kök dizininizin tamamını yedekleyin. Varsayılan yükleme konumu /var/www/html şeklindedir ancak yükleme sırasında bu konumu değiştirmiş olabilirsiniz. Aşağıda açıklanan yükleme adımlarını uyguladıktan sonra özelleştirmelerinizi yedekten geri yükleyebilirsiniz.

1. Developer Channel Services paketini edinme

http://community.apigee.com/content/apigee-customer-support adresine gidin ve Developer Channel Services .tar dosyasını iki yöntemden biriyle istemek için Login to your Support Portal'ı (Destek Portalınıza Giriş Yapın) seçin:

• Edge for Private Cloud indirme dizinine erişim isteyin.
• Geliştirici Kanalı Hizmetleri .tar dosyasının URL'sini isteyin.

2. Sisteminizin sistem gereksinimlerini karşıladığından emin olun.

Portalı yüklemeden önce sunucunuzun aşağıdaki koşulları karşılaması gerekir:

1. 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ştirdiğinizden emin olun. Desteklenen sürümlerin listesini burada bulabilirsiniz.
2. Yum'un yüklü olduğundan emin olun.
3. (İnternet bağlantısı olmayan bir sunucuya kurulum için) Öncelikle gerekli tüm dosyaları tek bir .tar.gz dosyası olarak internet bağlantısı olan bir sunucuya indirmeniz gerekir. Ardından, yükleme işlemini gerçekleştirmek için bu .tar.gz dosyasını internet bağlantısı olmayan sunucuya kopyalarsınız.
   1. İnternet bağlantısı olan bir sunucuya root veya süper kullanıcı olarak giriş yapın.
   2. Yükleme dosyaları için bir dizin (ör. portal_tar) oluşturun.
   3. Yeni dizine geçin ve Geliştirici Kanalı Hizmetleri DeveloperServices_x.y.z.tar dosyasını indirin. Burada x.y.z, portal sürüm numarasını ifade eder.
   4. Şu komutu kullanarak Geliştirici Kanalı Hizmetleri .tar dosyasının içeriğini çıkarın:
      > tar -xvf <tar file>
   5. DeveloperServices-4.x.y.z dizinine geçin.
   6. Şu komutu kullanarak portal .tar.gz dosyasını oluşturun:
      > ./non-networked-install.sh
      
      Bu komut, gerekli tüm dosyaları indirir ve tek bir .tar.gz dosyasına ekler. Ardından, yüklemeyi tamamlamak için bu .tar.gz dosyasını internet bağlantısı olmayan sunucunuza kopyalarsınız.
4. Portal sunucusundaki bir komut isteminden aşağıdaki cURL komutunu çalıştırarak Edge yönetim sunucusuyla bağlantınızı test edin:
   > curl -u {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}
   
   Burada EMAIL ve PASSWORD, ORGNAME yöneticisinin 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 şöyledir:
   https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}
   
   Bu komut başarılı olursa 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"
   }

3. Otomatik yükleme komut dosyasını kullanarak Geliştirici Kanalı Hizmetleri'ni yükleme

Otomatik yükleme komut dosyasını kullanarak portalı yüklemek için aşağıdaki prosedürü uygulayın. Bu prosedür, harici internet bağlantısı olan veya olmayan sunucularda çalışır.

1. Sunucuya kök veya süper kullanıcı olarak giriş yapın.
2. Yükleme dosyaları için bir dizin (ör. portal) oluşturun.
3. İnternet bağlantısı olan bir sunucuda:
   1. Yeni portal dizinine gidin ve Geliştirici Kanalı Hizmetleri DeveloperServices_x.y.z.tar dosyasını indirin. Burada x.y.z, portal sürüm numarasını ifade eder.
      
      Apigee tarafından size gönderilen bağlantıdaki dosyayı tarayıcıda açarak veya kopyalayıp aşağıdaki cURL komutuna ekleyerek indirebilirsiniz:
      > curl -kOL <bağlantıyı buraya yapıştırın>
   2. Şu komutu kullanarak Geliştirici Kanalı Hizmetleri .tar dosyasının içeriğini çıkarın:
      > tar -xvf <tar file>
   3. DeveloperServices-4.x.y.z dizinine geçin.
   4. Aşağıdaki komutu kullanarak yükleme komut dosyasını çalıştırın:
      > ./networked-install.sh
4. İnternet bağlantısı olmayan bir sunucuda:
   1. Yukarıda 2. bölümde oluşturduğunuz .tar.gz dosyasını kopyalayın. Sisteminizin sistem gereksinimlerini karşıladığından emin olun.
   2. Şu komutu kullanarak .tar.gz dosyasının içeriğini çıkarın:
      > tar -xvf <tar file>
   3. tar komutuyla oluşturulan dizine gidin.
   4. install-from-rpm-bundle.sh komut dosyasında izinleri ayarlayın:
      > chmod 755 install-from-rpm-bundle.sh
   5. Şu komutu kullanarak install-from-rpm-bundle.sh komut dosyasını çalıştırın:
      > ./install-from-rpm-bundle.sh
5. İstemleri yanıtlayın.
6. Yükleme tamamlandıktan sonra bir tarayıcıda sunucu URL'sine gidin. Örneğin:
   http://localhost. Belirli bir IP veya DNS yapılandırdıysanız http://IP_adresi ya da http://DNS_adı adresine gidin.
   
   Apigee profili veritabanı yapılandırma sayfasına yönlendirilirsiniz.
   
   Not: Genellikle, http://localhost kullanmak zorunda kalmamak için bir ana makine adı yapılandırıp DNS sunucunuza kaydetmiş olursunuz.
7. MySQL bağlantısını yapılandırın. MySQL uzak bir makinedeyse Gelişmiş Seçenekler bölümünü genişletin ve bu makinenin bağlantı bilgilerini girin, ardından Kaydet ve devam et'i seçin.
8. Aşağıdaki bilgileri girerek Apigee uç noktası bağlantısını yapılandırın ve Kaydet'i seçin:
   Bu değerler hakkında daha fazla bilgi için Geliştirici Hizmetleri portalı şartları bölümündeki "Yüklemeyi başlatmadan önce gereken bilgiler" başlıklı makaleyi inceleyin.
   1. Dev Portal Org
   2. Dev Portal Endpoint URL (Geliştirici Portalı Uç Nokta URL'si)
   3. Uç Nokta Kimliği Doğrulanmış Kullanıcı
   4. Kimliği Doğrulanmış Kullanıcıların Şifresi
9. İstendiğinde, örnek SmartDocs WADL'yi yüklemek için Install Sample SmartDocs WADL (Örnek SmartDocs WADL'yi Yükle) düğmesini seçin. Bu adımı atlarsanız örnek SmartDocs API'si portalınızda görünmez.
   Not: Portalınız, Özel Bulut için Apigee Edge kurulumuna bağlanıyorsa ve bu Edge kurulumunun harici internet bağlantısı yoksa SmartDocs'u kullanabilmek için SmartDocs modülünde ek yapılandırma yapmanız gerekir. SmartDocs hakkında daha fazla bilgi için http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis adresini ziyaret edin.
10. SMTP Sunucu Ayarları'nı yapılandırın. Apigee, portaldan e-posta iletileri göndermek için bir SMTP sunucusu yapılandırmanızı gerektirir.
    Daha fazla bilgi için http://apigee.com/docs/developer-services/content/configuring-email adresini ziyaret edin.
11. Aşağıdaki bilgileri girerek yönetici kullanıcıyı yapılandırın ve ardından Kaydet'i seçin. Drupal'ın varsayılan olarak "admin" adında bir yönetici kullanıcı oluşturduğunu unutmayın. Bu nedenle, kullanıcı adı olarak "admin"i kullanmayın.
    Bu adımı atlarsanız 4. adımda açıklandığı gibi Drush'ı kullanarak yönetici oluşturabilirsiniz. Yönetici kullanıcı oluşturun.
    1. Geliştiricinin adı ve soyadı
    2. Geliştirici portalı kullanıcı adı
    3. Şifre
    4. E-posta adresi
12. Yükleme tamamlandıktan sonra settings.php dosyasında izinleri ayarlayın:
    > chmod 640 /var/www/html/sites/default/settings.php
13. http://localhost/ adresindeki portal ana sayfasına veya portalınızın DNS adına gidin.
14. Yönetici kimlik bilgilerini kullanarak portalda oturum açın.

4. Yönetici kullanıcı oluşturma

Developer Channel Services kurulumunuz için yönetici kullanıcı oluşturmak üzere Drush'ı kullanın. Drupal, varsayılan olarak otomatik bir şekilde "admin" adında bir yönetici kullanıcı oluşturur. Bu nedenle, kullanıcı adı olarak "admin" kullanmayın.

1. drupal_root/sites/default dizininize gidin. Drupal kök dizininin standart konumu /var/www/html şeklindedir:
   > cd <drupal_root>/sites/default
2. Özel Drupal dosyaları için yazma izinlerinizin olduğundan emin olun:
   > drush vget file_private_path
   
   Bu komut, özel Drupal dosyalarının yolunu döndürür. Örneğin:
   file_private_path: 'sites/default/private'
   
   /var/www/html/sites/default/private/ yoluna karşılık gelir. Bu dizinin, sahibi ve grup tarafından yazılabilir olduğundan emin olmak için aşağıdaki komutu kullanın:
   chmod -R g+w dirPathAndName
   chmod -R o+r dirPathAndName
3. Yönetici kullanıcı oluşturmak için aşağıdaki komutları girin ve "< >" içindeki komutları kendi değerlerinizle değiştirin:
   > drush user-create <username> --mail="<email-address>" --password="<password>"
   > drush user-add-role Administrator <username>
4. Yukarıda belirtilen kullanıcı adı ve şifreyi kullanarak geliştirici portalına yönetici olarak giriş yapın.

5. MySQL kök şifresini ayarlama

MySQL'i portal kurulumunun bir parçası olarak yüklediyseniz yükleme komut dosyası, MySQL kök şifresini varsayılan değerine (boş) ayarlanmış olarak bırakır.

Kök şifresini ayarlamak için aşağıdaki komutu kullanın:

> mysqladmin -u root password NEWPASSWORD

Daha önce kök şifresini ayarladıysanız ve değiştirmek istiyorsanız aşağıdaki komutu kullanın:

> mysqladmin -u root -p'OLDPASSWORD' password NEWPASSWORD

Ayrıca /var/www/html/sites/default/settings.php dosyasındaki şifreyi de güncellemeniz gerekir.

6. 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

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.

7. İsteğe bağlı: Üretim sunucusuna dağıtma

Portalı bir üretim sunucusuna dağıtıyorsanız aşağıdakiler de dahil olmak üzere ek güvenlik adımları uygulamanız gerekir:

1. MySQL kurulumunuzun güvenliğini sağlamak için aşağıdaki komut dosyasını çalıştırın:
   > /usr/bin/mysql_secure_installation
   
   Bu komut dosyası, kök şifresini ayarlar ve kök erişimini yalnızca yerel ana makineyle kısıtlama ve varsayılan olarak oluşturulan test veritabanlarını ve anonim kullanıcıyı kaldırma seçeneği sunar. Üretim sunucuları için bu komut dosyasını çalıştırmanız önemle tavsiye edilir.
2. Şirket politikalarınız gerektiriyorsa SELinux'u etkinleştirin ve yapılandırın.

8. İsteğe bağlı: Apache Solr arama motorunu yapılandırma

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.

9. İsteğe bağlı: HTTPS'yi desteklemek için mod_ssl'yi yükleyin

mod_ssl modülü, Apache HTTP Sunucusu tarafından web sayfalarını HTTPS üzerinden sunmak için kullanılır. HTTPS kullanmak istiyorsanız mod_ssl'yi yüklemek için aşağıdaki komutu kullanın:

> yum install mod_ssl

Portalı SSL kullanacak şekilde yapılandırma hakkında daha fazla bilgi için http://apigee.com/docs/developer-services/content/using-ssl-portal adresini ziyaret edin.

10. İsteğe bağlı - SmartDocs'u yükleme

SmartDocs, API belgelerini tamamen etkileşimli hale getirecek şekilde API'lerinizi Geliştirici Hizmetleri portalında 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.

SmartDocs hakkında daha fazla bilgi için API'leri belgelemek için SmartDocs'u kullanma başlıklı makaleyi inceleyin.

11. Sırada ne var?

Geliştirici Hizmetleri portalını yükledikten sonraki adımlarınız, portalı özel gereksinimlerinize göre yapılandırmak ve özelleştirmektir. Apigee web sitesindeki dokümanlar, portal yapılandırma, stil oluşturma ve yönetme ile ilgili tüm bilgileri içerir. Belgelere http://apigee.com/docs/developer-services/content/what-developer-portal adresinden erişebilirsiniz.

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: