डेवलपर सेवाओं के पोर्टल की ज़रूरी शर्तें

डेवलपर सर्विस पोर्टल v. 4.16.09

इंस्टॉल करने के लिए हार्डवेयर और सॉफ़्टवेयर की ज़रूरी शर्तें नीचे दी गई हैं.

हार्डवेयर	ज़रूरी शर्त
ऑपरेटिंग सिस्टम	इंस्टॉल करने के इन निर्देशों और इंस्टॉल करने के लिए उपलब्ध फ़ाइलों की जांच, यहां बताए गए ऑपरेटिंग सिस्टम पर की गई है: https://apigee.com/docs/api-services/reference/supported-software
RAM	एक जीबी
हार्ड डिस्क	10 जीबी
नेटवर्क इंटरफ़ेस	इसके लिए, इंटरनेट कनेक्शन चालू होना ज़रूरी है. इंस्टॉलेशन प्रक्रिया के हिस्से के तौर पर, इंस्टॉलर वेब से संसाधनों को डाउनलोड करता है. अगर आपका एनवायरमेंट, एचटीटीपी और एचटीटीपीएस अनुरोधों को प्रॉक्सी करने के लिए सेट अप किया गया है, तो आपकी प्रॉक्सी को इस तरह से कॉन्फ़िगर किया जाना चाहिए कि वह डाउनलोड करने के दौरान रीडायरेक्ट किए जाने वाले अनुरोधों को सही तरीके से हैंडल कर पाए. उदाहरण के लिए, https://drupal.org/ को भेजे गए अनुरोध पर एक एचटीटीपी 301 स्टेटस कोड दिखता है और वह https://drupal.org/ पर रीडायरेक्ट हो जाता है. आपकी प्रॉक्सी को इस तरह कॉन्फ़िगर किया जाना चाहिए कि वह रीडायरेक्ट से अनुरोध किए गए कॉन्टेंट के साथ, एचटीटीपी 200 स्टेटस कोड दिखाए. SAP इंस्टॉलेशन के लिए, अगर आपका एनवायरमेंट, एचटीटीपीएस अनुरोधों को प्रॉक्सी करने के लिए सेट अप किया गया है, तो आपकी प्रॉक्सी प्रॉपर्टी में TLSv1.0 के साथ काम करना चाहिए. OpenGL 0.9.8, TLSv1.1 या TLSv1.2 के साथ काम नहीं करता. यह सिर्फ़ TLSv1.0 के साथ काम करता है.

MySQL डेटाबेस की ज़रूरी शर्तें

अगर आपने MySQL सर्वर को उसी मशीन पर इंस्टॉल करने का विकल्प चुना है जिस पर डेवलपर चैनल सेवाएं, सिंगल-मशीन टोपोलॉजी है, तो डेवलपर चैनल सेवाओं का इंस्टॉलर आपको डेटाबेस का नाम और उपयोगकर्ता के डेटाबेस की जानकारी डालने के लिए कहेगा. इसके बाद, MySQL सर्वर इंस्टॉल करके आपके लिए डेटाबेस स्कीमा बनाता है. इंस्टॉल किया गया वर्शन, आपके ओएस के लिए उपलब्ध सबसे नया वर्शन है.

अगर आपको MySQL सर्वर को किसी अलग सिस्टम पर इंस्टॉल करना है, तो डेवलपर चैनल सर्विस इंस्टॉलर शुरू करने से पहले, आपको उस सिस्टम पर MySQL सर्वर इंस्टॉल करना होगा. आपके पास MySQL 5.0.15 या इसके बाद का वर्शन इंस्टॉल होना चाहिए.

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

डेवलपर चैनल सेवाएं, डेटाबेस उपयोगकर्ता का इस्तेमाल करके डेटाबेस से कनेक्ट करती हैं. इसके लिए उपयोगकर्ता के पास ये खास अधिकार होने चाहिए: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES, Lock TABLES.

उदाहरण के लिए, devपोर्टल नाम का डेटाबेस और devपोर्टल नाम वाला उपयोगकर्ता बनाने के लिए:

1. सिस्टम पर MySQL सर्वर इंस्टॉल करें.
2. निर्देश का इस्तेमाल करके, MySQL में रूट उपयोगकर्ता के तौर पर लॉग इन करें:
   > mysql -u root -p
3. जब कहा जाए, तब रूट पासवर्ड डालें.
4. mysql> प्रॉम्प्ट पर, डेवलपर पोर्टल उपयोगकर्ता बनाने के लिए यह डालें:
   mysql> 'devपोर्टल' से पहचाने गए उपयोगकर्ता 'devपोर्टल'@'लोकलहोस्ट' बनाएं;
   mysql> *.* पर 'devपोर्टल'@'localhost';
   mysql> फ़्लश के खास अधिकार दें;
   mysql> बंद करें
5. सिस्टम की सूचना मिलने पर, devपोर्टल डेटाबेस बनाएं:
   > mysqladmin -u devपोर्टल -p बनाएं devपोर्टल
   
   devपोर्टल पासवर्ड डालें.
6. MySQL में लॉग इन करें और पोर्टल के सर्वर के आईपी से devपोर्टल को ऐक्सेस दें:
   mysql> GRANT ALL ON devपोर्टल* .portalIP
   
   
7. MySQL सर्वर के आईपी पते पर बाइंड-पते को सेट करने के लिए, /etc/my.cnf में बदलाव करें.
8. MySQL को रीस्टार्ट करें:
   > /etc/init.d/mysqld रीस्टार्ट करें
9. पक्का करें कि पोर्ट 3306, MySQL सर्वर पर खुला है. यह प्रक्रिया आपके ऑपरेटिंग सिस्टम के हिसाब से तय होती है. उदाहरण के लिए, Linux के लिए, इस निर्देश का इस्तेमाल करें:
   > /sbin/iptables -A Input -i eth0 -p tcp --destination-port 3306 -j बटन

डेवलपर चैनल सेवाएं इंस्टॉल करते समय, यह तय करें कि स्थानीय तौर पर MySQL सर्वर को इंस्टॉल न करें. इसके बाद, आपको रिमोट डेटाबेस का आईपी पता, उपयोगकर्ता नाम, और डेटाबेस का नाम डालने के लिए कहा जाएगा.

Red Hat Enterprise Linux (RHEL) से जुड़ी ज़रूरी शर्तें

Red Hat से सॉफ़्टवेयर डाउनलोड करने के लिए, सदस्यता लेना ज़रूरी है. इसलिए, RHEL को कुछ अतिरिक्त शर्तों को पूरा करना होगा. yum के ज़रिए आरपीएम डाउनलोड करने के लिए, सर्वर को इंटरनेट से कनेक्ट होना चाहिए. अगर RHEL का इस्तेमाल किया जा रहा है, तो सर्वर को Red Hat Network (RHN) पर रजिस्टर होना चाहिए. साथ ही, उसे सर्वर के वैकल्पिक चैनल पर भी रजिस्टर किया जाना चाहिए.

इंस्टॉल करने के दौरान, Red Hat की ज़रूरी शर्तों की जांच की जाती है. अगर RHEL पहले से रजिस्टर नहीं है, तो पोर्टल इंस्टॉलर आपको यह सूचना देगा. अगर आपके पास Red Hat के लॉगिन क्रेडेंशियल पहले से हैं, तो इंस्टॉल करने की प्रोसेस शुरू करने से पहले, RHEL को रजिस्टर करने के लिए, नीचे दिए गए कमांड का इस्तेमाल किया जा सकता है:

> subscription-manager register --username=my_username --password=my_password --auto-attach 

my_username और my_password को अपने Red Hat क्रेडेंशियल से बदलें.

अगर आपके पास RHEL का ट्रायल वर्शन है, तो 30 दिनों का मुफ़्त में आज़माने का लाइसेंस लिया जा सकता है. ज़्यादा जानकारी के लिए, https://access.redhat.com/solutions/32790 पर जाएं.

एसएमटीपी के लिए ज़रूरी शर्तें

डिफ़ॉल्ट रूप से, पोर्टल PHP mail() फ़ंक्शन का इस्तेमाल करके मेल भेजता है. PHP स्थानीय सिस्टम पर sendmail का इस्तेमाल करके ईमेल भेजने की कोशिश करता है, जिसे PHP की php.ini फ़ाइल में कॉन्फ़िगर किया जा सकता है.

प्रोडक्शन एनवायरमेंट में, Apigee के लिए ज़रूरी है कि आप पोर्टल से ईमेल मैसेज भेजने के लिए, एक एसएमटीपी सर्वर कॉन्फ़िगर करें. इसलिए, आपको यह पक्का करना होगा कि Drupal, एसएमटीपी सर्वर पर ज़रूरी पोर्ट को ऐक्सेस कर सके. बिना TLS वाले एसएमटीपी के लिए, पोर्ट नंबर आम तौर पर 25 होता है. TLS की सुविधा वाले एसएमटीपी के लिए, यह अक्सर 465 कोड होती है. हालांकि, एसएमटीपी की सेवा देने वाली कंपनी से संपर्क करें.

अन्य ज़रूरी शर्तें

इंस्टॉल करने के लिए, सॉफ़्टवेयर इंस्टॉल करने वाले उपयोगकर्ता के पास रूट ऐक्सेस होना चाहिए.

डिप्लॉयमेंट आर्किटेक्चर की ज़रूरी शर्तें

डेवलपर चैनल सेवाओं में REST API की मदद से, Apigee Management Server के साथ एक ही इंटरफ़ेस होता है. इसकी मदद से, उपयोगकर्ता के ऐप्लिकेशन के बारे में जानकारी सेव और वापस पाई जा सकती है. डेवलपर Channel Services को एचटीटीपी या एचटीटीपीएस के ज़रिए, मैनेजमेंट सर्वर से कनेक्ट किया जा सकेगा. हालांकि, यह इस बात पर निर्भर करेगा कि आपके ऐप्लिकेशन को इंस्टॉल किया गया है या नहीं.

इंस्टॉल शुरू करने से पहले ज़रूरी जानकारी

इंस्टॉल करने से पहले, आपके पास यह जानकारी उपलब्ध होनी चाहिए:

1. आपको किस प्लैटफ़ॉर्म को कॉन्फ़िगर करना है: Red Hat या CentOS? अगर यह Red Hat इंस्टॉल है, तो आरपीएम डाउनलोड करने के लिए, मशीन का Red Hat नेटवर्क पर रजिस्टर होना ज़रूरी है.
2. क्या आपको लोकल मशीन पर MySQL इंस्टॉल करना है? कुछ एचए इंस्टॉलेशन के लिए ज़रूरी है कि MySQL पोर्टल वेब पेजों को दिखाने वाली मशीन के बजाय किसी दूसरी मशीन पर हो. अगर ऐसा है, तो MySQL को स्थानीय तौर पर इंस्टॉल न करें. अगर आपको एक ही मशीन पर सभी चीज़ों के साथ आसानी से इंस्टॉल करना है, तो स्थानीय तौर पर MySQL इंस्टॉल करें.
3. अगर आपको किसी रिमोट MySQL सर्वर को ऐक्सेस करना है, तो रिमोट MySQL सर्वर का होस्टनेम, पोर्ट, डेटाबेस का नाम, उपयोगकर्ता नाम, और पासवर्ड. रिमोट MySQL सर्वर को इंस्टॉल करने से पहले ही कॉन्फ़िगर किया जाना चाहिए.
4. वेब सर्वर का पूरी तरह क्वालिफ़ाइड डोमेन नेम क्या होता है? (यह जानकारी /etc/hosts में जोड़ दी जाएगी.) यह कोई आईपी पता या होस्टनेम होना चाहिए, जैसे कि portalserver.example.com. डिफ़ॉल्ट वैल्यू के तौर पर portalserver.example.com होता है.
5. क्या आपको Apache के वर्चुअल होस्ट के लिए, Apigee के डिफ़ॉल्ट कॉन्फ़िगरेशन का इस्तेमाल करना है? आपने जो होस्टनेम ऊपर चरण 7 में बताया है, उसके साथ एक वर्चुअल होस्ट बनाया जाता है.
6. ऐसी तीन जानकारी हैं जिनकी मदद से आपका पोर्टल Apigee Edge मैनेजमेंट सर्वर के साथ कम्यूनिकेट कर सकता है. यह जानकारी यहां दी गई है:
   1. Apigee Management API एंडपॉइंट का यूआरएल: यह एक होस्टनेम या आईपी पता होगा. यह REST एंडपॉइंट है, जिस पर ऐप्लिकेशन बनाने और डेवलपर को ऐप्लिकेशन कुंजियों के लिए रजिस्टर करने के लिए सभी कॉल किए जाते हैं. डिफ़ॉल्ट एंडपॉइंट https://api.enterprise.apigee.com/v1 है.
      
      Edge for Private Cloud इंस्टॉलेशन के लिए, यूआरएल इस फ़ॉर्मैट में होता है:
      http://EdgeIp:8080/v1
      
      या:
      https://EdgeIp:SSLport/v1
      
      जहां EdgeIp:SSLport, Edge मैनेजमेंट सर्वर के लिए एसएसएल पोर्ट और आईपी पता है. उदाहरण के लिए, 8443.
   2. Apigee संगठन का नाम: पोर्टल और Apigee Edge के संगठनों के बीच संबंध होता है. मैनेजमेंट एपीआई एंडपॉइंट सेट अप करते समय, डिफ़ॉल्ट संगठन सेट अप होगा. डिफ़ॉल्ट वैल्यू my-org है.
   3. मैनेजमेंट एपीआई एंडपॉइंट के लिए उपयोगकर्ता नाम और पासवर्ड: पोर्टल से Edge को किए जाने वाले कॉल, आपके संगठन का एडमिन ही कर सकता है.
      
      यह उपयोगकर्ता नाम/पासवर्ड आपके संगठन के एडमिन के लिए है. इसका इस्तेमाल सिर्फ़ पोर्टल से Edge से कनेक्ट करने के लिए किया जाना चाहिए. उदाहरण के लिए, अगर किसी उपयोगकर्ता के क्रेडेंशियल की जानकारी दी जाती है और उस उपयोगकर्ता को Edge से कभी भी मिटाया जाता है, तो यह पोर्टल Edge से कनेक्ट नहीं हो पाएगा. इसलिए, सिर्फ़ इस कनेक्शन के लिए, अपने संगठन के लिए एडमिन बनाएं.
      
      उदाहरण के लिए:
      dc_devपोर्टल+ORGNAME@apigee.com:MyP@ssw0rd