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

Edge for Private Cloud v. 4.17.05

इंस्टॉल करने से पहले, पक्का करें कि:

  • पोर्टल को इंस्टॉल करने से पहले आपको Postgres इंस्टॉल करना होता है. आपके पास या तो Postgres को किसी प्रॉडक्ट के हिस्से के तौर पर इंस्टॉल करने का विकल्प है या Postgres का स्टैंडअलोन वर्शन इंस्टॉल करना है, ताकि पोर्टल में इसका इस्तेमाल किया जा सके.
    • अगर आपको Postgres का स्टैंडअलोन वर्शन इंस्टॉल करना है, तो यह उसी नोड पर हो सकता है जिस पर पोर्टल की सुविधा है.
    • अगर Edge के हिस्से के तौर पर इंस्टॉल किए गए Postgres से कनेक्ट किया जा रहा है और Postgres को मास्ट/स्टैंडबाय मोड में कॉन्फ़िगर किया गया है, तो मास्ट Postgres सर्वर का आईपी पता डालें.
  • Red Hat Enterprise Linux, CentOS या Oracle के काम करने वाले वर्शन के 64-बिट वर्शन पर इंस्टॉल किया जा रहा हो. इस्तेमाल किए जा सकने वाले वर्शन की सूची देखने के लिए इस्तेमाल किए जा सकने वाले सॉफ़्टवेयर और वर्शन पर जाएं.
  • Yum इंस्टॉल हो गया है.

इंस्टॉल करने के बारे में खास जानकारी

किसी नोड पर Edge apigee-setup यूटिलिटी इंस्टॉल करने के बाद, उसका इस्तेमाल करें नोड पर पोर्टल इंस्टॉल करने की उपयोगिता. apigee-setup सुविधा का यह फ़ॉर्म उपलब्ध है:

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

apigee-setup यूटिलिटी पर एक कॉन्फ़िगरेशन फ़ाइल पास करें जिसमें इंस्टॉलेशन के बारे में जानकारी. अगर कॉन्फ़िगरेशन फ़ाइल में कोई ज़रूरी जानकारी मौजूद नहीं है जानकारी, apigee-setup उपयोगिता आपको इसे कमांड लाइन में डालने के लिए कहती है.

सिर्फ़ ज़रूरी शर्त यह है कि कॉन्फ़िगरेशन फ़ाइल "पिजी" उपयोगकर्ता.

उदाहरण के लिए, पोर्टल इंस्टॉल करने के लिए नीचे दिए गए कमांड का इस्तेमाल करें:

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p dp -f myConfig

Edge apigee-setup सुविधा को इंस्टॉल करना लेख पढ़ें देखें.

कॉन्फ़िगरेशन फ़ाइल बनाना

पोर्टल इंस्टॉलेशन के लिए साइलेंट कॉन्फ़िगरेशन फ़ाइल का उदाहरण नीचे दिया गया है. इस फ़ाइल में बदलाव करें ज़रूरत के हिसाब से ऐक्सेस करें. इस फ़ाइल को शामिल करने के लिए, setup.sh में -f विकल्प इस्तेमाल करें.

IP1=IPorDNSnameOfNode

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Specify the name of the portal database in Postgres. 
PG_NAME=devportal 

# Specify the Postgres admin credentials. 
# The portal connects to Postgres by using the 'apigee' user. 
# If you changed the Postgres password from the default of 'postgres' 
# then set PG_PWD accordingly. 
# If connecting to a Postgres node installed with Edge, 
# contact the Edge sys admin to get these credentials. 
PG_USER=apigee 
PG_PWD=postgres 

# The IP address of the Postgres server. 
# If it is installed on the same node as the portal, specify that IP. 
# If connecting to a remote Postgres server,specify its IP address. 
PG_HOST=$IP1 

# The Postgres user credentials used by the portal 
# to access the Postgres database, 
# This account is created if it does not already exist. 
DRUPAL_PG_USER=drupaladmin 
DRUPAL_PG_PASS=portalSecret 

# Specify 'postgres' as the database. 
DEFAULT_DB=postgres 

# Specify the Drupal admin account details. 
# DO NOT set DEVPORTAL_ADMIN_USERNAME=admin. 
# The installer creates this user on the portal. 
DEVPORTAL_ADMIN_FIRSTNAME=firstName 
DEVPORTAL_ADMIN_LASTNAME=lastName 
DEVPORTAL_ADMIN_USERNAME=userName 
DEVPORTAL_ADMIN_PWD=pWord 
DEVPORTAL_ADMIN_EMAIL=foo@bar.com 

# Edge connection details. 
# If omitted, you can set them in the portal UI. 
# Specify the Edge organization associated with the portal. 
EDGE_ORG=edgeOrgName 

# Specify the URL of the Edge management API. 
# For a Cloud based installation of Edge, the URL is: 
# https://api.enterprise.apigee.com/v1 
# For a Private Cloud installation, it is in the form: 
# http://<ms_ip_or_DNS>:8080/v1 or 
# https://<ms_ip_or_DNS>:TLSport/v1 
MGMT_URL=https://api.enterprise.apigee.com/v1 

# The org admin credentials for the Edge organization in the form
# of Edge emailAddress:pword. 
# The portal uses this information to connect to Edge. 
DEVADMIN_USER=orgAdmin@myCorp.com 
DEVADMIN_PWD=pWord 

# The PHP port. 
# If omitted, it defaults to 8888. 
PHP_FPM_PORT=8888 

# You must configure the SMTP server used by the portal. 
# The properties SMTPHOST and SMTPPORT are required. 
# The others are optional with a default value as notated below. 
# SMTP hostname. For example, for the Gmail server, use smtp.gmail.com. 
SMTPHOST=smtp.gmail.com 

# Use SSL for SMTP: 'y' or 'n' (default). 
SMTPSSL="n" 

# SMTP port (usually 25). 
# The value can be different based on the selected encryption protocol. 
# For example, for Gmail, the port is 465 when using SSL and 587 for TLS. 
SMTPPORT=25 

# Username used for SMTP authentication, defaults is blank. 
SMTPUSER=your@email.com 

# Password used for SMTP authentication, default is blank. 
SMTPPASSWORD=yourEmailPassword

1. Apigee Edge से अपने कनेक्शन की जांच करना

नीचे दिए गए cURL निर्देश का इस्तेमाल करके, Edge मैनेजमेंट सर्वर से अपने कनेक्शन की जांच करें पोर्टल सर्वर पर एक कमांड प्रॉम्प्ट से:

> curl -u {EMAIL}:{PASSWORD} http://<ms_ip_or_DNS>:8080/v1/organizations/{ORGNAME}

या:

> curl -u {EMAIL}:{PASSWORD} https://<ms_ip_or_DNS>:TLSPort/v1/organizations/{ORGNAME}

जहां EMAIL और पासवर्ड ईमेल हैं 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"
}

2. 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

नीचे दिए गए निर्देश का इस्तेमाल करके, PHP पैकेज हटाएं:

yum remove <package-name>

3. Postgres इंस्टॉल करें

पोर्टल को इंस्टॉल करने से पहले, आपको Postgres को इंस्टॉल करना होगा. इनमें से कोई एक विकल्प चुनें Edge इंस्टॉल करने के हिस्से के तौर पर Postgres इंस्टॉल करें या पोर्टल पर जाएं.

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

Edge इंस्टॉल करने के दौरान, Postgres को इंस्टॉल करने के बारे में जानकारी पाने के लिए, किसी नोड पर Edge के कॉम्पोनेंट इंस्टॉल करना लेख पढ़ें.

Postgres स्टैंडअलोन को इंस्टॉल करने के लिए:

  1. नोड apigee-setup यूटिलिटी को नोड पर इंस्टॉल करने के लिए इसका इस्तेमाल करें: करने के लिए कहा जा सकता है. Edge apigee-setup उपयोगिता को इंस्टॉल करना देखें वगैरह को कॉपी करने का विकल्प है.
  2. Postgres के लिए कॉन्फ़िगरेशन फ़ाइल बनाएं, जैसा कि नीचे दिखाया गया है:

    # का आईपी पता या डीएनएस इस्तेमाल करना ज़रूरी है होस्ट का नाम - 127.0.0.1 या localhost को नहीं.
    HostIP=$(होस्टनेम -i)

    # पोस्टग्रेज़ का पॉड और क्षेत्र. यहां दी गई डिफ़ॉल्ट वैल्यू का इस्तेमाल करें.
    MP_POD=gateway
    क्षेत्र=dc-1

    # Postgres का पासवर्ड सेट करें. डिफ़ॉल्ट वैल्यू 'postgres' है.
    PG_PWD=postgres
  3. कमांड प्रॉम्प्ट पर, Postgres इंस्टॉल करने के लिए सेटअप स्क्रिप्ट चलाएं:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p pdb -f configFile

    “-p pdb” विकल्प Postgre को इंस्टॉल करता है.

    कॉन्फ़िगरेशन फ़ाइल ऐसी होनी चाहिए जिसे "apigee" ऐक्सेस कर सके या पढ़ सके उपयोगकर्ता.

4. पोर्टल इंस्टॉल करें

पोर्टल इंस्टॉल करने के लिए:

  1. Edge apigee-setup सुविधा को इस डिवाइस पर इंस्टॉल करें इंटरनेट या इंटरनेट के अलावा किसी और तरीके का इस्तेमाल करने वाला नोड. Edge apigee-setup उपयोगिता को इंस्टॉल करना देखें वगैरह को कॉपी करने का विकल्प है.
  2. पक्का करें कि आपने Postgres स्टैंडअलोन या इसके हिस्से के तौर पर, Postgres इंस्टॉल किए हैं Edge इंस्टॉल हो रहा है.
  3. कमांड प्रॉम्प्ट पर, सेटअप स्क्रिप्ट चलाएं:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile

    “-p dp” विकल्प से पोर्टल को इंस्टॉल किया जाता है.

    कॉन्फ़िगरेशन फ़ाइल ऐसी होनी चाहिए जिसे "apigee" ऐक्सेस कर सके या पढ़ सके उपयोगकर्ता.
  4. http://localhost:8079 पर पोर्टल के होम पेज पर जाएं या इसके डीएनएस नाम पर जाएं आपका पोर्टल.
  5. कॉन्फ़िगरेशन में सेट किए गए एडमिन क्रेडेंशियल का इस्तेमाल करके, पोर्टल में लॉग इन करें फ़ाइल से लिए जाते हैं.

5. पक्का करें कि अपडेट मैनेजर मॉड्यूल सक्षम किया गया

Drupal के अपडेट की सूचनाएं पाने के लिए, पक्का करें कि Drupal के अपडेट मैनेजर मॉड्यूल चालू किया गया. Drupal मेन्यू में जाकर, मॉड्यूल चुनें और नीचे की ओर स्क्रोल करके मैनेजर को अपडेट करें मॉड्यूल. अगर यह चालू नहीं है, तो इसे चालू करें.

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

> drush pm-info update

आपको यह निर्देश, साइट की रूट डायरेक्ट्री से चलाना होगा. डिफ़ॉल्ट रूप से, डेवलपर पोर्टल /opt/apigee/apigee-drupal/wwwroot पर इंस्टॉल होता है. इसलिए, तो आपको पहले डायरेक्ट्री को /opt/apigee/apigee-drupal/wwwroot में बदलना होगा निर्देश चला रहा है. अगर आपने पोर्टल को डिफ़ॉल्ट डायरेक्ट्री में इंस्टॉल नहीं किया है, तो अपने इंस्टॉलेशन डायरेक्ट्री.

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

6. Apache सोल सर्च इंजन को कॉन्फ़िगर करें (ज़रूरी नहीं)

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

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

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

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

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

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

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

आपको पोर्टल पर SmartDocs को भी चालू करना होगा. SmartDocs के बारे में ज़्यादा जानकारी के लिए, दस्तावेज़ बनाने के लिए SmartDocs का इस्तेमाल करना देखें APIs.

8. कॉन्फ़िगर करें गैर-इंटरनेट इंस्टॉलेशन के लिए JQuery अपडेट मॉड्यूल (वैकल्पिक)

अगर इंटरनेट इंस्टॉलेशन के बिना, JQuery अपडेट मॉड्यूल को इंस्टॉल और इस्तेमाल किया जाता है, तो आपको JQuery के लोकल वर्शन का इस्तेमाल करने के लिए मॉड्यूल कॉन्फ़िगर करें. अगर मॉड्यूल को सीडीएन का इस्तेमाल करने के लिए कॉन्फ़िगर किया जाता है बिना इंटरनेट के इंस्टॉल करते समय, यह सीडीएन को ऐक्सेस करने की कोशिश करेगा. इस वजह से, पेज लोड होने में देरी होगी लोड हो रहा है. JQuery अपडेट के मॉड्यूल के बारे में ज़्यादा जानकारी पाने के लिए, https://www.drupal.org/project/jquery_update पर जाएं.

JQuery के लोकल वर्शन का इस्तेमाल करने के लिए, JQuery अपडेट करें मॉड्यूल को कॉन्फ़िगर करें:

  1. अपने पोर्टल में ऐसे उपयोगकर्ता के तौर पर लॉग इन करें जिसके पास एडमिन या कॉन्टेंट बनाने के अधिकार हों.
  2. कॉन्फ़िगरेशन > चुनें डेवलपमेंट > JQuery अपडेट को Drupal मेन्यू में देखा जा सकता है.
  3. बाईं ओर मौजूद नेविगेशन में, परफ़ॉर्मेंस पर क्लिक करें.
  4. JQuery और JQuery UI CDN ड्रॉप-डाउन में, कोई नहीं चुनें.
  5. कॉन्फ़िगरेशन सेव करें पर क्लिक करें.

9. आगे क्या?

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

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

टास्क

जानकारी

थीम को पसंद के मुताबिक बनाना

थीम से यह पता चलता है कि पोर्टल कैसा दिखेगा. इसमें रंग, स्टाइल वगैरह शामिल हैं विज़ुअल एलिमेंट.

चेहरा

होम पेज पर मुख्य मेन्यू, वेलकम मैसेज, हेडर, फ़ुटर, और टाइटल शामिल होते हैं.

जोड़ें और उपयोगकर्ता खातों को मैनेज करते/करती हैं

रजिस्ट्रेशन की प्रोसेस से यह कंट्रोल होता है कि नए डेवलपर पोर्टल पर जाएं. उदाहरण के लिए, क्या नए डेवलपर को तुरंत पोर्टल का ऐक्सेस मिलता है या किसी एडमिन से पुष्टि करानी होगी. इस प्रोसेस से यह भी कंट्रोल होता है कि नया खाता बनाने पर, पोर्टल के एडमिन को सूचना कैसे दी जाए.

कॉन्फ़िगर करना ईमेल

पोर्टल कुछ इवेंट के जवाब में ईमेल भेजता है. उदाहरण के लिए, जब एक नई डेवलपर, पोर्टल पर रजिस्टर करता है. हालांकि, अगर डेवलपर अपना पासवर्ड खो देता है, तो वह रजिस्ट्रेशन करता है.

जोड़ें और उपयोगकर्ता खातों को मैनेज करते/करती हैं

शर्तें जोड़ें और शर्तें पेज, जिसे डेवलपर को अनुमति देने से पहले स्वीकार करना होगा पोर्टल ऐक्सेस करें.

जोड़ें और उपयोगकर्ता खातों को मैनेज करते/करती हैं

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

ब्लॉग जोड़ें और फ़ोरम पोस्ट

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

पक्का करें कि डेटाबेस का बैकअप लिया जा रहा हो

पक्का करें कि Drupal के डेटाबेस का बैक अप लिया जा रहा हो. ध्यान दें कि क्योंकि अलग है, तो यह आप तय करते हैं कि उसका सबसे अच्छा बैक अप कैसे लिया जाए डेटाबेस.

ध्यान दें: बैकअप और माइग्रेट मॉड्यूल, Postgres डाटाबेस के साथ काम नहीं करता.

बैकअप लेने का तरीका भी देखें.

होस्टनेम सेट अप करें

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

अगर आपने लोड बैलेंसर सेट अप किया है या आपको अपनी साइट पर दूसरी वजह है, तो आप डेवलपर पोर्टल settings.php फ़ाइल में $base_url को सेट कर सकते हैं, जो डिफ़ॉल्ट रूप से /opt/apigee/apigee-drupal/wwwroot/sites/default डायरेक्ट्री.

कस्टम डेवलपमेंट अपनी थीम के अलावा, कस्टम कोड का इस्तेमाल करके भी पोर्टल की सुविधाओं को बेहतर बनाया जा सकता है. इसके लिए, Drupal के मॉड्यूल में बताए गए तरीके से अपना Drupal मॉड्यूल बनाएं डेवलपमेंट विषय चुनें, और मॉड्यूल को /sites/all/modules में रखें डायरेक्ट्री.