Developer Services পোর্টাল ইনস্টলেশন

প্রাইভেট ক্লাউডের জন্য Edge v. 4.17.09

ইনস্টল করার আগে, নিশ্চিত করুন যে:

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

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

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

কোনও নোডে Edge apigee-setup ইউটিলিটি ইনস্টল করার পরে, সেই ইউটিলিটি ব্যবহার করে নোডে পোর্টাল ইনস্টল করুন। apigee-setup ইউটিলিটি এই ফর্ম্যাটে থাকে:

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

apigee-setup ইউটিলিটিতে একটি কনফিগারেশন ফাইল পাস করুন যাতে ইনস্টলেশন সম্পর্কিত তথ্য থাকে। কনফিগারেশন ফাইলে কোনও প্রয়োজনীয় তথ্য না থাকলে, apigee-setup ইউটিলিটি আপনাকে কমান্ড লাইনে সেটি লিখতে প্রম্পট করবে।

একমাত্র প্রয়োজন হল, কনফিগারেশন ফাইলটি "apigee" ব্যবহারকারীর দ্বারা অ্যাক্সেসযোগ্য বা পাঠযোগ্য হতে হবে।

যেমন, পোর্টাল ইনস্টল করতে নিম্নলিখিত কমান্ড ব্যবহার করুন:

> 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

১. 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 এবং PASSWORD হল ORGNAME-এর অ্যাডমিনিস্ট্রেটরের ইমেল আইডি ও পাসওয়ার্ড।

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

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

৩. Postgres ইনস্টল করা

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

• আপনি যদি Edge-এর অংশ হিসেবে ইনস্টল করা Postgres-এর সাথে কানেক্ট করেন এবং Postgres যদি মাস্টার/স্ট্যান্ডবাই মোডে কনফিগার করা থাকে, তাহলে মাস্টার Postgres সার্ভারের IP অ্যাড্রেস উল্লেখ করুন।
• আপনি যদি 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)
   
   # Postgres-এর পড ও অঞ্চল। নিচে দেখানো ডিফল্ট ভ্যালু ব্যবহার করুন।
   MP_POD=gateway
   REGION=dc-1
   
   # Postgres পাসওয়ার্ড সেট করুন। ডিফল্ট মান হল 'postgres'।
   PG_PWD=postgres
3. কমান্ড প্রম্পটে, Postgres ইনস্টল করার জন্য সেট-আপ স্ক্রিপ্ট রান করান:
   > /opt/apigee/apigee-setup/bin/setup.sh -p pdb -f configFile
   
   “-p pdb” বিকল্পটি Postgre ইনস্টল করার জন্য নির্দিষ্ট করে।
   
   কনফিগারেশন ফাইল "apigee" ব্যবহারকারীর অ্যাক্সেসযোগ্য বা পাঠযোগ্য হতে হবে।

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

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

1. ইন্টারনেট বা ইন্টারনেট ছাড়া পদ্ধতি ব্যবহার করে নোডে Edge apigee-setup ইউটিলিটি ইনস্টল করুন। আরও জানতে Edge apigee-setup ইউটিলিটি ইনস্টল করুন লিঙ্ক দেখুন।
2. নিশ্চিত করুন যে আপনি Postgres ইনস্টল করেছেন, হয় Postgres স্ট্যান্ডঅ্যালোন হিসেবে অথবা Edge ইনস্টল করার অংশ হিসেবে।
3. কমান্ড প্রম্পটে, সেট-আপ স্ক্রিপ্ট রান করান:
   > /opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile
   
   "-p dp" বিকল্পটি পোর্টাল ইনস্টল করার জন্য নির্দিষ্ট করে।
   
   কনফিগারেশন ফাইল "apigee" ব্যবহারকারীর অ্যাক্সেসযোগ্য বা পাঠযোগ্য হতে হবে।
4. http://localhost:8079 লিঙ্কে গিয়ে পোর্টালের হোম পেজে নেভিগেট করুন অথবা আপনার পোর্টালের DNS নামের মাধ্যমে নেভিগেট করুন।
5. কনফিগারেশন ফাইলে সেট করা অ্যাডমিনিস্ট্রেটর ক্রেডেনশিয়াল ব্যবহার করে পোর্টালে লগ-ইন করুন যাতে পোর্টালে সঠিকভাবে কাজ করছে কিনা তা নিশ্চিত করা যায়।
6. আপনি যাতে পোর্টালের বর্তমান স্ট্যাটাস দেখতে পান তা নিশ্চিত করতে Drupal মেনুতে রিপোর্ট > স্ট্যাটাস রিপোর্ট বিকল্প বেছে নিন।

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

Drupal আপডেট সংক্রান্ত বিজ্ঞপ্তি পেতে, Drupal আপডেট ম্যানেজার মডিউল চালু আছে কিনা দেখে নিন। Drupal মেনু থেকে, মডিউল বেছে নিন এবং স্ক্রল করে আপডেট ম্যানেজার মডিউলে যান। এটি চালু করা না থাকলে, চালু করুন।

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

> drush pm-info update

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

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

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

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

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

Drupal Solr মডিউল চালু করতে:

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

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

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

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

এছাড়াও, আপনাকে পোর্টাল থেকে SmartDocs চালু করতে হবে। SmartDocs সম্পর্কে আরও জানতে, API ডকুমেন্ট করার জন্য SmartDocs ব্যবহার করা দেখুন।

৮. ইন্টারনেট কানেকশন নেই এমন ইনস্টলেশনের জন্য JQuery Update মডিউল কনফিগার করুন (ঐচ্ছিক)

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

JQuery-এর লোকাল ভার্সন ব্যবহার করার জন্য JQuery Update মডিউল কনফিগার করতে:

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

৯. এরপর কী করতে হবে?

Developer Services পোর্টাল ইনস্টল করার পরে আপনার পরবর্তী ধাপ হল, আপনার নির্দিষ্ট প্রয়োজন অনুযায়ী এটি কনফিগার ও কাস্টমাইজ করা। Apigee ওয়েবসাইটে ডকুমেন্টেশনে পোর্টাল কনফিগার করা, স্টাইল করা ও ম্যানেজ করা সংক্রান্ত সব তথ্য রয়েছে। http://apigee.com/docs/developer-services/content/what-developer-portal লিঙ্কে গিয়ে ডকুমেন্টেশন অ্যাক্সেস করুন।

নিচের টেবিলে ইনস্টলেশনের পরে করা সবচেয়ে সাধারণ কিছু টাস্কের তালিকা দেওয়া হল, এবং এতে Apigee ডকুমেন্টেশনের লিঙ্কও রয়েছে যেখানে আপনি আরও তথ্য পাবেন:

/opt/apigee/apigee-drupal-devportal-opdk_version/source/conf/settings.php