পোর্টাল ইনস্টল করুন

প্রাইভেট ক্লাউড v4.18.05 এর জন্য এজ

আপনি Apigee ডেভেলপার সার্ভিসেস পোর্টাল (বা সহজভাবে, পোর্টাল ) ইনস্টল করার আগে নিশ্চিত করুন যে:

1. আপনি পোর্টাল ইনস্টল করার আগে Postgres ইনস্টল করুন. আপনি এজ ইনস্টল করার অংশ হিসাবে পোস্টগ্রেস ইনস্টল করতে পারেন, বা পোর্টাল দ্বারা ব্যবহারের জন্য পোস্টগ্রেস স্বতন্ত্র ইনস্টল করতে পারেন।
   • আপনি যদি পোস্টগ্রেস স্বতন্ত্র ইনস্টল করেন তবে এটি পোর্টালের মতো একই নোডে থাকতে পারে।
   • আপনি যদি এজ-এর অংশ হিসেবে ইনস্টল করা Postgres-এর সাথে সংযোগ স্থাপন করেন এবং Postgres-কে মাস্টার/স্ট্যান্ডবাই মোডে কনফিগার করা হয়, তাহলে মাস্টার পোস্টগ্রেস সার্ভারের IP ঠিকানা উল্লেখ করুন।
2. আপনি Red Hat Enterprise Linux, CentOS, বা Oracle-এর সমর্থিত সংস্করণের 64-বিট সংস্করণে ইনস্টলেশন সম্পাদন করছেন। সমর্থিত সফ্টওয়্যার এবং সমর্থিত সংস্করণগুলিতে সমর্থিত সংস্করণগুলির তালিকা দেখুন৷
3. ইয়াম ইনস্টল করা হয়েছে।

ইনস্টলারটিতে শুধুমাত্র ড্রুপাল-কন্ট্রিবিউটেড মডিউলগুলি অন্তর্ভুক্ত থাকে যা Apigee ডেভেলপার সার্ভিসেস পোর্টাল (বা সহজভাবে, পোর্টাল ) দ্বারা প্রয়োজনীয়। অন্যান্য অবদানকৃত মডিউলগুলি ইনস্টল করার বিষয়ে তথ্যের জন্য, এক্সটেনিং ড্রুপাল 7 দেখুন।

ইনস্টলেশন ওভারভিউ

পোর্টালটি ইনস্টল করতে, আপনি নিম্নলিখিত পদক্ষেপগুলি সম্পাদন করবেন। এই ধাপগুলির প্রত্যেকটি পরবর্তী বিভাগগুলিতে আরও বিশদে বর্ণনা করা হয়েছে৷

1. আপনার সংযোগ পরীক্ষা করুন
2. PHP এর প্রাক-7.0 সংস্করণগুলি সরান
3. Postgres ইনস্টল করুন
4. পোর্টাল ইনস্টল করুন
5. আপডেট ম্যানেজার সক্রিয় আছে তা নিশ্চিত করুন
6. (ঐচ্ছিক) Apache Solr কনফিগার করুন
7. (ঐচ্ছিক) SmartDocs ইনস্টল করুন
8. (ঐচ্ছিক) JQuery কনফিগার করুন

SMTPSSL সম্পত্তির অবচয়

পূর্ববর্তী প্রকাশগুলিতে, আপনি পোর্টালের সাথে সংযুক্ত SMTP সার্ভার দ্বারা ব্যবহৃত প্রোটোকল সেট করতে SMTPSSL বৈশিষ্ট্য ব্যবহার করেছেন৷ সেই সম্পত্তি অবমূল্যায়ন করা হয়েছে।

পোর্টালের সাথে সংযুক্ত SMTP সার্ভার দ্বারা ব্যবহৃত প্রোটোকল সেট করতে আপনি এখন SMTPSSL প্রপার্টির পরিবর্তে SMTP_PROTOCOL প্রপার্টি ব্যবহার করুন। বৈধ মানগুলি হল: "মানক", "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-এ আপনার সংযোগ পরীক্ষা করুন

আপনি যে সার্ভারে পোর্টালটি ইনস্টল করতে যাচ্ছেন এবং এজ ম্যানেজমেন্ট সার্ভারের মধ্যে আপনার সংযোগ পরীক্ষা করুন পোর্টাল সার্ভারে নিম্নলিখিত 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 এর প্রশাসকের ইমেল ঠিকানা এবং পাসওয়ার্ড৷

আপনার এজ ইনস্টলেশনের জন্য নির্দিষ্ট হোস্টনাম এবং পোর্ট নম্বর উল্লেখ করতে ভুলবেন না। পোর্ট 8080 হল এজ দ্বারা ব্যবহৃত ডিফল্ট পোর্ট। আপনি যদি ক্লাউডে কোনো সংস্থার সাথে সংযোগ করেন, তাহলে অনুরোধের URL হল: 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

নিম্নলিখিত কমান্ড ব্যবহার করে পিএইচপি প্যাকেজগুলি সরান:

yum remove package_name

যদি আপনি নিশ্চিত না হন যে আপনার সার্ভারে PHP ইনস্টল করা আছে, তাহলে নিম্নলিখিত কমান্ডটি ব্যবহার করুন:

rpm -qa | grep -i php

3. Postgres ইনস্টল করুন

আপনি পোর্টালটি ইনস্টল করার আগে পোর্টালটির জন্য Postgres ইনস্টল করতে হবে। আপনি এজ ইনস্টল করার অংশ হিসাবে পোস্টগ্রেস ইনস্টল করতে পারেন, বা পোর্টাল দ্বারা ব্যবহারের জন্য পোস্টগ্রেস স্বতন্ত্র ইনস্টল করতে পারেন।

• আপনি যদি এজ-এর অংশ হিসেবে ইনস্টল করা Postgres-এর সাথে সংযোগ স্থাপন করেন এবং Postgres-কে মাস্টার/স্ট্যান্ডবাই মোডে কনফিগার করা হয়, তাহলে মাস্টার পোস্টগ্রেস সার্ভারের IP ঠিকানা উল্লেখ করুন।
• আপনি যদি পোস্টগ্রেস স্বতন্ত্র ইনস্টল করেন তবে এটি পোর্টালের মতো একই নোডে থাকতে পারে।

এজ ইনস্টল করার অংশ হিসাবে পোস্টগ্রেস ইনস্টল করার তথ্যের জন্য, একটি নোডে এজ উপাদান ইনস্টল করুন দেখুন।

Postgres স্বতন্ত্র ইনস্টল করতে:

1. ইন্টারনেট বা নন-ইন্টারনেট পদ্ধতি ব্যবহার করে নোডে এজ 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 বিকল্পটি পোস্টগ্রে ইনস্টল করার জন্য নির্দিষ্ট করে। কনফিগারেশন ফাইলটি "এপিজি" ব্যবহারকারীর দ্বারা অ্যাক্সেসযোগ্য বা পাঠযোগ্য হতে হবে।

4. পোর্টাল ইনস্টল করুন

আপনি পোর্টালটি ইনস্টল করার আগে, নিশ্চিত হন যে আপনি 3 এ বর্ণিত নিম্নলিখিতগুলি করেছেন। Postgres ইনস্টল করুন :

1. পোর্টালের নোডে এজ apigee-setup ইউটিলিটি ইনস্টল করুন
2. পোস্টগ্রেস ইনস্টল করুন, হয় পোস্টগ্রেস স্বতন্ত্রভাবে বা এজ ইনস্টল করার অংশ হিসাবে

পোর্টাল ইনস্টল করতে:

1. কমান্ড প্রম্পটে, setup স্ক্রিপ্টটি চালান:

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

   কোথায়:

   • configFile হল একটি পোর্টাল কনফিগারেশন ফাইল যা বর্ণনা করা হয়েছে একটি পোর্টাল কনফিগারেশন ফাইল তৈরি করুন ।
   • -p dp পোর্টালটি ইনস্টল করার জন্য setup স্ক্রিপ্টকে নির্দেশ দেয়।

পোর্টাল ইনস্টলেশন সফল হয়েছে তা যাচাই করতে:

1. http://localhost:8079 এ পোর্টাল হোম পেজে নেভিগেট করুন বা আপনার পোর্টালের DNS নামের দিকে যান।
2. আপনি পোর্টাল কনফিগারেশন ফাইলে যে প্রশাসক শংসাপত্রগুলি সেট করেছেন তা ব্যবহার করে পোর্টালে লগ ইন করুন৷
3. আপনি পোর্টালের বর্তমান অবস্থা দেখতে পাচ্ছেন তা নিশ্চিত করতে Drupal মেনুতে Reports > Status Report নির্বাচন করুন।
4. ম্যানেজমেন্ট সার্ভার সংযোগ সফল হয়েছে তা নিশ্চিত করুন। যদি এটি না হয়:
   1. পোর্টাল সংযোগ কনফিগারেশন পৃষ্ঠায় নেভিগেট করুন (উদাহরণস্বরূপ, http:// portal_IP :8079/admin/config/devconnect )।
   2. টেস্ট কানেকশন বোতামে ক্লিক করুন। সংযোগ সফল হলে, আপনি সম্পন্ন. সংযোগ ব্যর্থ হলে, চালিয়ে যান।
   3. শেষ পয়েন্ট এবং প্রমাণীকরণ সেটিংস পরীক্ষা করুন:
      • ম্যানেজমেন্ট API এন্ডপয়েন্ট URL: প্রোটোকল (HTTP বা HTTPS), IP বা DNS নাম এবং পোর্ট নম্বর সঠিক কিনা তা পরীক্ষা করুন; উদাহরণস্বরূপ:

        http://10.10.10.10:8080/v1

      • এন্ডপয়েন্ট প্রমাণীকৃত ব্যবহারকারী: প্রতিষ্ঠানের প্রশাসকের ব্যবহারকারীর নাম।
      • প্রমাণীকৃত ব্যবহারকারীর পাসওয়ার্ড : প্রতিষ্ঠানের প্রশাসকের পাসওয়ার্ড।

      ডিফল্ট মানগুলি আপনার পোর্টাল কনফিগারেশন ফাইলের সেটিংস প্রতিফলিত করে যা আপনি ইনস্টলেশন প্রক্রিয়া চলাকালীন তৈরি করেছিলেন।

      এই মানগুলি ms_IP_or_DNS , email এবং password মানগুলির সাথে মেলে যা আপনি ধাপ 1 এ ব্যবহার করেছেন: Apigee Edge-এর সাথে আপনার সংযোগ পরীক্ষা করুন । ব্যবহারকারীর নাম এবং পাসওয়ার্ডটি অনবোর্ডিং কনফিগারেশন ফাইলের USER_NAME এবং USER_PWD বৈশিষ্ট্যের মানগুলির সাথে বা যেকোন ব্যবহারকারীর পরিচয়পত্রের সাথে মিলিত হওয়া উচিত যার ভূমিকা সংস্থা প্রশাসক৷

   4. আপনি সফলভাবে ম্যানেজমেন্ট সার্ভারের সাথে সংযোগ করার পরে, আপনার পরিবর্তনগুলি সংরক্ষণ করতে পৃষ্ঠার নীচে কনফিগারেশন সংরক্ষণ করুন বোতামে ক্লিক করুন।

5. নিশ্চিত করুন যে আপডেট ম্যানেজার মডিউল সক্রিয় আছে

ড্রুপাল আপডেটের বিজ্ঞপ্তি পেতে, ড্রুপাল আপডেট ম্যানেজার মডিউল সক্রিয় আছে কিনা তা নিশ্চিত করুন। ড্রুপাল মেনু থেকে, মডিউল নির্বাচন করুন এবং আপডেট ম্যানেজার মডিউলে স্ক্রোল করুন। এটি সক্রিয় না হলে, এটি সক্রিয় করুন.

একবার সক্রিয় হয়ে গেলে, আপনি রিপোর্ট > উপলব্ধ আপডেট মেনু আইটেম ব্যবহার করে উপলব্ধ আপডেটগুলি দেখতে পারেন৷ এছাড়াও আপনি নিম্নলিখিত Drush কমান্ড ব্যবহার করতে পারেন:

drush pm-info update

আপনাকে সাইটের রুট ডিরেক্টরি থেকে এই কমান্ডটি চালাতে হবে। ডিফল্টরূপে, পোর্টালটি /opt/apigee/apigee-drupal/wwwroot এ ইনস্টল করা আছে। তাই, কমান্ড চালানোর আগে আপনাকে প্রথমে ডিরেক্টরিটিকে /opt/apigee/apigee-drupal/wwwroot এ পরিবর্তন করতে হবে। আপনি যদি ডিফল্ট ডিরেক্টরিতে পোর্টালটি ইনস্টল না করে থাকেন তবে আপনার ইনস্টলেশন ডিরেক্টরিতে পরিবর্তন করুন।

আপডেটগুলি উপলব্ধ হলে আপনাকে ইমেল করার জন্য মডিউলটি কনফিগার করতে এবং আপডেটগুলি পরীক্ষা করার জন্য ফ্রিকোয়েন্সি সেট করতে রিপোর্টগুলি > উপলব্ধ আপডেটগুলি > সেটিংস মেনু আইটেমটি ব্যবহার করুন৷

6. Apache Solr সার্চ ইঞ্জিন কনফিগার করুন (ঐচ্ছিক)

ডিফল্টরূপে, যখন আপনি পোর্টালটি ইনস্টল করেন তখন Apache Solr সার্চ ইঞ্জিনের সাথে সংযোগকারী Drupal মডিউলগুলি নিষ্ক্রিয় থাকে৷ বেশিরভাগ পোর্টাল অভ্যন্তরীণ ড্রুপাল সার্চ ইঞ্জিন ব্যবহার করে এবং তাই ড্রুপাল সোলার মডিউলের প্রয়োজন হয় না।

আপনি যদি আপনার সার্চ ইঞ্জিন হিসাবে Solr ব্যবহার করার সিদ্ধান্ত নেন, তাহলে আপনাকে অবশ্যই আপনার সার্ভারে স্থানীয়ভাবে Solr ইনস্টল করতে হবে এবং তারপর পোর্টালে Drupal Solr মডিউলগুলিকে সক্ষম ও কনফিগার করতে হবে।

ড্রুপাল সোলার মডিউলগুলি সক্ষম করতে:

1. প্রশাসক বা বিষয়বস্তু তৈরির সুবিধা সহ ব্যবহারকারী হিসাবে আপনার পোর্টালে লগ ইন করুন৷
2. ড্রুপাল মেনুতে মডিউল নির্বাচন করুন।
3. Apache Solr Framework মডিউল এবং Apache Solr Search মডিউল সক্ষম করুন।
4. আপনার পরিবর্তন সংরক্ষণ করুন.
5. https://drupal.org/node/1999280 এ বর্ণিত সোলার কনফিগার করুন।

7. SmartDocs ইনস্টল করুন (ঐচ্ছিক)

SmartDocs আপনাকে পোর্টালে আপনার APIগুলিকে এমনভাবে নথিভুক্ত করতে দেয় যা API ডকুমেন্টেশনকে সম্পূর্ণরূপে ইন্টারেক্টিভ করে তোলে। যাইহোক, পোর্টালের সাথে SmartDocs ব্যবহার করতে, আপনাকে প্রথমে এজ-এ SmartDocs ইনস্টল করতে হবে।

• আপনি যদি পোর্টালটিকে এজ ক্লাউড ইনস্টলেশনের সাথে সংযুক্ত করছেন, SmartDocs ইতিমধ্যেই ইনস্টল করা আছে এবং আর কোন কনফিগারেশনের প্রয়োজন নেই।
• আপনি যদি প্রাইভেট ক্লাউড ইনস্টলেশনের জন্য পোর্টালটিকে একটি প্রান্তের সাথে সংযুক্ত করছেন, তাহলে আপনাকে অবশ্যই নিশ্চিত করতে হবে যে এজ-এ SmartDocs ইনস্টল করা আছে। Edge এবং SmartDocs ইনস্টল করার বিষয়ে আরও জানতে, SmartDocs ইনস্টল করুন দেখুন।

আপনাকে অবশ্যই পোর্টালে SmartDocs সক্ষম করতে হবে। SmartDocs সম্পর্কে আরও তথ্যের জন্য, APIs নথিতে SmartDocs ব্যবহার করা দেখুন।

8. নন-ইন্টারনেট ইনস্টলেশনের জন্য JQuery আপডেট মডিউল কনফিগার করুন (ঐচ্ছিক)

আপনি যদি একটি নন-ইন্টারনেট ইনস্টলেশনে JQuery আপডেট মডিউল ইনস্টল এবং ব্যবহার করেন, তাহলে JQuery-এর স্থানীয় সংস্করণ ব্যবহার করার জন্য আপনাকে মডিউলটি কনফিগার করতে হবে। আপনি যদি একটি নন-ইন্টারনেট ইনস্টলেশনের জন্য একটি CDN ব্যবহার করার জন্য মডিউলটি কনফিগার করেন, তাহলে এটি CDN অ্যাক্সেস করার চেষ্টা করবে এবং পৃষ্ঠা লোড হতে বিলম্ব ঘটাবে। JQuery আপডেট মডিউল সম্পর্কে আরও তথ্যের জন্য https://www.drupal.org/project/jquery_update দেখুন।

JQuery এর স্থানীয় সংস্করণ ব্যবহার করতে JQuery আপডেট মডিউল কনফিগার করতে:

1. প্রশাসক বা বিষয়বস্তু তৈরির সুবিধা সহ ব্যবহারকারী হিসাবে আপনার পোর্টালে লগ ইন করুন৷
2. ড্রুপাল মেনুতে কনফিগারেশন > উন্নয়ন > JQuery আপডেট নির্বাচন করুন।
3. বাম নেভিগেশনে কর্মক্ষমতা ক্লিক করুন.
4. JQuery এবং JQuery UI CDN ড্রপ-ডাউনে None নির্বাচন করুন।
5. কনফিগারেশন সংরক্ষণ করুন ক্লিক করুন।

9. পরবর্তী পদক্ষেপ

নিচের সারণীতে আপনি ইনস্টলেশনের পরে সঞ্চালিত কিছু সাধারণ কাজ তালিকাভুক্ত করে, এবং Apigee ডকুমেন্টেশনের লিঙ্কগুলি অন্তর্ভুক্ত করে যেখানে আপনি আরও তথ্য পেতে পারেন: