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

Apigee Developer Services पोर्टल (या सिर्फ़ पोर्टल) को इंस्टॉल करने से पहले, पक्का करें कि:

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

इंस्टॉलर में सिर्फ़ Drupal के योगदान वाले मॉड्यूल शामिल होते हैं. इनकी ज़रूरत Apigee Developer Services पोर्टल (या सिर्फ़ पोर्टल) को होती है. योगदान देने वाले अन्य मॉड्यूल इंस्टॉल करने के बारे में जानकारी पाने के लिए, Extending Drupal 7 देखें.

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

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

1. अपने कनेक्शन की जांच करना
2. PHP के 7.0 से पहले के वर्शन हटाना
3. Postgres इंस्टॉल करना
4. पोर्टल इंस्टॉल करना
5. पक्का करें कि अपडेट मैनेजर चालू हो
6. (ज़रूरी नहीं) Apache Solr को कॉन्फ़िगर करना
7. (ज़रूरी नहीं) SmartDocs इंस्टॉल करना
8. (ज़रूरी नहीं) JQuery को कॉन्फ़िगर करना

SMTPSSL प्रॉपर्टी का इस्तेमाल बंद करना

पिछले वर्शन में, पोर्टल से कनेक्ट किए गए एसएमटीपी सर्वर के इस्तेमाल किए जाने वाले प्रोटोकॉल को सेट करने के लिए, SMTPSSL प्रॉपर्टी का इस्तेमाल किया जाता था. यह प्रॉपर्टी अब काम नहीं करती है.

पोर्टल से कनेक्ट किए गए एसएमटीपी सर्वर के लिए इस्तेमाल किए जाने वाले प्रोटोकॉल को सेट करने के लिए, अब SMTPSSL प्रॉपर्टी के बजाय SMTP_PROTOCOL प्रॉपर्टी का इस्तेमाल किया जाता है. मान्य वैल्यू ये हैं: "standard", "ssl" या "tls".

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

पोर्टल इंस्टॉल करने के लिए, साइलेंट कॉन्फ़िगरेशन फ़ाइल का एक उदाहरण यहां दिया गया है. अपने कॉन्फ़िगरेशन के हिसाब से, इस फ़ाइल में बदलाव करें. इस फ़ाइल को शामिल करने के लिए, 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=PORTAL_ADMIN_PASSWORD
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=ORG_ADMIN_PASSWORD

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

# Optionally configure the SMTP server used by the portal.
# If you do, 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

# Set the SMTP protocol as "standard", "ssl", or "tls",
# where "standard" corresponds to HTTP.
# Note that in previous releases, this setting was controlled by the
# SMTPSSL property. That property has been deprecated.
SMTP_PROTOCOL="standard"

# 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=YOUR_EMAIL_PASSWORD

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

जिस सर्वर पर पोर्टल इंस्टॉल करना है और Edge मैनेजमेंट सर्वर के बीच कनेक्शन की जांच करें. इसके लिए, पोर्टल सर्वर पर यह curl कमांड चलाएं:

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 और PASSWORD, ORGNAME के एडमिन का ईमेल पता और पासवर्ड है.

पक्का करें कि आपने Edge के अपने इंस्टॉलेशन के लिए, होस्टनेम और पोर्ट नंबर डाला हो. Edge, डिफ़ॉल्ट रूप से पोर्ट 8080 का इस्तेमाल करता है. अगर आपको क्लाउड में किसी संगठन से कनेक्ट करना है, तो अनुरोध का यूआरएल यह है: https://api.enterprise.apigee.com/v1/organizations/ORGNAME.

अनुरोध पूरा होने पर, curl से इस तरह का जवाब मिलता है:

{
  "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 से पहले के वर्शन की जांच करती है. इसके बाद, इंस्टॉल करने की प्रोसेस शुरू होती है. अगर 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

अगर आपको पक्के तौर पर नहीं पता है कि आपके सर्वर पर PHP इंस्टॉल है या नहीं, तो इस निर्देश का इस्तेमाल करें:

rpm -qa | grep -i php

ध्यान दें कि पोर्टल, PHP वर्शन 4.18.01-0.0.49 का इस्तेमाल करता है. इसका मकसद, Apigee Edge for Private Cloud के वर्शन नंबर से मैच करना नहीं है.

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

पोर्टल इंस्टॉल करने से पहले, Postgres इंस्टॉल करना ज़रूरी है. Edge इंस्टॉल करते समय Postgres को इंस्टॉल किया जा सकता है. इसके अलावा, पोर्टल के इस्तेमाल के लिए Postgres को अलग से इंस्टॉल किया जा सकता है.

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

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

Postgres standalone इंस्टॉल करने के लिए:

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

   # Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost
   HOSTIP=$(hostname -i)
   
   # The pod and region of Postgres. Use the default values shown below.
   MP_POD=gateway
   REGION=dc-1
   
   # Set the Postgres password. The default value is 'postgres'.
   PG_PWD=postgres

3. कमांड प्रॉम्प्ट पर, Postgres इंस्टॉल करने के लिए सेटअप स्क्रिप्ट चलाएं:

   /opt/apigee/apigee-setup/bin/setup.sh -p pdb -f postgres_config_file

   -p pdb विकल्प से, Postgre को इंस्टॉल करने के बारे में पता चलता है. कॉन्फ़िगरेशन फ़ाइल को "apigee" उपयोगकर्ता ऐक्सेस या पढ़ सकता हो.

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

पोर्टल इंस्टॉल करने से पहले, पक्का करें कि आपने 3 में बताए गए तरीके से ये काम किए हों. Postgres इंस्टॉल करें:

1. पोर्टल के नोड पर Edge apigee-setup यूटिलिटी इंस्टॉल करें
2. Postgres को इंस्टॉल करें. इसके लिए, Postgres को अलग से इंस्टॉल करें या Edge इंस्टॉल करने के दौरान इसे इंस्टॉल करें

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

1. कमांड प्रॉम्प्ट पर, setup स्क्रिप्ट चलाएं:

   /opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile

   कहां:

   • configFile, पोर्टल की कॉन्फ़िगरेशन फ़ाइल है. इसके बारे में पोर्टल की कॉन्फ़िगरेशन फ़ाइल बनाना में बताया गया है.
   • -p dp, setup स्क्रिप्ट को पोर्टल इंस्टॉल करने का निर्देश देता है.

यह पुष्टि करने के लिए कि पोर्टल इंस्टॉल हो गया है:

1. http://localhost:8079 पर मौजूद पोर्टल के होम पेज या अपने पोर्टल के डीएनएस नाम पर जाएं.
2. पोर्टल की कॉन्फ़िगरेशन फ़ाइल में सेट किए गए एडमिन क्रेडेंशियल का इस्तेमाल करके, पोर्टल में लॉग इन करें.
3. Drupal मेन्यू में Reports > Status Report को चुनें, ताकि आपको पोर्टल का मौजूदा स्टेटस दिख सके.
4. पक्का करें कि मैनेजमेंट सर्वर का कनेक्शन सही तरीके से काम कर रहा हो. अगर ऐसा नहीं था, तो:
   1. पोर्टल के कनेक्शन कॉन्फ़िगरेशन पेज पर जाएं. उदाहरण के लिए, http://portal_IP:8079/admin/config/devconnect.
   2. कनेक्शन की जांच करें बटन पर क्लिक करें. कनेक्ट हो जाने पर, आपका काम पूरा हो जाएगा. अगर कनेक्शन नहीं बनता है, तो जारी रखें.
   3. एंडपॉइंट और पुष्टि करने की सेटिंग देखें:
      • Management API एंडपॉइंट यूआरएल: जांच लें कि प्रोटोकॉल (एचटीटीपी या एचटीटीपीएस), आईपी या डीएनएस नाम, और पोर्ट नंबर सही हो. उदाहरण के लिए:

        http://10.10.10.10:8080/v1

      • एंडपॉइंट की पुष्टि करने वाला उपयोगकर्ता: संगठन के एडमिन का उपयोगकर्ता नाम.
      • पुष्टि किए गए उपयोगकर्ता का पासवर्ड: संगठन के एडमिन का पासवर्ड.

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

      ये वैल्यू, ms_IP_or_DNS, email, और password की उन वैल्यू से मैच होनी चाहिए जिनका इस्तेमाल आपने पहले चरण: Apigee Edge से अपने कनेक्शन की जांच करें में किया था. उपयोगकर्ता नाम और पासवर्ड, ऑनबोर्डिंग कॉन्फ़िगरेशन फ़ाइल में मौजूद USER_NAME और USER_PWD प्रॉपर्टी की वैल्यू से भी मैच होने चाहिए. इसके अलावा, ये क्रेडेंशियल संगठन के एडमिन की भूमिका वाले किसी भी उपयोगकर्ता के क्रेडेंशियल से मैच होने चाहिए.

   4. मैनेजमेंट सर्वर से कनेक्ट होने के बाद, पेज पर सबसे नीचे मौजूद कॉन्फ़िगरेशन सेव करें बटन पर क्लिक करें. इससे आपके बदलाव सेव हो जाएंगे.

5. पक्का करें कि अपडेट मैनेजर मॉड्यूल चालू हो

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

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

drush pm-info update

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

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

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

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

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

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

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

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

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

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

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

8. इंटरनेट के बिना इंस्टॉल करने के लिए, JQuery Update मॉड्यूल को कॉन्फ़िगर करना (ज़रूरी नहीं)

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

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

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

9. अगले चरण

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