डेवलपर सेवाओं के लिए पोर्टल इंस्टॉल करना

Developer Services Portal v. 4.16.09

इंस्टॉल करने से पहले, पक्का करें कि:

• Red Hat Enterprise Linux, CentOS या Oracle के 64-बिट वर्शन पर इंस्टॉल किया जा रहा हो. इस्तेमाल किए जा सकने वाले वर्शन की सूची यहां देखें.
• Yum इंस्टॉल हो.
• मौजूदा इंस्टॉलेशन का बैकअप लिया जाता है. अगर आपने Drupal कोर या किसी गैर-कस्टम मॉड्यूल में किसी कोड में बदलाव किया है, तो आपके बदलावों को ओवरराइट कर दिया जाएगा. इसमें, .htaccess में किए गए बदलावों के साथ-साथ अन्य चीज़ें भी शामिल हैं. आपको यह मान लेना चाहिए कि /sites डायरेक्ट्री के बाहर मौजूद हर चीज़ का मालिकाना हक Drupal के पास है. इस नियम का एक अपवाद robots.txt है. अगर यह फ़ाइल वेब रूट में मौजूद है, तो इसे आपके लिए सुरक्षित रखा जाएगा. इंस्टॉल करने से पहले, अपनी पूरी Drupal वेब रूट डायरेक्ट्री का बैकअप लें. इंस्टॉल करने की डिफ़ॉल्ट जगह /var/www/html है. हालांकि, हो सकता है कि आपने इंस्टॉल करते समय इसे बदल दिया हो. इंस्टॉल करने के लिए नीचे दिए गए चरणों को पूरा करने के बाद, बैकअप से अपनी पसंद के मुताबिक की गई सेटिंग को वापस लाया जा सकता है.

Developer Channel Services पोर्टल इंस्टॉल करने के लिए, यह तरीका अपनाएं.

1. Developer Channel Services बंडल पाना

http://community.apigee.com/content/apigee-customer-support पर जाएं और डेवलपर चैनल की सेवाओं की .tar फ़ाइल का अनुरोध करने के लिए, सहायता पोर्टल में लॉग इन करें. इसके लिए, इनमें से कोई एक तरीका चुनें:

• Edge for Private Cloud की डाउनलोड डायरेक्ट्री का ऐक्सेस पाने का अनुरोध करें.
• डेवलपर चैनल की सेवाओं की .tar फ़ाइल के यूआरएल का अनुरोध करें.

2. Apigee Edge से अपने कनेक्शन की जांच करना

Edge मैनेजमेंट सर्वर से अपने कनेक्शन की जांच करने के लिए, पोर्टल सर्वर पर कमांड प्रॉम्प्ट से यह cURL कमांड चलाएं:
> curl -u {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}

यहां EMAIL और PASSWORD, ORGNAME के एडमिन का ईमेल पता और पासवर्ड है.

पक्का करें कि आपने Edge के अपने इंस्टॉलेशन के लिए, होस्टनेम और पोर्ट नंबर डाला हो. Edge, डिफ़ॉल्ट रूप से पोर्ट 8080 का इस्तेमाल करता है. अगर आपको क्लाउड में किसी संगठन से कनेक्ट करना है, तो अनुरोध का यूआरएल यह है: https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}

अगर यह कमांड सही तरीके से काम करता है, तो आपको इस तरह का जवाब मिलेगा:
{
"createdAt" : 1348689232699,
"createdBy" : "USERNAME",
"displayName" : "cg",
"environments" : [ "test", "prod" ],
"lastModifiedAt" : 1348689232699,
"lastModifiedBy" : "foo@bar.com",
"name" : "cg",
"properties" : {
"property" : [ ]
},
"type" : "trial"
}

3. PHP के 7.0 से पहले के वर्शन हटाना

इंस्टॉल करने की स्क्रिप्ट, सिस्टम पर PHP के 7.0 से पहले के वर्शन की जांच करती है. इसके बाद, इंस्टॉल करने की प्रोसेस शुरू होती है. अगर PHP के 7.0 से पहले के वर्शन मौजूद हैं, तो चेतावनी देने वाला यह मैसेज दिखता है:

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 और Red Hat Enterprise Linux (RHEL) के लिए, नीचे दिए गए कमांड का इस्तेमाल करके PHP पैकेज हटाएं:

yum remove <package-name>

4. अपने-आप इंस्टॉल होने वाली स्क्रिप्ट का इस्तेमाल करके, Developer Channel Services को इंस्टॉल करना

पोर्टल इंस्टॉल करने के लिए, इनमें से कोई एक तरीका अपनाएं. यह इस बात पर निर्भर करता है कि पोर्टल को इंटरनेट कनेक्शन वाले सर्वर पर इंस्टॉल किया जा रहा है या बिना इंटरनेट कनेक्शन वाले सर्वर पर.

इंटरनेट कनेक्शन वाले सर्वर पर:

इंटरनेट कनेक्शन वाले सर्वर पर Developer Channel Services इंस्टॉल करने के लिए:

1. रूट या सुपर उपयोगकर्ता के तौर पर सर्वर में लॉग इन करें.
2. इंस्टॉल की जाने वाली फ़ाइलों के लिए कोई डायरेक्ट्री बनाएं, जैसे कि portal.
3. नई पोर्टल डायरेक्ट्री पर जाएं और डेवलपर चैनल की सेवाओं की DeveloperServices_x.y.z.tar फ़ाइल डाउनलोड करें. यहां x.y.z, पोर्टल के वर्शन नंबर को दिखाता है.
   
   Apigee ने आपको जो लिंक भेजा है उससे फ़ाइल डाउनलोड की जा सकती है. इसके लिए, लिंक को ब्राउज़र में खोलें या उसे कॉपी करके इस cURL कमांड में जोड़ें:
   > curl -kOL <paste link here>
4. इस निर्देश का इस्तेमाल करके, Developer Channel Services की .tar फ़ाइल का कॉन्टेंट निकालें:
   > tar -xvf <tar file>
5. DeveloperServices-4.x.y.z पर जाएं.
6. इस कमांड का इस्तेमाल करके, इंस्टॉल स्क्रिप्ट चलाएं:
   > ./networked-install.sh
7. प्रॉम्प्ट का जवाब दें.

इंटरनेट कनेक्शन के बिना किसी सर्वर पर:

सबसे पहले, इंटरनेट कनेक्शन वाले सिस्टम पर, बिना नेटवर्क वाली इंस्टॉल स्क्रिप्ट बनाएं:

1. इंटरनेट कनेक्शन वाले सिस्टम में रूट या सुपरयूज़र के तौर पर लॉग इन करें.
2. इंस्टॉल की जाने वाली फ़ाइलों के लिए कोई डायरेक्ट्री बनाएं, जैसे कि portal_tar.
3. portal_tar डायरेक्ट्री में जाएं और Developer Channel Services DeveloperServices_x.y.z.tar फ़ाइल डाउनलोड करें. यहां x.y.z, पोर्टल का वर्शन नंबर है.
4. डेवलपर चैनल की सेवाओं की .tar फ़ाइल का कॉन्टेंट निकालने के लिए, इस निर्देश का इस्तेमाल करें:
   > tar -xvf <tar file>
5. DeveloperServices-4.x.y.z पर जाएं.
6. इस कमांड का इस्तेमाल करके, पोर्टल की .tar.gz फ़ाइल बनाएं:
   > ./non-networked-install.sh

बिना नेटवर्क के इंस्टॉल करने के लिए, एक नई .tar.gz फ़ाइल बनाई जाती है.

1. रूट या सुपर उपयोगकर्ता के तौर पर सर्वर में लॉग इन करें.
2. इंस्टॉल की जाने वाली फ़ाइलों के लिए कोई डायरेक्ट्री बनाएं, जैसे कि portal.
3. portal डायरेक्ट्री पर जाएं.
4. बिना नेटवर्क वाले इंस्टॉल के लिए बनाई गई .tar.gz फ़ाइल को portal डायरेक्ट्री में कॉपी करें. इसके लिए, ऊपर दी गई प्रोसेस अपनाएं.
5. इस निर्देश का इस्तेमाल करके, .tar.gz फ़ाइल का कॉन्टेंट निकालें:
   > tar -xvf <tar file>
6. tar कमांड से बनाई गई डायरेक्टरी में जाएं.
7. install-from-rpm-bundle.sh स्क्रिप्ट पर अनुमतियां सेट करें:
   > chmod 755 install-from-rpm-bundle.sh
8. इस निर्देश का इस्तेमाल करके, install-from-rpm-bundle.sh स्क्रिप्ट चलाएं:
   > ./install-from-rpm-bundle.sh
9. प्रॉम्प्ट का जवाब दें.

5. अपना डेवलपर पोर्टल कॉन्फ़िगर करना

पोर्टल का ज़्यादातर कॉन्फ़िगरेशन, आपकी मदद के बिना ही हो जाता है. जैसे, Drupal मॉड्यूल इंस्टॉल करना और डिफ़ॉल्ट कॉन्टेंट बनाना. आपको डेटाबेस सेट अप करने, Edge एंडपॉइंट को कॉन्फ़िगर करने, और खाते का नया एडमिन बनाने के लिए कहा जाएगा.

डेवलपर पोर्टल को कॉन्फ़िगर करने के लिए:

1. किसी ब्राउज़र में सर्वर यूआरएल पर जाएं, जैसे:
   http://localhost. इसके अलावा, अगर आपने कोई आईपी या डीएनएस कॉन्फ़िगर किया है, तो http://IP_address या http://DNS_name पर जाएं.
   
   आपको Apigee प्रोफ़ाइल के डेटाबेस कॉन्फ़िगरेशन पेज पर रीडायरेक्ट किया जाएगा.
   
   ध्यान दें: आम तौर पर, आपने पहले से ही होस्टनेम कॉन्फ़िगर किया होगा और उसे अपने डीएनएस सर्वर के साथ रजिस्टर किया होगा, ताकि आपको http://localhost का इस्तेमाल न करना पड़े.
2. डेटाबेस से कनेक्शन कॉन्फ़िगर करें. अगर डेटाबेस किसी रिमोट मशीन पर है, तो बेहतर विकल्प सेक्शन को बड़ा करें और उस मशीन के कनेक्शन की जानकारी डालें. इसके बाद, सेव करें और जारी रखें को चुनें.
3. Apigee एंडपॉइंट से कनेक्शन कॉन्फ़िगर करने के लिए, यह जानकारी डालें. इसके बाद, सेव करें को चुनें.
   इन वैल्यू के बारे में ज़्यादा जानकारी के लिए, डेवलपर सेवाओं के पोर्टल की ज़रूरी शर्तें में "इंस्टॉल करने से पहले ज़रूरी जानकारी" देखें.
   1. Management API Org
   2. Management API एंडपॉइंट यूआरएल
   3. Endpoint Authenticated User
   4. पुष्टि किए गए उपयोगकर्ताओं का पासवर्ड
4. एडमिन उपयोगकर्ता को कॉन्फ़िगर करने के लिए, यह जानकारी डालें. इसके बाद, सेव करें को चुनें. ध्यान दें कि Drupal, डिफ़ॉल्ट रूप से 'admin' नाम से एक एडमिन उपयोगकर्ता बनाता है. इसलिए, उपयोगकर्ता नाम के तौर पर 'admin' का इस्तेमाल न करें.
   अगर यह चरण छोड़ दिया जाता है, तो भी Drush का इस्तेमाल करके एडमिन बनाया जा सकता है. इसके लिए, नीचे चौथे चरण में बताया गया तरीका अपनाएं. खाते का एडमिन बनाएं.
   1. डेवलपर का नाम और सरनेम
   2. डेवलपर पोर्टल का उपयोगकर्ता नाम
   3. पासवर्ड
   4. ईमेल पता
5. इंस्टॉलेशन पूरा होने के बाद, settings.php फ़ाइल पर अनुमतियां सेट करें:
   > chmod 640 /var/www/html/sites/default/settings.php
6. http://localhost/ पर मौजूद पोर्टल के होम पेज पर जाएं या अपने पोर्टल के डीएनएस नाम पर जाएं.
7. एडमिन क्रेडेंशियल का इस्तेमाल करके, पोर्टल में लॉग इन करें.

6. खाते का एडमिन बनाएं (ज़रूरी नहीं)

Drush का इस्तेमाल करके, Developer Channel Services के इंस्टॉलेशन के लिए एडमिन यूज़र बनाएं. Drupal, डिफ़ॉल्ट रूप से 'admin' नाम से एक एडमिन उपयोगकर्ता अपने-आप बना देता है. इसलिए, उपयोगकर्ता नाम के तौर पर 'admin' का इस्तेमाल न करें.

1. drupal_root/sites/default डायरेक्ट्री पर जाएं. Drupal की रूट डायरेक्ट्री की स्टैंडर्ड जगह /var/www/html है:
   > cd <drupal_root>/sites/default
2. पक्का करें कि आपके पास निजी Drupal फ़ाइलों में बदलाव करने की अनुमतियां हों:
   > drush vget file_private_path
   
   यह निर्देश, निजी Drupal फ़ाइलों का पाथ दिखाता है. उदाहरण के लिए:
   file_private_path: 'sites/default/private'
   
   यह /var/www/html/sites/default/private/ से जुड़ा है. यह पक्का करने के लिए कि इस डायरेक्ट्री में मालिक और ग्रुप, दोनों बदलाव कर सकें, इस निर्देश का इस्तेमाल करें:
   chmod -R g+w dirPathAndName
   chmod -R o+r dirPathAndName
3. खाते का एडमिन उपयोगकर्ता बनाने के लिए, यहां दिए गए निर्देश डालें. “< >” में दिए गए निर्देशों को अपनी वैल्यू से बदलें:
   > drush user-create <username> --mail="<email-address>" --password="<password>"
   > drush user-add-role Administrator <username>
4. ऊपर दिए गए उपयोगकर्ता नाम और पासवर्ड का इस्तेमाल करके, एडमिन के तौर पर डेवलपर पोर्टल में लॉग इन करें.

5. MySQL रूट पासवर्ड सेट करें

अगर आपने पोर्टल इंस्टॉलेशन के हिस्से के तौर पर MySQL इंस्टॉल किया है, तो इंस्टॉलेशन स्क्रिप्ट, MySQL रूट पासवर्ड को उसकी डिफ़ॉल्ट वैल्यू पर सेट कर देती है. यह वैल्यू खाली होती है.

रूट पासवर्ड सेट करने के लिए, इस निर्देश का इस्तेमाल करें:

> mysqladmin -u root password NEWPASSWORD

अगर आपने पहले रूट पासवर्ड सेट किया था और अब आपको उसे बदलना है, तो इस निर्देश का इस्तेमाल करें:

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

आपको /var/www/html/sites/default/settings.php फ़ाइल में भी पासवर्ड अपडेट करना होगा.

6. पक्का करें कि अपडेट मैनेजर मॉड्यूल चालू हो

Drupal के अपडेट की सूचनाएं पाने के लिए, पक्का करें कि Drupal Update manager मॉड्यूल चालू हो. Drupal मेन्यू में जाकर, Modules चुनें और नीचे की ओर स्क्रोल करके, Update manager मॉड्यूल पर जाएं. अगर यह चालू नहीं है, तो इसे चालू करें.

इस सुविधा के चालू होने के बाद, उपलब्ध अपडेट देखे जा सकते हैं. इसके लिए, रिपोर्ट > उपलब्ध अपडेट मेन्यू आइटम का इस्तेमाल करें. इस Drush कमांड का भी इस्तेमाल किया जा सकता है:

> drush pm-info update

रिपोर्ट > उपलब्ध अपडेट > सेटिंग मेन्यू आइटम का इस्तेमाल करके, मॉड्यूल को कॉन्फ़िगर करें. इससे अपडेट उपलब्ध होने पर आपको ईमेल मिलेगा. साथ ही, अपडेट की जांच करने की फ़्रीक्वेंसी सेट की जा सकेगी.

7. प्रोडक्शन सर्वर पर डिप्लॉय करना (ज़रूरी नहीं)

अगर पोर्टल को प्रोडक्शन सर्वर पर डिप्लॉय किया जा रहा है, तो आपको सुरक्षा से जुड़े अतिरिक्त कदम उठाने चाहिए. जैसे:

1. अपने MySQL इंस्टॉलेशन को सुरक्षित करने के लिए, यह स्क्रिप्ट चलाएं:
   > /usr/bin/mysql_secure_installation
   
   यह स्क्रिप्ट, रूट पासवर्ड सेट करती है. साथ ही, आपको रूट ऐक्सेस को सिर्फ़ लोकल होस्ट तक सीमित करने का विकल्प देती है. इसके अलावा, यह डिफ़ॉल्ट रूप से बनाए गए टेस्ट डेटाबेस और बिना नाम वाले उपयोगकर्ता को हटाने का विकल्प भी देती है. हमारा सुझाव है कि प्रोडक्शन सर्वर के लिए, इस स्क्रिप्ट को ज़रूर चलाएं.
2. अगर आपकी कंपनी की नीतियों के मुताबिक ज़रूरी हो, तो SELinux को चालू और कॉन्फ़िगर करें.

8. Apache Solr सर्च इंजन को कॉन्फ़िगर करना (ज़रूरी नहीं)

पोर्टल इंस्टॉल करने पर, Apache Solr सर्च इंजन से कनेक्ट होने वाले Drupal मॉड्यूल डिफ़ॉल्ट रूप से बंद रहते हैं. ज़्यादातर पोर्टल, Drupal के इंटरनल सर्च इंजन का इस्तेमाल करते हैं. इसलिए, उन्हें Drupal Solr मॉड्यूल की ज़रूरत नहीं होती.

अगर आपको Solr को अपने सर्च इंजन के तौर पर इस्तेमाल करना है, तो आपको अपने सर्वर पर Solr को स्थानीय तौर पर इंस्टॉल करना होगा. इसके बाद, पोर्टल पर Drupal Solr मॉड्यूल को चालू और कॉन्फ़िगर करना होगा.

Drupal Solr मॉड्यूल चालू करने के लिए:

1. अपने पोर्टल में ऐसे उपयोगकर्ता के तौर पर लॉग इन करें जिसके पास एडमिन या कॉन्टेंट बनाने के अधिकार हों.
2. Drupal मेन्यू में जाकर, Modules को चुनें.
3. Apache Solr Framework मॉड्यूल और Apache Solr Search मॉड्यूल को चालू करें.
4. बदलावों को सेव करें.
5. https://drupal.org/node/1999280 पर बताए गए तरीके से Solr को कॉन्फ़िगर करें.

9. एचटीटीपीएस के साथ काम करने के लिए, mod_ssl इंस्टॉल करें (ज़रूरी नहीं)

Apache HTTP Server, mod_ssl मॉड्यूल का इस्तेमाल करके, एचटीटीपीएस पर वेब पेज दिखाता है. अगर आपको एचटीटीपीएस का इस्तेमाल करना है, तो mod_ssl इंस्टॉल करने के लिए इस निर्देश का इस्तेमाल करें:

> yum install mod_ssl

एसएसएल का इस्तेमाल करने के लिए पोर्टल को कॉन्फ़िगर करने के बारे में ज़्यादा जानकारी पाने के लिए, http://apigee.com/docs/developer-services/content/using-ssl-portal पर जाएं.

10. SmartDocs इंस्टॉल करना (ज़रूरी नहीं)

SmartDocs की मदद से, डेवलपर सेवाओं के पोर्टल पर अपने एपीआई को इस तरह से दस्तावेज़ में शामिल किया जा सकता है कि एपीआई का दस्तावेज़ पूरी तरह से इंटरैक्टिव हो. हालांकि, पोर्टल के साथ SmartDocs का इस्तेमाल करने के लिए, आपको पहले Edge पर SmartDocs इंस्टॉल करना होगा.

• अगर पोर्टल को Edge Cloud इंस्टॉलेशन से कनेक्ट किया जा रहा है, तो SmartDocs पहले से इंस्टॉल होता है. इसके लिए, किसी और कॉन्फ़िगरेशन की ज़रूरत नहीं होती.
• अगर पोर्टल को Edge for Private Cloud इंस्टॉलेशन से कनेक्ट किया जा रहा है, तो आपको यह पक्का करना होगा कि Edge पर SmartDocs इंस्टॉल हो. Edge और SmartDocs को इंस्टॉल करने के बारे में ज़्यादा जानने के लिए, SmartDocs इंस्टॉल करना लेख पढ़ें.

SmartDocs के बारे में ज़्यादा जानने के लिए, एपीआई का दस्तावेज़ बनाने के लिए SmartDocs का इस्तेमाल करना लेख पढ़ें.

11. आगे क्या करना है?

डेवलपर सेवाओं के पोर्टल को इंस्टॉल करने के बाद, आपको अपनी खास ज़रूरतों के हिसाब से इसे कॉन्फ़िगर और पसंद के मुताबिक बनाना होगा. Apigee की वेबसाइट पर मौजूद दस्तावेज़ में, पोर्टल को कॉन्फ़िगर करने, स्टाइल करने, और मैनेज करने के बारे में पूरी जानकारी दी गई है. http://apigee.com/docs/developer-services/content/what-developer-portal पर जाकर दस्तावेज़ ऐक्सेस करें.

नीचे दी गई टेबल में, इंस्टॉल करने के बाद किए जाने वाले कुछ सबसे सामान्य टास्क की सूची दी गई है. साथ ही, Apigee के दस्तावेज़ों के लिंक भी दिए गए हैं. इन लिंक पर जाकर, आपको ज़्यादा जानकारी मिल सकती है: