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

Developer Services Portal का 4.16.09 वर्शन

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

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

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

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

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

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

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

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

1. सिस्टम पर MySQL सर्वर इंस्टॉल करें.
2. रूट उपयोगकर्ता के तौर पर MySQL में लॉग इन करने के लिए, यह कमांड इस्तेमाल करें:
   > mysql -u root -p
3. जब आपसे कहा जाए, तब रूट पासवर्ड डालें.
4. devportal उपयोगकर्ता बनाने के लिए, mysql> प्रॉम्प्ट पर ये डालें:
   mysql>create user 'devportal'@'localhost' की पहचान 'devportal' से की जाती है;
   mysql> grant all privileges on *.* to 'devportal'@'localhost';
   mysql> flush privileges;
   mysql> quit
5. सिस्टम प्रॉम्प्ट पर, devportal डेटाबेस बनाएं:
   > mysqladmin -u devportal -p create devportal
   
   devportal का पासवर्ड डालें.
6. MySQL में लॉग इन करें और पोर्टल सर्वर के आईपी से devportal को ऐक्सेस दें:
   mysql> डेवलपर को सभी डेवलपर को अनुमति दें.* TO devportal@'portalIP' IDENTIFIED BY 'devportalPW';
   
   जहां portalIP, पोर्टल सर्वर का आईपी पता है और devportalPW, devportal उपयोगकर्ता का पासवर्ड है.
7. MySQL सर्वर के आईपी पते पर bind-address सेट करने के लिए, /etc/my.cnf में बदलाव करें.
8. MySQL को रीस्टार्ट करें:
   > /etc/init.d/mysqld restart
9. पक्का करें कि MySQL सर्वर पर पोर्ट 3306 खुला हो. यह तरीका आपके ऑपरेटिंग सिस्टम पर निर्भर करता है. उदाहरण के लिए, Linux के लिए, यह निर्देश इस्तेमाल करें:
   > /sbin/iptables -A इनपुट -i eth0 -p tcp --destination-port 3306 -j स्वीकार

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

Red Hat Enterprise Linux (RHEL) के लिए ज़रूरी शर्तें

Red Hat से सॉफ़्टवेयर डाउनलोड करने के लिए सदस्यता की ज़रूरत होती है. इसलिए, RHEL के लिए कुछ और ज़रूरी शर्तें होती हैं. yum की मदद से RPM डाउनलोड करने के लिए, सर्वर को इंटरनेट से कनेक्ट होना चाहिए. 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, SMTP सर्वर पर ज़रूरी पोर्ट को ऐक्सेस कर सकता हो. आम तौर पर, नॉन-टीएलएस एसएमटीपी के लिए पोर्ट नंबर 25 होता है. आम तौर पर, TLS की सुविधा वाले एसएमटीपी के लिए यह 465 होता है. हालांकि, एसएमटीपी की सेवा देने वाली कंपनी से इसकी पुष्टि करें.

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

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

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

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

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

इंस्टॉल करना शुरू करने से पहले, आपके पास नीचे दी गई जानकारी होनी चाहिए:

1. आपको किस प्लैटफ़ॉर्म को कॉन्फ़िगर करना है: Red Hat या CentOS? अगर Red Hat इंस्टॉल किया गया है, तो आरपीएम डाउनलोड करने के लिए, मशीन को Red Hat Network पर रजिस्टर करना होगा.
2. क्या आपको स्थानीय कंप्यूटर पर MySQL इंस्टॉल करना है? एचए के कुछ इंस्टॉलेशन के लिए, पोर्टल के वेब पेजों को दिखाने वाली मशीन से अलग मशीन पर MySQL होना ज़रूरी है. अगर ऐसा है, तो MySQL को लोकल तौर पर इंस्टॉल न करें. अगर आपको एक ही मशीन पर सभी चीज़ों को आसानी से इंस्टॉल करना है, तो MySQL को लोकल तौर पर इंस्टॉल करें.
3. अगर आपको रिमोट MySQL सर्वर को ऐक्सेस करना है, तो रिमोट MySQL सर्वर का होस्टनेम, पोर्ट, डेटाबेस का नाम, उपयोगकर्ता नाम, और पासवर्ड ऐक्सेस करें. इंस्टॉलेशन शुरू करने से पहले, रिमोट MySQL सर्वर को पहले से कॉन्फ़िगर किया जाना चाहिए.
4. वेब सर्वर का पूरी तरह क्वालिफ़ाइड डोमेन नेम क्या है? (यह जानकारी /etc/hosts में जोड़ दी जाएगी.) यह आईपी पता या होस्टनेम होना चाहिए, जैसे कि portalserver.example.com. डिफ़ॉल्ट वैल्यू localhost है.
5. क्या आपको Apache के वर्चुअल होस्ट के लिए, Apigee के डिफ़ॉल्ट कॉन्फ़िगरेशन का इस्तेमाल करना है? आपने सातवें चरण में जो होस्टनेम डाला था उससे एक वर्चुअल होस्ट बनाया जाता है.
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, Edge मैनेजमेंट सर्वर का आईपी पता है और SSLport, Edge मैनेजमेंट एपीआई का एसएसएल पोर्ट है. उदाहरण के लिए, 8443.
   2. Apigee संगठन का नाम: पोर्टल और Apigee Edge संगठनों के बीच एक संबंध होता है. Management API एंडपॉइंट सेट अप करते समय, आपको डिफ़ॉल्ट संगठन सेट अप करना होगा. डिफ़ॉल्ट वैल्यू my-org है.
   3. Management API एंडपॉइंट के लिए उपयोगकर्ता नाम और पासवर्ड: पोर्टल से Edge पर कॉल करने के लिए, आपके संगठन का एडमिन ज़रूरी है.
      
      यह उपयोगकर्ता नाम/पासवर्ड आपके संगठन के एडमिन के लिए है. इसका इस्तेमाल सिर्फ़ पोर्टल से Edge से कनेक्ट करने के लिए किया जाना चाहिए. उदाहरण के लिए, अगर किसी उपयोगकर्ता के क्रेडेंशियल दिए जाते हैं और उस उपयोगकर्ता को Edge पर मिटा दिया जाता है, तो पोर्टल अब Edge से कनेक्ट नहीं हो पाएगा. इसलिए, सिर्फ़ इस कनेक्शन के लिए अपने संगठन में एक एडमिन बनाएं.
      
      उदाहरण के लिए:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd