Oracle APEX 4.2-安装与配置.docx

Oracle APEX 4.2安装与配置北极熊 2015年16周Oracle APEX 4.2安装与配置Oracle 官方文档翻译 1 / 2Oracle APEX 4.2安装与配置绪言11Oracle Application Express安装综述21.1安装过程概述21.2从之前的Oracle Application Express版本升级21.3关于运行环境21.4关于选择Web监听器31.4.1关于 Oracle Application Express Listener和Oracle HTTP Server with mod_plsql31.4.2About the Embedded PL/SQL Gateway41.4.3Selecting a Web Listener in an Oracle RAC Environment41.5可用的安装场景41.5.1Downloading from OTN and Configuring the Oracle Application Express Listener：51.5.2Downloading from OTN and Configuring the Embedded PL/SQL Gateway51.5.3Downloading from OTN and Configuring Oracle HTTP Server62Oracle Application Express安装要求62.1Oracle Database 要求62.2Browser 要求62.3Web Listener 要求62.4Disk Space 要求62.5Oracle XML DB 要求62.6PL/SQL Web Toolkit6IIOracle APEX 4.2安装与配置绪言这篇指南描述如何安装和配置Oracle Application Express.1 Oracle Application Express安装综述1.1 安装过程概述安装包含以下过程： 计划安装：此章设计Oracle Application Express安装的必须步骤。在计划阶段，你应该明确是否安装完整的开发环境或是运行环境。你还应该明确使用哪种Web 监听器。Oracle Application Express可用的监听器选项包括：embedded pl/sql gateway，或是Oracle HTTP Server和mod_plsql。完整的开发环境提供完全的应用构建环境为开发者。运行环境产品实现的合适选择，当运行应用且不需要改变它时。更多内容见：“关于Oracle Application Express 运行环境”； 校验安装需求：“Oracle Application Express 安装需求”描述了安装之前在你系统中必须具备的最小需求； 安装软件：必须得安装步骤取决于你选择的Web监听器1.2 从之前的Oracle Application Express版本升级如果你之前安装了Oracle Application Express的1.5.x, 1.6.x, 2.0.x, 2.2.x, 3.0.x, 3.1.x, 3.2.x, 4.0x or 4.1x版本，选择相应场景中的升级步骤将Oracle Application Expresss升级到4.2，并将Oracle Application Express 4.2数据库对象建立在一个新的schema，然后移植应用。1.3 关于运行环境为测试产品实例，Oracle Application Express支持仅安装Oracle Application Express的运行时版本。运行时环境最小化安装足迹和权限以提升应用的安全性，在运行环境中开发者不会由于疏忽改变产品应用。Oracle Application Express能够运行产品应用，但是不为管理提供Web接口。运行环境仅仅包含运行应用所必须的包。管理运行时环境使用sql*plus或是Sql developer工具运行APEX_INSTANCE_ADMIN API。学习更多的见Oracle Application Express Application Builder Users Guide中的Managing a Runtime Environment。从一个已存在实例中添加或删除开发接口的脚本见Oracle Application Express的安装场景中升级部分。1.4 关于选择Web监听器为了接收和响应来之Internet的请求。Oracle Application Express使用下列三种Web监听器之一，Oracle Application Express Listener, Oracle HTTP Server with mod_plsql,or the embedded PL/SQL gateway。如何选择最佳的Web监听器参见：/technetwork/developer-tools/apex/application-express/apex-deploy-installation-1878444.html#listener1.4.1 关于 Oracle Application Express Listener和Oracle HTTP Server with mod_plsqlOracle Application Express监听器直接与Oracle Application Express引擎通讯。Oracle HTTP Server使用mod_plsql插件与数据库内部的Oracle Application Express引擎通讯。Oracle Application Express监听器与Oracle HTTP Server作为Web Server与Oracle数据库内部对象之间通讯的中介器。具体来说它们调用SQL*net连接映射浏览器请求到数据库存储过程中。下面的图片说明了Oracle Application Express监听器的体系结构。使用Oracle Application Express Listener or Oracle HTTP Server (Apache) with mod_plsql主要好处在于分离中间层与数据库层。当使用Oracle HTTP Server时image存储在文件系统中，相关别名 /i/。如果从一个之前的Oracle Application Express版本升级，可以定位文件系统中的image目录，通过以下文件能够搜索别名/i/：Oracle HTTP Server和Oracle 11g r1之后的版本，看dads.conf文件Oracle Application Server 10g，看marvel.conf文件1.4.2 About the Embedded PL/SQL GatewayOracle XML DB Protocol Server 和 embedded PL/SQL gateway随着Oracle数据库安装。它提供Oracle数据库内的Web服务器和建立动态应用必须的结构。embedded PL/SQL gateway运行在数据库的XML DB协议服务器中并包含mod_plsql核心特性。下面的图片说明了Oracle embedded PL/SQL gateway的体系结构。安全方面：The embedded PL/SQL gateway运行Oracle数据库内部作为XML DB HTTP 协议监听器的一部分。因为Oracle Application Express在安装时与HTTP监听器是同样的数据库，它不可能从数据库分离HTTP监听器。因此Oracle不推荐在Internet中使用embedded PL/SQL gateway。使用The embedded PL/SQL gateway时images位于数据库内部。1.4.3 Selecting a Web Listener in an Oracle RAC Environment当在运行Oracle Real Application Clusters (Oracle RAC)环境Oracle Application Express时，Oracle推荐使用Oracle Application Express Listener或 Oracle HTTP Server with mod_plsql。Oracle Application Express Listener 或 Oracle HTTP Server with mod_plsql允许你指定一个连接使用服务名格，这样HTTP Server能够访问所有节点。Oracle推荐不要the embedded PL/SQL gateway选项对应Oracle RAC d的安装。The embedded PL/SQL gateway 使用的HTTP Server建立在数据库实例内，由于这个原因利用Oracle RAC 体系机构带来的好处。1.5 可用的安装场景场景 1: Downloading from OTN and Configuring the Oracle Application Express Listener 场景 2: Downloading from OTN and Configuring the Embedded PL/SQL Gateway 场景 3: Downloading from OTN and Configuring Oracle HTTP Server 1.5.1 Downloading from OTN and Configuring the Oracle Application Express Listener：以下步骤对应在OTN上下载并配置Oracle Application Express监听器Step 1: Install the Oracle Database and Complete Pre-installation Tasks Step 2: Download and Install Oracle Application Express Step 3: Change the Password for the ADMIN Account Step 4: Configure RESTful Services Step 5: Restart Processes Step 6: Configure APEX_PUBLIC_USER Account Step 7: Download and Install Oracle Application Express Listener Step 8: Enable Network Services in Oracle Database 11g Step 9: Security Considerations Step 10: About Developing Oracle Application Express in Other Languages Step 11: About Managing JOB_QUEUE_PROCESSES Step 12: Create a Workspace and Add Oracle Application Express Users 1.5.2 Downloading from OTN and Configuring the Embedded PL/SQL Gateway以下步骤对应在OTN上下载并配置the Embedded PL/SQL GatewayStep 1: Install the Oracle Database and Complete Pre-installation Tasks Step 2: Download and Install Oracle Application Express Step 3: Change the Password for the ADMIN Account Step 4: Configure the Embedded PL/SQL Gateway Step 5: Enable Network Services in Oracle Database 11g Step 6: Security Considerations Step 7: About Running Oracle Application Express in Other Languages Step 8: About Managing JOB_QUEUE_PROCESSES Step 9: Configuring the SHARED_SERVERS Parameter Step 10: Create a Workspace and Add Oracle Application Express Users 1.5.3 Downloading from OTN and Configuring Oracle HTTP Server以下步骤对应在OTN上下载并配置Oracle HTTP ServerStep 1: Install the Oracle Database and Complete Pre-installation Tasks Step 2: Download and Install Oracle Application Express Step 3: Change the Password for the ADMIN Account Step 4: Restart Processes Step 5: Configure Oracle HTTP Server Distributed with Oracle Database 11g or Oracle Application Server 10g Step 6: Enable Network Services in Oracle Database 11g Step 7: Security Considerations Step 8: About Running Oracle Application Express in Other Languages Step 9: About Managing JOB_QUEUE_PROCESSES Step 10: About Obfuscating PlsqlDatabasePassword Parameter Step 11: Create a Workspace and Add Oracle Application Express Users 2 Oracle Application Express安装要求本章描述了Oracle Application Express安装的要求2.1 Oracle Database 要求Oracle Application Express release 4.2 必须Oracle database (Enterprise Edition, Standard Edition or Standard Edition One) Release 或更高版本。Oracle Application Express 4.2也能使用Oracle Database Express Edition 10g Release 2 和之后的版本。Oracle HTTP Server不包含在Oracle Database Express Edition.中。2.1.1 检查目标数据库的shared_pool_sizeOracle Application Express 必须最少100M的shared_pool_size查看并修改shared_pool_sizesqlplus / as sysdbashow parameter pfileshow parameter shared_pool_sizealter system set shared_pool_size=100m scope=spfile;shutdown immediatestartup2.2 Browser 要求运行或开发Oracle Application Express应用，Web browsers必须使能avaScript。下列browsers对于开发Oracle Application Express应用是必须的：Microsoft Internet Explorer 7.0 or laterMozilla Firefox 14 or laterGoogle Chrome 21 or laterApple Safari 5.0 or later2.3 Web Listener 要求为了运行Oracle Application Express你必须至少能访问下列之一： Oracle Application Express ListenerOracle Application Express Listener是基于JAVA的Web服务器，它具备文件系统缓存特性，能够提高文件上传能力，并且Oracle WebLogic Server, Oracle Glassfish Server, and OC4J上是认证的 Embedded PL/SQL gatewayOracle XML DB Protocol server with the embedded PL/SQL gateway 随着Oracle Database 11g Release 1安装。它提供了在数据库中的Web server 和建立动态应用必须得基础架构。 Oracle HTTP Server and mod_plsqlOracle HTTP Server使用mod_plsql插件和Oracle数据库中的Oracle Application Express引擎通讯。以下产品包含相应版本的HTTP Server和mod_plsql:Oracle Database 10g Companion CD Release 2Oracle Database 11g Release 1 or 22.4 Disk Space 要求Oracle Application Express软件下载，在文件系统中需要：278 MB 仅下载英文版本(apex_4.2_en.zip) 和 935 MB 下载完整版本(apex_4.2.zip).Oracle Application Express表空间需要275 MB的空闲空间SYSTEM表空间需要100 MB的空闲空间Oracle Application Express 表空间为每个附加的语言安装需要 (other than English) 60 MB的空闲空间2.5 Oracle XML DB 要求Oracle XML DB 必须在数据库中安装。如果你通过使用DBCA安装预配置的数据库，那么Oracle XML DB 将已经安装并配置。提示：安装程序将会先进行检查，如果XML DB未安装将会退出；Oracle XML DB安装将会建立帐号ANONYMOUS，为了使Oracle Application Express工作空间正确的工作，ANONYMOUS帐号必须删除。2.6 PL/SQL Web ToolkitOracle Application Express必须PL/SQL Web Toolkit release .6或之后版本。为指导查看PL/SQL Web Toolkit的当前版本和安装release .6，请查看在apex/owa目录下的README.txt文件。3 从OTN下载并安装Oracle Application Express本章描述如何从OTN上下在Oracle Application Express的ZIP文件，并完成Oracle Application Express安装3.1 推荐的安装之前的任务在安装Oracle Application Express之前，Oracel推荐你完成如下任务：1. 认真回顾所有安装需求；2. 关闭你需要安装Oracle Application Express的数据库实例，对于Oracle RAC关闭所有节点上的实例。另一个可选的在升级Oracle Application Express时相对于关闭数据库以阻止所有用户访问的方法。Oracle仅推荐在高可用系统中不可中断数据库时使用，其它情况下都应该关闭数据库。对于使用Oracle Application Express监听器，关闭相应应用服务器上的Oracle Application Express监听器；对于使用Oracle HTTP Server with mod_plsql，关闭应用服务器或是禁用应用服务器上的Application Express访问描述符；对于使用emdedded PL/SQL网关，应该通过设置HTTP端口为0 的方式禁用XML DB协议服务器，通过sqlplus执行命令：EXEC DBMS_XDB.SETHTTPPORT(0);在明确阻止了所有用户访问Oracle Application Express之后，使用sqlplus 以sys用户登录安装Oracle Application Express，并查询v$session视图确保没有长时间运行的会话干扰升级过程3. 备份数据库Oracle推荐在安装Oracle Application Express之前备份数据库3.2 选择一个Web Listener为了接收和响应来之Internet的请求。Oracle Application Express使用下列三种Web监听器之一，Oracle Application Express Listener, Oracle HTTP Server with mod_plsql,or the embedded PL/SQL gateway。如何选择最佳的Web监听器参见：/technetwork/developer-tools/apex/application-express/apex-deploy-installation-1878444.html#listener3.3 从OTN下载并配置Oracle Application Express Listener3.3.1 安装Oracle 数据库并完成预安装任务Oracle Application Express必须Oracle database Release 或之后版本或 Oracle Database 10g Express Edition3.3.2 下载并安装Oracle Application Express1. 下载Oracle Application Express英文版或多语言版/technetwork/developer-tools/apex/downloads/index.html2. 解压文件UNIX：$unzip apex_4.2_en.zip 或 $unzip apex_4.2.zipWindows：直接在Windows Explorer中解压3. 改变工作目录到apex4. 使用sql*plus以sysdba角色的sys用户连接到数据库进行Oracle Application Express安装5. 检查默认策略文件中存在的密码复杂度规则6. 选择一个相应的安装选项完整的开发环境提供了开发应用完全的应用构建环境。运行时环境使用户能运行应用且不能改变应用。可用的安装选项包括：完整开发环境运行apexins.sql脚本并使用如下显示的四个参数：apexins.sql tablespace_apex tablespace_files tablespace_temp images tablespace_apex：Oracle Application Express应用用户的表空间名； tablespace_files： Oracle Application Express 文件用户的表空间名； tablespace_temp： 临时表空间名 images：Oracle Application Express images的虚拟目录。为支持Oracle Application Express将来的升级，定义虚拟image目录为/i/。例子：apexins.sql SYSAUX SYSAUX TEMP /i/注意：如果下列错误，则请退出SQL*Plus并改变进入工作目录到apex:SP2-0310: unable to open file apexins.sql运行时环境运行apxrtins.sql脚本并使用如下显示的四个参数：apxrtins.sql tablespace_apex tablespace_files tablespace_temp images tablespace_apex：Oracle Application Express应用用户的表空间名； tablespace_files： Oracle Application Express 用户表空间的文件名； tablespace_temp： 临时表空间名 images：Oracle Application Express images的虚拟目录。为支持Oracle Application Express将来的升级，定义虚拟image目录为/i/。例子：aprxtins.sql SYSAUX SYSAUX TEMP /i/当Oracle Application Express安装时，将建立3个新的数据库账号： APEX_040200：这个账号是Oracle Application Express schema 和元数据的所有者； FLOWS_FILES：这个账号是 Oracle Application Express上传文件的所有者； APEX_PUBLIC_USER：这是最小权限的账号，用户Oracle Application Express配置Oracle Application Express Listener 或 Oracle HTTP Server and mod_plsql。This account is created to enable a later switch to a different HTTP server。注：Oracle Application Express必须从一个可写的目录安装如果配置RESTful Web services，那么两个附加的账号将创建： APEX_REST_PUBLIC_USER：这个账号调用存储在Oracle Application Express中的RESTful Services definitions。 APEX_LISTENER：这个账号用于查询存储在Oracle Application Express中的RESTful Services definitions。3.3.3 修改admin账号密码在安装新的Oracle Application Express，或是从运行时环境转换到开发环境时，你必须修改内部账号admin的密码。注：admin账号用于登录Oracle Application Express Administration Services管理Oracle Application Express实例。修改admin账号密码：sqlplus / as sysdbaapxchpwd.sql3.3.4 重新启动进程在安装Oracle Application Express之后必须重新启动进程。3.3.5 配置APEX_PUBLIC_USER正确的配置APEX_PUBLIC_USER账号对于能正确操作Oracle Application Express时重要的。解锁APEX_PUBLIC_USER账号对于新安装的Oracle Application Express应用APEX_PUBLIC_USER账号是锁定的，在配置database access descriptor (DAD)之前需要解锁这个账号。sqlplus / as sysdbaalter user APEX_PUBLIC_USER account unlock;修改APEX_PUBLIC_USER账号密码sqlplus / as sysdbaalter user APEX_PUBLIC_USER identified by apexpub;关于Oracle Database 11g的密码终止在Oracle 11g安装的默认策略中PASSWORD_LIFE_TIME设置为180天。如果在Oracle 11g数据库上使用Oracle Application Express将导致APEX_PUBLIC_USER 密码180天终止。Oracle Application Express实例将不可用直到修改密码。为了消除这个行为，为APEX_PUBLIC_USER用户设置独立的策略为无限制。3.3.6 下载并安装Oracle Application Express Listener下载最新版本的 Oracle Application Express Listener，从Oracle Application Express下载页面下载类似 apex_listener.version.number.zip文件名的文件：/technetwork/developer-tools/apex-listener/downloads/index.html注：文件名中的 version.number显示的是当前版本号。解压下载的zip文件到你选定的目录或文件夹。UNIX and Linux: unzip apex_listener.version.number.zipWindows: 使用Windows Explorer解压apex_listener.version.number.zip根据安装手册的介绍完成Oracle Application Express Listener安装和配置步骤。禁用Oracle XML DB Protocol Server如果之前 使用embedded PL/SQL Gateway现在希望使用Oracle Application Express Listener，那么需要禁用Oracle XML DB Protocol server。校验端口号，确认Oracle XML DB Protocol Server运行：sqlplus / as sysdbaselect dbms_xdb.gethttpport from dual;如果端口号是0，那么Oracle XML DB Protocol Server是禁用的。禁用Oracle XML DB Protocol Serversqlplus / as sysdbaEXEC DBMS_XDB.SETHTTPPORT(port);例：EXEC DBMS_XDB.SETHTTPPORT(0);3.3.7 配置RESTful Services如果新安装一个Oracle Application Express，运行apex_rest_config.sql配置脚本进行RESTful Services配置。此步骤是可选的，仅需要希望在Oracle Application Express Listener实例上使用RESTful Services完成。一旦配置实例管理员能够控制这个特性的可用性，管理员能够禁用RESTful Services，RESTful Services将不可用并且RESTful Services icon不被显示。注：RESTful Services必须Oracle Application Express Listener 2.0 或之后。配置RESTful服务改变目录到解压安装Oracle Application Express的目录sqlplus / as sysdbaapex_rest_config.sql根据提示输入APEX_LISTENER和APEX_REST_PUBLIC_USER账号的密码，Oracle Application Express配置RESTful Services将创建两个新账号。3.3.8 在Oracle 11g中开启网络服务默认情况下Oracle 11g r1和r2的网络交互能力是禁用的。因而，如果在Oracle 11g上使用Oracle Application Express必须使用一个新的包dbms_network_acl_admin授权连接权限给所有主机针对于apex_040200数据库用户。授权失败将产生如下问题： Oracle Application Express发送邮件时。用户可以调用APEX_MAIL发送邮件，但将发现问题； Oracle Application Express调用Web Services时 PDF/report打印时 1. 授权连接权限接下来的例子展示了如何为数据库用户APEX_040200授权连接权限给任何主机。这个例子假定你已经使用sys用户以sysdba角色连接到安装了Oracle Application Express的数据库DECLARE ACL_PATH VARCHAR2(4000);BEGIN - Look for the ACL currently assigned to * and give APEX_040200 - the connect privilege if APEX_040200 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; IF DBMS_NETWORK_ACL_ADMIN.CHECK_PRIVILEGE(ACL_PATH, APEX_040200, connect) IS NULL THEN DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(ACL_PATH, APEX_040200, 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_040200, TRUE, connect); DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL(power_users.xml,*);END;/COMMIT;接下来的例子展示了如何提供更少的权限访问网络资源。这个例子开启Oracle Application Express Online Help指引和email，PDF printing ，如果这些服务在本地主机时。DECLARE ACL_PATH VARCHAR2(4000);BEGIN - Look for the ACL currently assigned to localhost and give APEX_040200 - the connect privilege if APEX_040200 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; IF DBMS_NETWORK_ACL_ADMIN.CHECK_PRIVILEGE(ACL_PATH, APEX_040200, connect) IS NULL THEN DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(ACL_PATH, APEX_040200, 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 users to connect to localhost, APEX_040200, TRUE, connect); DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL(local-access-users.xml,localhost);END;/COMMIT;2. 无效的ACL错误疑难解答如果在运行之前脚本后收到ORA-44416: Invalid ACL error，使用下列查询定位无效的ACLREM Show the dangling references to dropped users in the ACL that is assignedREM to *.SELECT ACL, PRINCIPAL FROM DBA_NETWORK_ACLS NACL, XDS_ACE ACE WHERE HOST = * AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL AND NACL.ACLID = ACE.ACLID AND NOT EXISTS (SELECT NULL FROM ALL_USERS WHERE USERNAME = PRINCIPAL);下一步，运行下列代码修复ACLDECLARE ACL_ID RAW(16); CNT NUMBER;BEGIN - Look for the object ID of the ACL currently assigned to * SELECT ACLID INTO ACL_ID FROM DBA_NETWORK_ACLS WHERE HOST = * AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL; - If just some users referenced in the ACL are invalid, remove just those - users in the ACL. Otherwise, drop the ACL completely. SELECT COUNT(PRINCIPAL) INTO CNT FROM XDS_ACE WHERE ACLID = ACL_ID AND EXISTS (SELECT NULL FROM ALL_USERS WHERE USERNAME = PRINCIPAL); IF (CNT 0) THEN FOR R IN (SELECT PRINCIPAL FROM XDS_ACE WHERE ACLID = ACL_ID AND NOT EXISTS (SELECT NULL FROM ALL_USERS WHERE USERNAME = PRINCIPAL) LOOP UPDATE XDB.XDB$ACL SET OBJECT_VALUE = DELETEXML(OBJECT_VALUE, /ACL/ACEPRINCIPAL=|R.PRINCIPAL|) WHERE OBJECT_ID = ACL_ID; END LOOP; ELSE DELETE FROM XDB.XDB$ACL WHERE OBJECT_ID = ACL_ID; END IF;END;/REM commit the changes.COMMIT;3.3.9 安全考虑Oracle强烈推荐使用Secure Sockets Layer