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

Developer Services Portal v. 4.16.05

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

इंस्टॉल करने से पहले, अपनी पूरी Drupal वेब रूट डायरेक्ट्री का बैकअप लें. इंस्टॉल करने की डिफ़ॉल्ट जगह /var/www/html है. हालांकि, हो सकता है कि आपने इंस्टॉल करते समय इसे बदल दिया हो. इंस्टॉल करने के लिए, यहां बताया गया तरीका अपनाएं. इसके बाद, बैकअप से अपनी पसंद के मुताबिक की गई सेटिंग को वापस लाया जा सकता है.

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

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

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

2. पक्का करें कि आपका सिस्टम, सिस्टम से जुड़ी ज़रूरी शर्तें पूरी करता हो

पोर्टल इंस्टॉल करने से पहले, आपके सर्वर को ये ज़रूरी शर्तें पूरी करनी होंगी:

1. पक्का करें कि Red Hat Enterprise Linux, CentOS या Oracle के 64-बिट वर्शन पर इंस्टॉल किया जा रहा हो. इस्तेमाल किए जा सकने वाले वर्शन की सूची यहां देखें.
2. पक्का करें कि Yum इंस्टॉल हो.
3. (इंटरनेट कनेक्शन के बिना किसी सर्वर पर इंस्टॉल करने के लिए) आपको सबसे पहले, इंटरनेट कनेक्शन वाले सर्वर पर सभी ज़रूरी फ़ाइलों को एक .tar.gz फ़ाइल के तौर पर डाउनलोड करना होगा. इसके बाद, इंस्टॉल करने के लिए, उस .tar.gz फ़ाइल को बिना इंटरनेट कनेक्शन के सर्वर पर कॉपी करें.
   1. इंटरनेट कनेक्शन वाले सर्वर में रूट या सुपरयूज़र के तौर पर लॉग इन करें.
   2. इंस्टॉल की जाने वाली फ़ाइलों के लिए कोई डायरेक्ट्री बनाएं, जैसे कि portal_tar.
   3. नई डायरेक्ट्री पर जाएं और 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 फ़ाइल में सेव करता है. इसके बाद, .tar.gz फ़ाइल को अपने उस सर्वर पर कॉपी करें जिसमें इंटरनेट कनेक्शन नहीं है. इससे इंस्टॉल करने की प्रोसेस पूरी हो जाएगी.
4. 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. अपने-आप इंस्टॉल होने वाली स्क्रिप्ट का इस्तेमाल करके, Developer Channel Services को इंस्टॉल करना

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

1. सर्वर में रूट या सुपर उपयोगकर्ता के तौर पर लॉग इन करें.
2. इंस्टॉल की जाने वाली फ़ाइलों के लिए कोई डायरेक्ट्री बनाएं, जैसे कि portal.
3. इंटरनेट कनेक्शन वाले सर्वर पर:
   1. नई पोर्टल डायरेक्ट्री में जाएं और डेवलपर चैनल की सेवाओं की DeveloperServices_x.y.z.tar फ़ाइल डाउनलोड करें. यहां x.y.z, पोर्टल के वर्शन नंबर को दिखाता है.
      
      Apigee से मिले लिंक से फ़ाइल डाउनलोड की जा सकती है. इसके लिए, लिंक को ब्राउज़र में खोलें या उसे कॉपी करके इस cURL कमांड में जोड़ें:
      > curl -kOL <paste link here>
   2. डेवलपर चैनल की सेवाओं की .tar फ़ाइल का कॉन्टेंट निकालने के लिए, इस कमांड का इस्तेमाल करें:
      > tar -xvf <tar file>
   3. DeveloperServices-4.x.y.z पर जाएं.
   4. इंस्टॉल करने की स्क्रिप्ट चलाने के लिए, इस कमांड का इस्तेमाल करें:
      > ./networked-install.sh
4. इंटरनेट कनेक्शन के बिना किसी सर्वर पर:
   1. सेक्शन 2 में बनाई गई .tar.gz फ़ाइल को कॉपी करें. पक्का करें कि आपका सिस्टम, सिस्टम की ज़रूरतें पूरी करता हो.
   2. इस निर्देश का इस्तेमाल करके, .tar.gz फ़ाइल का कॉन्टेंट निकालें:
      > tar -xvf <tar file>
   3. tar कमांड से बनाई गई डायरेक्टरी में जाएं.
   4. install-from-rpm-bundle.sh स्क्रिप्ट पर अनुमतियां सेट करें:
      > chmod 755 install-from-rpm-bundle.sh
   5. इस निर्देश का इस्तेमाल करके, install-from-rpm-bundle.sh स्क्रिप्ट चलाएं:
      > ./install-from-rpm-bundle.sh
5. सवालों के जवाब दें.
6. इंस्टॉल होने के बाद, किसी ब्राउज़र में सर्वर यूआरएल पर जाएं. जैसे:
   http://localhost. इसके अलावा, अगर आपने कोई आईपी या डीएनएस कॉन्फ़िगर किया है, तो http://IP_address या http://DNS_name पर जाएं.
   
   आपको Apigee प्रोफ़ाइल के डेटाबेस कॉन्फ़िगरेशन पेज पर रीडायरेक्ट किया जाएगा.
   
   ध्यान दें: आम तौर पर, आपने पहले से ही होस्टनेम कॉन्फ़िगर किया होगा और उसे अपने डीएनएस सर्वर के साथ रजिस्टर किया होगा, ताकि आपको http://localhost का इस्तेमाल न करना पड़े.
7. MySQL से कनेक्शन कॉन्फ़िगर करें. अगर MySQL किसी रिमोट मशीन पर है, तो बेहतर विकल्प सेक्शन को बड़ा करें और उस मशीन के कनेक्शन की जानकारी डालें. इसके बाद, सेव करें और जारी रखें को चुनें.
8. यहां दी गई जानकारी डालकर, Apigee एंडपॉइंट से कनेक्शन कॉन्फ़िगर करें. इसके बाद, सेव करें को चुनें:
   इन वैल्यू के बारे में ज़्यादा जानने के लिए, डेवलपर सेवाओं के पोर्टल की ज़रूरी शर्तें में "इंस्टॉल करने से पहले ज़रूरी जानकारी" देखें.
   1. Dev Portal Org
   2. Dev Portal एंडपॉइंट यूआरएल
   3. Endpoint Authenticated User
   4. पुष्टि किए गए उपयोगकर्ताओं का पासवर्ड
9. सैंपल SmartDocs WADL इंस्टॉल करने के लिए, जब कहा जाए, तब Install Sample SmartDocs WADL बटन को चुनें. अगर आपने यह चरण छोड़ दिया, तो SmartDocs API का उदाहरण आपके पोर्टल पर नहीं दिखेगा.
   ध्यान दें: अगर आपका पोर्टल, Apigee Edge for Private Cloud के किसी इंस्टॉलेशन से कनेक्ट होता है और Edge के उस इंस्टॉलेशन में कोई बाहरी इंटरनेट कनेक्शन नहीं है, तो SmartDocs का इस्तेमाल करने से पहले आपको SmartDocs मॉड्यूल का अतिरिक्त कॉन्फ़िगरेशन करना होगा. SmartDocs के बारे में ज़्यादा जानकारी के लिए, http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis पर जाएं.
10. एसएमटीपी सर्वर की सेटिंग कॉन्फ़िगर करें. Apigee के लिए, आपको एसएमटीपी सर्वर को कॉन्फ़िगर करना होगा, ताकि पोर्टल से ईमेल भेजे जा सकें.
    ज़्यादा जानकारी के लिए, http://apigee.com/docs/developer-services/content/configuring-email पर जाएं.
11. एडमिन उपयोगकर्ता को कॉन्फ़िगर करने के लिए, यह जानकारी डालें. इसके बाद, सेव करें को चुनें. ध्यान दें कि Drupal, डिफ़ॉल्ट रूप से 'admin' नाम से एक एडमिन उपयोगकर्ता बनाता है. इसलिए, उपयोगकर्ता नाम के तौर पर 'admin' का इस्तेमाल न करें.
    अगर यह चरण छोड़ दिया जाता है, तो भी Drush का इस्तेमाल करके एडमिन बनाया जा सकता है. इसके लिए, नीचे चौथे चरण में बताया गया तरीका अपनाएं. खाते का एडमिन बनाएं.
    1. डेवलपर का नाम और सरनेम
    2. डेवलपर पोर्टल का उपयोगकर्ता नाम
    3. पासवर्ड
    4. ईमेल पता
12. इंस्टॉलेशन पूरा होने के बाद, settings.php फ़ाइल पर अनुमतियां सेट करें:
    > chmod 640 /var/www/html/sites/default/settings.php
13. http://localhost/ पर मौजूद पोर्टल के होम पेज पर जाएं या अपने पोर्टल के डीएनएस नाम पर जाएं.
14. एडमिन क्रेडेंशियल का इस्तेमाल करके, पोर्टल में लॉग इन करें.

4. खाते का एडमिन बनाना

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 के दस्तावेज़ों के लिंक भी दिए गए हैं. इन लिंक पर जाकर, आपको ज़्यादा जानकारी मिल सकती है: