суббота, 6 марта 2010 г.

Установка и интеграция Oracle Application Express 3.2 и Oracle e-Business Suite R12

Установка Oracle Application Express

  1. Скачиваем дистрибутив Oracle Application Express по ссылке:
    http://www.oracle.com/technology/products/database/application_express/download.html

  2. Распаковываем скаченный zip-архив (apex_3.2.zip):
     $ unzip apex_3.2.zip  
    
  3. Переходим в директорию apex (которая создастся после распаковки архива)
     $ cd  apex  
    
  4. Запускаем SQL Plus и соединаемся с БД как sys as sysdba
     $ sqlplus /nolog  
     SQL> CONNECT SYS as SYSDBA  
    
  5. В SQL Plus выполняем команду в формате:
     SQL> @apexins tablespace_apex tablespace_files tablespace_temp images  
    
    Например :
     SQL> @apexins APEX_TBS APEX_TBS APEX_TBS_TEMP /i/  
    
  6. После завершения выполнения предыдущего пункта – запускаем SQL Plus и соединяемся с БД как sys as sysdba (см. Шаг 4).
  7. В SQL Plus выполняем команду:
     SQL> @apxchpwd  
    
    Устанавливаем пароль для администратора Application Express (пользователь ADMIN)
  8. Необходимо перестартовать инстанс БД и процесс прослушивателя (listener).
  9. Запускаем SQL Plus и соединяемся с БД как sys as sysdba (см. Шаг 4).
  10. В SQL Plus выполняем команду:
     SQL> ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK  
    
  11. Выполняем следующую команду:
     SQL> ALTER USER APEX_PUBLIC_USER IDENTIFIED BY new_password  
    
    где new_password – заменить на пароль для APEX_PUBLIC_USER
  12. Скачать дистрибутив Oracle HTTP Server для соответствующей версии СУБД используемой в Oracle e-Business Suite. Например: для Oracle 11g R1 на платформе AIX по ссылке:
    http://www.oracle.com/technology/software/products/database/oracle11g/111060_aixsoft.html

  13. Установить Oracle HTTP Server используя Oracle Universal Installer
  14. Скопировать директорию apex/images (которая создастся после распаковки архива) в директорию ORACLE_HTTPSERVER_HOME/ohs:
     $ cp –rf apex/images ORACLE_HTTPSERVER_HOME/ohs  
    
    где ORACLE_HTTPSERVER_HOME – директория, где установлен Oracle HTTP Server.
  15. Используя текстовый редактор изменям файл конфигурации Oracle HTTP Server - ORACLE_HTTPSERVER_HOME/ohs/modplsql/conf/dads.conf:
     $ vi ORACLE_HTTPSERVER_HOME/ohs/modplsql/conf/dads.conf  
    
  16. Добавляем в данный файл следующий фрагмент в конец файла:
     Alias /i/ "ORACLE_HTTPSERVER_HOME/ohs/images/"  
     AddType text/xml xbl  
     AddType text/x-component htc  
     <Location /pls/apex>  
     Order deny,allow  
     PlsqlDocumentPath docs  
     AllowOverride None  
     PlsqlDocumentProcedure wwv_flow_file_mgr.process_download  
     PlsqlDatabaseConnectString host:port:service_name ServiceNameFormat  
     PlsqlNLSLanguage AMERICAN_AMERICA.AL32UTF8  
     PlsqlAuthenticationMode Basic  
     SetHandler pls_handler  
     PlsqlDocumentTablename wwv_flow_file_objects$  
     PlsqlDatabaseUsername APEX_PUBLIC_USER  
     PlsqlDefaultPage apex  
     PlsqlDatabasePassword apex_public_user_password  
     PlsqlRequestValidationFunction wwv_flow_epg_include_modules.authorize  
     Allow from all  
     </Location>  
    
    Необходимо изменить в данной фрагменте значения ORACLE_HTTPSERVER_HOME, host, port, service_name и apex_public_user_password на соответствующие Вашей системе. И в случае наобходимости значение параметра PlsqlNLSLanguage

  17. Перезапустить Oracle HTTP Server выполнив последовательно две команды:
     ORACLE_HTTPSERVER_HOME/opmn/bin/opmnctl stopproc ias-component=HTTP_Server  
     ORACLE_HTTPSERVER_HOME/opmn/bin/opmnctl startproc ias-component=HTTP_Server  
    
  18. Если СУБД - Oracle RDBMS 11g, то выполняем скрипт в SQL Plus (от sys as sysdba):
     DECLARE  
      ACL_PATH VARCHAR2(4000);  
      ACL_ID RAW(16);  
     BEGIN  
      -- Look for the ACL currently assigned to '*' and give APEX_030200  
      -- the "connect" privilege if APEX_030200 does not have the privilege yet.  
      SELECT ACL  
      INTO ACL_PATH  
      FROM DBA_NETWORK_ACLS  
      WHERE HOST   = '*'  
      AND LOWER_PORT IS NULL  
      AND UPPER_PORT IS NULL;  
      -- Before checking the privilege, ensure that the ACL is valid  
      -- (for example, does not contain stale references to dropped users).  
      -- If it does, the following exception will be raised:  
      --  
      -- ORA-44416: Invalid ACL: Unresolved principal 'APEX_030200'  
      -- ORA-06512: at "XDB.DBMS_XDBZ", line ...  
      --  
      SELECT SYS_OP_R2O(extractValue(P.RES, '/Resource/XMLRef'))  
      INTO ACL_ID  
      FROM XDB.XDB$ACL A,  
       PATH_VIEW P  
      WHERE extractValue(P.RES, '/Resource/XMLRef') = REF(A)  
      AND EQUALS_PATH(P.RES, ACL_PATH)       = 1;  
      DBMS_XDBZ.ValidateACL(ACL_ID);  
      IF DBMS_NETWORK_ACL_ADMIN.CHECK_PRIVILEGE(ACL_PATH, 'APEX_030200', 'connect') IS NULL THEN  
       DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(ACL_PATH, 'APEX_030200', TRUE, 'connect');  
      END IF;  
     EXCEPTION  
      -- When no ACL has been assigned to '*'.  
     WHEN NO_DATA_FOUND THEN  
      DBMS_NETWORK_ACL_ADMIN.CREATE_ACL('power_users.xml', 'ACL that lets power users to connect to everywhere', 'APEX_030200', TRUE, 'connect');  
      DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL('power_users.xml','*');  
     END;  
     /  
     COMMIT;  
    
  19. Если СУБД - Oracle RDBMS 11g, то выполняем скрипт в SQL Plus (от sys as sysdba):
     DECLARE  
      ACL_PATH VARCHAR2(4000);  
      ACL_ID RAW(16);  
     BEGIN  
      -- Look for the ACL currently assigned to 'localhost' and give APEX_030200  
      -- the "connect" privilege if APEX_030200 does not have the privilege yet.  
      SELECT ACL  
      INTO ACL_PATH  
      FROM DBA_NETWORK_ACLS  
      WHERE HOST   = 'localhost'  
      AND LOWER_PORT IS NULL  
      AND UPPER_PORT IS NULL;  
      -- Before checking the privilege, ensure that the ACL is valid  
      -- (for example, does not contain stale references to dropped users).  
      -- If it does, the following exception will be raised:  
      --  
      -- ORA-44416: Invalid ACL: Unresolved principal 'APEX_030200'  
      -- ORA-06512: at "XDB.DBMS_XDBZ", line ...  
      --  
      SELECT SYS_OP_R2O(extractValue(P.RES, '/Resource/XMLRef'))  
      INTO ACL_ID  
      FROM XDB.XDB$ACL A,  
       PATH_VIEW P  
      WHERE extractValue(P.RES, '/Resource/XMLRef') = REF(A)  
      AND EQUALS_PATH(P.RES, ACL_PATH)       = 1;  
      DBMS_XDBZ.ValidateACL(ACL_ID);  
      IF DBMS_NETWORK_ACL_ADMIN.CHECK_PRIVILEGE(ACL_PATH, 'APEX_030200', 'connect') IS NULL THEN  
       DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(ACL_PATH, 'APEX_030200', TRUE, 'connect');  
      END IF;  
     EXCEPTION  
      -- When no ACL has been assigned to 'localhost'.  
     WHEN NO_DATA_FOUND THEN  
      DBMS_NETWORK_ACL_ADMIN.CREATE_ACL('local-access-users.xml', 'ACL that lets power users to connect to everywhere', 'APEX_030200', TRUE, 'connect');  
      DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL('local-access-users.xml','localhost');  
     END;  
     /  
     COMMIT;  
    
  20. Установка завершена

Интеграция с аутентификацией Oracle e-Business Suite

  1. Создать функцию (или пакет содержащий данную функцию):
     FUNCTION ebiz_suite_auth(  
       p_username IN VARCHAR2,  
       p_password IN VARCHAR2)  
      RETURN BOOLEAN  
     AS  
     BEGIN  
      IF fnd_web_sec.validate_login(p_username, p_password) = 'Y' THEN  
       RETURN true;  
      ELSE  
       RETURN false;  
      END IF;  
     END;  
    
  2. Создать новую схему аутентификации:
    1. Перейти из приложения в “Shared Components”->”Authentication Schemes”.
    2. Нажать кнопку “Create”.
    3. Выбрать тип создаваемой темы как “From scratch”. Нажать “Next”.
    4. Ввести имя схемы аутентификации, например: “eBusiness Suite Authentication”. Нажать “Next”.
    5. Оставить все значения полей по-умолчанию в шагах: Page Sentry Function, Session Verify Function, Invalid Session Target, Invalid Session Target.
    6. На шаге “Authentication Function” выбрать “Use my custom function to authenticate” и ввести в поле: “return ebiz_suite_auth;”. Нажать “Next”.
    7. Оставить все значения полей по-умолчанию в шагах: Post Authentication Process, Cookie Attributes.
    8. На шаге “Logout URL” ввести: “wwv_flow_custom_auth_std.logout?p_this_flow=&APP_ID.&p_next_flow_page_sess=&APP_ID.:1:&SESSION.”. Нажать “Next”.
    9. На следующем шаге нажать “Create Scheme”. Схема создана
  3. Необходимо изменить два параметра созданной схемы:
    1. Перейти из приложения в “Shared Components”->”Authentication Schemes”.
    2. Выбрать созданную схему. В нашем случае это “eBusiness Suite Authentication”.
    3. Изменить значение поля “Session Not Valid Page” на 101 (это номер страницы логина), а значение поля “-Or- Session Not Valid URL” должно быть пустым.
    4. Нажимаем “Apply Changes”.
  4. Сделать созданную схему аутентификации активной:
    1. Перейти из приложения в “Shared Components”->”Authentication Schemes”.
    2. Перейти на вкладку “Change Current”.
    3. Выбрать для пункта “Available Authentication Schemes” наименование созданной схемы аутентификации. В нашем случае это “eBusiness Suite Authentication”. И нажать “Next”.
    4. Нажать “Make current.”


Комментариев нет:

Отправить комментарий