Geliştirici Hizmetleri portalı kurulumu

Developer Services Portal 4.16.09 sürümü

Yüklemeden önce şunlardan emin olun:

• 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 burada bulabilirsiniz.
• Yum yüklü olmalıdır.
• Mevcut yüklemeleri yedeklersiniz. Drupal çekirdeğinde veya özel olmayan modüllerde herhangi bir kodda değişiklik yaptıysanız değişikliklerinizin üzerine yazılır. Buna, .htaccess dosyasında yapmış olabileceğiniz değişiklikler de dahildir. /sites dizini dışındaki her şeyin Drupal'a ait olduğunu varsaymanız gerekir. Bu kuralın istisnası robots.txt dosyasıdır. Web kök dizininde bu dosya varsa sizin için korunur. Yükleme işlemine devam etmeden önce Drupal web kök dizininizin tamamını yedekleyin. Varsayılan yükleme konumu /var/www/html olsa da 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.

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

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. Apigee Edge bağlantınızı test etme

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

CentOS ve Red Hat Enterprise Linux (RHEL) için aşağıdaki komutu kullanarak PHP paketlerini kaldırın:

yum remove <package-name>

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

İnternet bağlantısı olan veya olmayan bir sunucuya yükleme yapmanıza bağlı olarak portalı yüklemek için aşağıdaki prosedürlerden birini kullanın.

İnternet bağlantısı olan bir sunucuda:

Geliştirici Kanalı Hizmetleri'ni internet bağlantısı olan bir sunucuya yüklemek için:

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. 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 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>
4. Şu komutu kullanarak Geliştirici Kanalı Hizmetleri .tar dosyasının içeriğini ayıklayın:
   > tar -xvf <tar file>
5. DeveloperServices-4.x.y.z dizinine geçin.
6. Aşağıdaki komutu kullanarak yükleme komut dosyasını çalıştırın:
   > ./networked-install.sh
7. İstemleri yanıtlayın.

İnternet bağlantısı olmayan bir sunucuda:

Öncelikle, internet bağlantısı olan bir sistemde ağ bağlantısı olmayan bir yükleme komut dosyası oluşturun:

1. İnternet bağlantısı olan bir sistemde root veya süper kullanıcı olarak oturum açın.
2. Yükleme dosyaları için bir dizin (ör. portal_tar) oluşturun.
3. portal_tar 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.
4. Şu komutu kullanarak Developer Channel Services .tar dosyasının içeriğini ayıklayın:
   > tar -xvf <tar file>
5. DeveloperServices-4.x.y.z dizinine gidin.
6. Şu komutu kullanarak portal .tar.gz dosyasını oluşturun:
   > ./non-networked-install.sh

Ağ bağlantısı olmadan yükleme için yeni bir .tar.gz dosyası oluşturulur.

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. portal dizinine gidin.
4. Ağa bağlı olmayan yükleme için oluşturduğunuz .tar.gz dosyasını (yukarıdaki prosedürde) portal dizinine kopyalayın.
5. Şu komutu kullanarak .tar.gz dosyasının içeriğini çıkarın:
   > tar -xvf <tar file>
6. tar komutuyla oluşturulan dizine gidin.
7. install-from-rpm-bundle.sh komut dosyasında izinleri ayarlayın:
   > chmod 755 install-from-rpm-bundle.sh
8. Şu komutu kullanarak install-from-rpm-bundle.sh komut dosyasını çalıştırın:
   > ./install-from-rpm-bundle.sh
9. İstemleri yanıtlayın.

5. Geliştirici portalınızı yapılandırma

Portal yapılandırmasının büyük bir kısmı, Drupal modülü yükleme ve varsayılan içerik oluşturma gibi işlemler için etkileşimde bulunmanızı gerektirmeden yapılır. Veritabanını ayarlamanız, Edge uç noktasını yapılandırmanız ve yeni bir yönetici kullanıcı oluşturmanız istenir.

Geliştirici portalınızı yapılandırmak için:

1. 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.
2. Veritabanı bağlantısını yapılandırın. Veritabanı 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.
3. Aşağıdaki bilgileri girerek Apigee uç noktasıyla bağlantıyı yapılandırın ve Kaydet'i seçin.
   Bu değerler hakkında daha fazla bilgi için Geliştirici Hizmetleri portalı şartları sayfasındaki "Yüklemeye Başlamadan Önce Gerekli Bilgiler" bölümüne bakın.
   1. Management API Org
   2. Management API Endpoint URL (Management API Uç Nokta URL'si)
   3. Uç Nokta Kimliği Doğrulanmış Kullanıcı
   4. Kimliği Doğrulanmış Kullanıcıların Şifresi
4. 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
5. Yükleme tamamlandıktan sonra settings.php dosyasında izinleri ayarlayın:
   > chmod 640 /var/www/html/sites/default/settings.php
6. http://localhost/ adresindeki portal ana sayfasına veya portalınızın DNS adına gidin.
7. Yönetici kimlik bilgilerini kullanarak portalda oturum açın.

6. Yönetici kullanıcı oluşturma (isteğe bağlı)

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. Üretim sunucusuna dağıtma (isteğe bağlı)

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

9. HTTPS'yi desteklemek için mod_ssl'yi yükleme (İsteğe bağlı)

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. SmartDocs'u yükleme (isteğe bağlı)

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: