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

Edge for Private Cloud v4.18.05

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

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

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

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

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

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

SMTPSSL प्रॉपर्टी का बंद होना

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

अब आप SMTP_PROTOCOL प्रॉपर्टी का इस्तेमाल करते हैं, के बजाय SMTPSSL प्रॉपर्टी वह प्रोटोकॉल जिसका इस्तेमाल पोर्टल से कनेक्ट किए गए एसएमटीपी सर्वर करता है. मान्य वैल्यू ये हैं: "स्टैंडर्ड", "एसएसएल" या "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 से पुराने वर्शन मौजूद हैं, तो निम्न चेतावनी संदेश दिखाई देगा:

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

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

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

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

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

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

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 स्टैंडअलोन या Edge इंस्टॉल करने के हिस्से के तौर पर, Postgres इंस्टॉल करें

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

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

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

   कहां:

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

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

1. पोर्टल के होम पेज पर http://localhost:8079 पर जाएं या डीएनएस नेम पर जाएं का डेटा इकट्ठा किया है.
2. पोर्टल में सेट किए गए एडमिन क्रेडेंशियल का इस्तेमाल करके, पोर्टल में लॉग इन करें कॉन्फ़िगरेशन फ़ाइल है.
3. रिपोर्ट > को चुनें स्टेटस रिपोर्ट का इस्तेमाल करके, यह पक्का किया जा सकता है कि पोर्टल की मौजूदा स्थिति देखी जा सकती है.
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 वैल्यू इस्तेमाल की 1: Apigee Edge के साथ अपने कनेक्शन की जांच करें. उपयोगकर्ता नाम और पासवर्ड, USER_NAME की वैल्यू से भी मेल खाना चाहिए और USER_PWD प्रॉपर्टी शामिल होने वाली कॉन्फ़िगरेशन फ़ाइल या किसी भी ऐसे उपयोगकर्ता के क्रेडेंशियल जो संगठन के एडमिन की भूमिका में हैं.

   4. मैनेजमेंट सर्वर से कनेक्ट करने के बाद, सेव करें कॉन्फ़िगरेशन बटन पर क्लिक करें.

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 Sor मॉड्यूल की ज़रूरत है.

अगर आपको अपने सर्च इंजन के तौर पर 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 सीडीएन ड्रॉप-डाउन में, कोई नहीं चुनें.
5. कॉन्फ़िगरेशन सेव करें पर क्लिक करें.

9. अगले चरण

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