نصب و کانفیگ اوراکل اپکس در معماری ORDS Standalone
یکی از مشکلات اکثر کسانی که میخواهند شروع به یادگیری اپکس بکنند فراهم نبودن محیط آموزش میباشد. یکی از راه های یادگیری این ابزار استفاده از محیط cloud خود شرکت اوارکل با این آدرس می باشد که شما در این محیط میتوانید یک workspace برای خود ایجاد و شروع به یادگیری کنید.
برای استفاده از روش فوق علاوه بر نیاز داشتن به اینترنت شما یک سری محدودیت ها در قسمت admin و همچنین database دارین. روش بعدی پیاده سازی محیط اپکس بر روی سیستم شخصی خود میباشد که میتوانید از دو معماری EPG و Standalone استقاده کنید(این دو روش فقط برای محیط های آموزشی توصیه میشود) و چون در EPG شما اپکس را به صورت دو لایه دارین بنابراین بهترین محیط برای آموزش و تست بین این دو روش، ORDS Standaloneمی باشد که در این معماری شما اپکس را در حالت سه لایه دارید .
معرفی این معماری :
از ords ورژن 2.7 به بعد یک وب سرور رایگان به نام Jetty نیز ارائه شد که با کانفیگ این وب سرور و بدون نیاز به Application Server هایی مثل weblogic میتوانید یک midtier برای خود داشته باشید.
نصب و کانفیگ:
1- نصب Database :
اگر قبلا دیتابیس oracle را نصب کرده اید میتوانید از این قسمت صرف نظر کنید
ابتدا ورژن Oracle Database Express Edition 11g Release 2 را از سایت اوراکل و از اینجا دانلود کنید.
بعد از دانلود و unzip آن برای نصب دیتابیس بر روی setup.exe در شاخه DISK1 کلیک کنید.
بعد از نصب نسخه فوق مشخصات اتصال به این دیتابیس به صورت زیر می باشد
IP: localhost
Port:1521
user: sys or system
کلمه عبور sys و system همان کلمه عبوری است که موقع نصب وارد کردید.
بعد از نصب نسخه فوق با وارد کردن آدرس زیر در مرورگر خواهید دید که ابزار Oracle APEX نیز به همراه دیتابیس کانفیگ و آماده اجرا می باشد.
http://localhost:8080/apex
برای تغییر port میتوانید از دستور زیر استفاده کنید.
EXEC DBMS_XDB.SETHTTPPORT(8081);
همان طور که مشاهده میکنید این ورژن قدیمی اپکس یعنی 4.0.2 میباشد که در مرحله بعدی به ورژن 18.1 آن را upgrade میکنیم.
2- Upgrade کردن ورژن اپکس به نسخه 18.1
ابتدا از سایت oracle.com و از طریق این لینک اپکس را دانلود کنید.
بعد از دانلود فایل را unzip کرده و در محیط cmd وارد مسیر فایل های اپکس بشوید و با کاربر sys به دیتابیس لاگین کنید
ابتدا کاربر APEX_PUBLIC_USER را unlock و کلمه عبور آن را هم عوض بکنید
alter user APEX_PUBLIC_USER account unlock identified by APEX_PUBLIC_USER;
سپس برای نصب اپکس 18.1 دستور زیر را اجرا کنید
@apexins.sql SYSAUX SYSAUX TEMP /i/
در دستور فوق SYSAUX نام tablespace است که میخواهیم اسکیمیای apex18 در آن ایجاد شود و شما می توانید در صورت تمایل از tablespace دیگر استفاده کنید.
نکته: Tablespace ای که میخواهید برای نصب اسکیمای اپکس از ان استفاده کنید باید از نوع Auto Segment Space Management باشد.
بعد از اجرای دستور فوق دستور زیر را اجرا کنید
@apxldimg.sql d:\
نکته : در دستور فوق d:\ مسیر شاخه ای است که شاخه apex در آن قرار دارد پس اگر مثلا مسیر شاخه اپکس شما d:\software\apex باشد جلوی دستور فوق مسیر d:\software\ را وارد کنید. اگر مسیر را اشتباه وارد کنید به خطا برخورد میکنید.
بعد از دستور فوق باید کاربر admin مربوط به internal workspace را تنظیم کنید برای این کار دستور زیر را اجرا کنید
@apxchpwd.sql
نکته: در هنگام تعیین password باید policy را رعایت کنید یعنی کلمه عبور باید شامل حروف کوچک و بزرگ باشد به طور مثال من کلمه عبور Apex_18 را وارد میکنم.
بعد از اجرای دستورات فوق باید ورژن APEX شما به 18.1 تغییر پیدا کرده باشد.
در این مرحله شما میتوانید با APEX در حالت EPG کار کنید ولی در صورت تمایل کار با اپکس در حالت سه لایه می توانید با دنبال کردن مرحله بعد ORDS را تنظیم کنید
3- تنظیم Standalone Mode :
در محیط cmd وارد مسیر فایل های اپکس بشوید و با کاربر sys به دیتابیس لاگین کنید و اسکریپت زیر را اجرا کنید:
@apex_rest_config.sql
در هنگام اجرای اسکریپت فوق برای اسکیما های APEX_LISTENER و APEX_REST_PUBLIC_USER از شما کلمه عبور می خواهد که این کلمه عبور ها را در مراحل جلوتر هم از شما میپرسد و این دو اسکیما بعد از اجرای اسکریپت فوق در دیتابیس شما ایجاد میشود
بعد از اجرای اسکزیپت فوق از unlock بود اسکیما های زیر اطمینان حاصل کنید
select username
, account_status
from dba_users
where username in ('APEX_PUBLIC_USER','APEX_LISTENER','APEX_REST_PUBLIC_USER','ORDS_PUBLIC_USER');
برای کانفیگ ورژن های بالای ords مثل ورژن 18.2 نیار به نصب JDK ورژن 8 به بالا میباشد بنابراین JDK ورژن 8 را از سایت oracle و از طریق این لینک دانلود و نصب کنید.
نکته: مشاهده ورژن java نصب شده
java -version
برنامه ords را از سایت اوراکل و از طریق این لینک دانلود کنید.
بعد از download آن را unzip کنید و در شاخه آن یک شاخه با نام config ایجاد کنید.
در محیط cmd وارد شاخه ords شده (در اینجا شاخه ords من در مسیر d:\ords می باشد)
cd d:\ords
و دستور زیر را اجرا کنید
java -jar ords.war
در این دستور تنظیمات زیررا انجام دهید:
برای تنظیم زیر آدرس شاخه config را وارد کنید
Enter the location to store configuration data:D:\ords\config
برای تنظیم زیر آدرس Database Server را وارد کنید.(در این مثال Database و ORDS ما در یک ماشین قرار داردند در حالی که Database و ORDS می توانند در دو سرور جداگانه نصب شوند)
Enter the name of the database server [localhost]:localhost
برای تنظیم زیر port مربوط به listener دیتابیس را وارد کنید
Enter the database listen port [1521]:
برای تنظیم زیر میتوانید عدد 1 و سپس service name و یا عدد 2 سپس sid دیتابیس را وارد کنید
Enter 1 to specify the database service name, or 2 to specify the database SID [1]:2
Enter the database SID [xe]:xe
برای تنظیم زیر یک کلمه عبور دلخواه برای اسکیمای ORDS_PUBLIC_USER وارد کنید.
Enter the database password for ORDS_PUBLIC_USER:
برای تنظیم زیر برای اعمال تغییرات در دیتابیس کلمه عبور sys را وارد کنید.
Enter the database password for SYS AS SYSDBA:
برای تنظیم زیر عدد 1 را واردکنید
Enter 1 if you want to use PL/SQL Gateway or 2 to skip this step.
If using Oracle Application Express or migrating from mod_plsql then you must enter1 [1]:
برای تنظیم زیر کلمه عبور APEX_PUBLIC_USER را وارد کنید(همان کلمه عبوری که در مراحل قبل تر تعیین کردید)
Enter the database password for APEX_PUBLIC_USER:
برای تنظیم زیر عدد 1 را وارد کنید
Enter 1 to specify passwords for Application Express RESTful Services database users (APEX_LISTENER, APEX_REST_PUBLIC_USER) or 2 to skip this step [1]:
برای تنظیم زیر یک کلمه عبور برای اسکیمای APEX_LISTENER وارد کنید. (همان کلمه عبوری که در مراحل قبل تر تعیین کردید)
Enter the database password for APEX_LISTENER:
برای تنظیم زیر هم یک کلمه عبور برای اسکیمای وارد کنید. (همان کلمه عبوری که در مراحل قبل تر تعیین کردید)
Enter the database password for APEX_REST_PUBLIC_USER:
و برای start standalone mode عدد 1 را وارد کنید.
Enter 1 if you wish to start in standalone mode or 2 to exit [1]:
برای تنظیم زیر محل شاخه images اپکس که دانلود کرده اید را وارد کنید
Enter the APEX static resources location: D:\apex\images
برای تنظیم زیر هم عدد 1 را وارد کنید
Enter 1 if using HTTP or 2 if using HTTPS [1]:
این صفحه cmd نباید بسته شود زیر را با بسته شدن آن سرویس ords هم stop می شود و در صورت بسته شدن این صفحه برای start کردن مجدد سرویس ORDS دستور زیر را وارد کنید
java -jar ords.war standalone
حال باید از طریق آدرس زیر اپکس را از طریق ords مشاهده کنید
نکته: برای مشاهده و ویرایش کانفیگ ords مثل عوض کردن پورت یا عوض کردن مسیر فایل های اپکس فایل standalone.properties در داخل شاخه config\ords\standalone را ویرایش کنید.