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

Developer Services Portal v. 4.16.05

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

हार्डवेयर

ज़रूरी शर्त

ऑपरेटिंग सिस्टम

इंस्टॉल करने के इन निर्देशों और इंस्टॉल करने के लिए दी गई फ़ाइलों की जांच, यहां दिए गए ऑपरेटिंग सिस्टम पर की गई है: https://apigee.com/docs/api-services/reference/supported-software

RAM

1 GB

हार्ड डिस्क

10 जीबी

नेटवर्क इंटरफ़ेस

इंटरनेट कनेक्शन चालू होना चाहिए.

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

उदाहरण के लिए, https://drupal.org/ पर किया गया अनुरोध, एचटीटीपी 301 स्टेटस कोड दिखाता है और https://www.drupal.org/ पर रीडायरेक्ट करता है.

आपके प्रॉक्सी को इस तरह कॉन्फ़िगर किया जाना चाहिए कि वह रीडायरेक्ट से अनुरोध किए गए कॉन्टेंट के साथ एचटीटीपी 200 स्टेटस कोड दिखाए.

एसएपी इंस्टॉलेशन के लिए, अगर आपका एनवायरमेंट आउटगोइंग एचटीटीपीएस अनुरोधों को प्रॉक्सी करने के लिए सेट अप किया गया है, तो आपकी प्रॉक्सी को TLSv1.0 के साथ काम करना चाहिए. OpenSSL 0.9.8, TLSv1.1 या TLSv1.2 के साथ काम नहीं करता. यह सिर्फ़ TLSv1.0 के साथ काम करता है.

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

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

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

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

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

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

  1. सिस्टम पर MySQL Server इंस्टॉल करें.
  2. इस निर्देश का इस्तेमाल करके, रूट उपयोगकर्ता के तौर पर MySQL में लॉग इन करें:
    > mysql -u root -p
  3. जब कहा जाए, तब रूट पासवर्ड डालें.
  4. mysql> प्रॉम्प्ट पर, devportal उपयोगकर्ता बनाने के लिए यह जानकारी डालें:
    mysql>create user 'devportal'@'localhost' identified by '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> GRANT ALL ON devportal.* 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 INPUT -i eth0 -p tcp --destination-port 3306 -j ACCEPT

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

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

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

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

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

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

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

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

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

  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. मैनेजमेंट एपीआई एंडपॉइंट के लिए उपयोगकर्ता नाम और पासवर्ड: पोर्टल से Edge पर किए जाने वाले कॉल, आपके संगठन के एडमिन को करने चाहिए.

      यह उपयोगकर्ता नाम/पासवर्ड आपके संगठन के एडमिन के लिए है. इसका इस्तेमाल सिर्फ़ पोर्टल से Edge से कनेक्ट करने के लिए किया जाना चाहिए. उदाहरण के लिए, अगर आपने किसी उपयोगकर्ता के क्रेडेंशियल दिए हैं और उस उपयोगकर्ता को Edge से मिटा दिया जाता है, तो पोर्टल अब Edge से कनेक्ट नहीं हो पाएगा. इसलिए, अपने संगठन में सिर्फ़ इस कनेक्शन के लिए एक एडमिन बनाएं.

      उदाहरण के लिए:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd