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

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. इंस्टॉल करने वाली फ़ाइलों के लिए डायरेक्ट्री बनाएं, जैसे कि पोर्टल.
3. सीडी (CD) को नई पोर्टल डायरेक्ट्री में सेव करें और डेवलपर चैनल सर्विस 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 डायरेक्ट्री से सीडी जोड़ें और डेवलपर चैनल सर्विस की 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. इंस्टॉल करने वाली फ़ाइलों के लिए डायरेक्ट्री बनाएं, जैसे कि पोर्टल.
3. पोर्टल डायरेक्ट्री की सीडी.
4. उस .tar.gz फ़ाइल को पोर्टल डायरेक्ट्री में कॉपी करें जिसे आपने नेटवर्क के बिना इंस्टॉल करने (ऊपर दी गई प्रक्रिया के मुताबिक) के लिए बनाया था.
5. निर्देश का इस्तेमाल करके, .tar.gz फ़ाइल का कॉन्टेंट निकालें:
   > tar -xvf <tar file>
6. टार कमांड से बनाई गई डायरेक्ट्री में सीडी.
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 एंडपॉइंट के कनेक्शन को कॉन्फ़िगर करें. इसके बाद, Save को चुनें.
   इन वैल्यू के बारे में ज़्यादा जानकारी के लिए, डेवलपर सर्विस पोर्टल की ज़रूरी शर्तों में, "इंस्टॉल करने से पहले ज़रूरी जानकारी" देखें.
   1. Management API संगठन
   2. Management API का एंडपॉइंट यूआरएल
   3. एंडपॉइंट की पुष्टि करने वाला उपयोगकर्ता
   4. पुष्टि किए गए उपयोगकर्ता का पासवर्ड
4. नीचे दी गई जानकारी डालकर, एडमिन उपयोगकर्ता को कॉन्फ़िगर करें. इसके बाद, सेव करें को चुनें. ध्यान दें कि Drupal, डिफ़ॉल्ट रूप से 'एडमिन' नाम से एडमिन के तौर पर एक उपयोगकर्ता बनाता है. इसलिए, उपयोगकर्ता नाम के तौर पर 'एडमिन' का इस्तेमाल न करें.
   अगर आप यह चरण छोड़ देते हैं, तो भी आप एडमिन बनाने के लिए Drush का इस्तेमाल कर सकते हैं, जैसा कि नीचे 4 में बताया गया है. खाते का एडमिन बनाएं.
   1. डेवलपर का नाम और सरनेम
   2. डेवलपर का पोर्टल उपयोगकर्ता नाम
   3. पासवर्ड
   4. ईमेल पता
5. इंस्टॉल पूरा होने के बाद, settings.php फ़ाइल पर अनुमतियां सेट करें:
   > chmod 640 /var/www/html/sites/default/settings.php
6. http://localhost/ पर जाकर या अपने पोर्टल के डीएनएस नाम पर पोर्टल के होम पेज पर जाएं.
7. एडमिन क्रेडेंशियल का इस्तेमाल करके, पोर्टल में लॉग इन करें.

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

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

1. CD को आपके dरुपal_root/sites/default डायरेक्ट्री में ट्रांसफ़र कर सकता है. Drupal रूट डायरेक्ट्री के लिए स्टैंडर्ड लोकेशन /var/www/html है:
   > cd <dripal_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 directPathAndName
   chmod -R o+r drPathAndName
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 अपडेट मैनेजर का मॉड्यूल चालू हो. Drupal मेन्यू में जाकर, मॉड्यूल चुनें. इसके बाद, नीचे की ओर स्क्रोल करके, Update Manager मॉड्यूल पर जाएं. अगर यह सुविधा चालू नहीं है, तो इसे चालू करें.

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

> drush pm-info update

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

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

अगर आपको किसी प्रोडक्शन सर्वर पर पोर्टल को डिप्लॉय करना है, तो आपको सुरक्षा के कुछ और चरण पूरे करने चाहिए. इनमें ये चरण शामिल हैं:

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

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

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

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

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

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

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

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

> yum install mod_ssl

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

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

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

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

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

11. अगला कदम क्या है?

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

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