Как установить oracle apex
Как установить oracle apex
Learn about downloading and installing Oracle Application Express.
How you install Oracle Application Express depends upon by the type of database you into which you are installing. This section describes how to download and install Oracle Application Express.
5.2.1 Installing Application Express
Install Oracle Application Express by downloading a ZIP file from the Oracle Application Express download page.
To install Oracle Application Express:
Note that the actual file name may differ if a more recent release has shipped since this document was published.
If English only, unzip apex_20.2_en.zip as follows, preserving directory names:
Windows: Double click the file apex_20.2_en.zip in Windows Explorer
If multiple languages, unzip apex_20.2.zip as follows, preserving directory names:
Windows: Double click the file apex_20.2.zip in Windows Explorer
Full development environment provides complete access to the App Builder environment to develop applications. A Runtime environment enables users to run applications that cannot be modified.
Available installation options include:
tablespace_apex is the name of the tablespace for the Oracle Application Express application user.
tablespace_files is the name of the tablespace for the Oracle Application Express files user.
tablespace_temp is the name of the temporary tablespace or tablespace group.
If you receive the following error, exit SQL*Plus and change your working directory to where you unzipped the installation file, for example C:\TEMP in Windows, before starting SQL*Plus:
SP2-0310: unable to open file «apexins.sql «
tablespace_apex is the name of the tablespace for the Oracle Application Express application user.
tablespace_files is the name of the tablespace for the Oracle Application Express files user.
tablespace_temp is the name of the temporary tablespace or tablespace group.
When Application Express installs, it creates the following database accounts:
To learn more about the REST Administration Interface, see «About the REST Administration Interface» in Oracle Application Express Administration Guide
If you configured RESTful Web services, then these additional accounts will be created:
If you are upgrading from a previous release, then FLOWS_FILES already exists and APEX_PUBLIC_USER is created if it does not already exist.
«Configuring Password Protection» in Oracle Database Security Guide
Oracle Application Express must be installed from a writable directory on the file system. See «Reviewing a Log of an Installation Session»
5.2.2 Creating or Updating Your Instance Administration Account
Learn how to create or update Instance Administrator account.
This section describes how to create or update your Instance Administrator account.
Skip this section if you are upgrading from a previous release of Oracle Application Express. In an upgrade scenario, the Instance Administrator account and password is preserved and carried over from the prior release.
5.2.2.1 What Is an Instance Administrator?
Instance administrators are superusers that are responsible for managing an entire Oracle Application Express instance, including managing workspace provisioning, configuring features and instance settings, and managing security.
To perform these tasks, an Instance administrator signs in to the Oracle Application Express Administration Services application.
«Oracle Application Express Administration Services» in Oracle Application Express Administration Guide
5.2.2.2 About apxchpwd.sql
Running the apxchpwd.sql script enables you to create or update your Instance Administrator account.
You must run the apxchpwd.sql script in the following scenarios:
You do not need to run apxchpwd.sql when upgrading from a previous release of Oracle Application Express. In an upgrade scenario, the Instance Administrator account password is preserved and carried over from the prior release.
5.2.2.3 Running apxchpwd.sql
Run the apxchpwd.sql script to create and update your Instance Administrator account.
To create or update your Instance Administrator account:
Follow the on-screen instructions. You will be prompted provide a username, password, and email address. If the account username does not exist, it will be created for you.
5.2.3 Restarting Processes
Restart the processes that you stopped before you began the installation.
After you install Oracle Application Express, you must restart the processes that you stopped before you began the installation.
5.2.4 Configuring the APEX_PUBLIC_USER Account
It is important to correctly configure the APEX_PUBLIC_USER account to enable proper operation of Oracle Application Express.
5.2.4.1 About the APEX_PUBLIC_USER Account
The APEX_PUBLIC_USER account is created with a random password in a new installation of Oracle Application Express.
You must change the password for this account before configuring the database access descriptor (DAD) in a new installation.
5.2.4.2 Unlocking the APEX_PUBLIC_USER Account
Unlock the APEX_PUBLIC_USER account by running a SQL statement.
If you are upgrading from a prior release of Oracle Application Express, this step is unnecessary.
To unlock the APEX_PUBLIC_USER account:
5.2.4.3 Changing the Password for the APEX_PUBLIC_USER Account
Change the password for the APEX_PUBLIC_USER account by running a SQL statement.
If you are upgrading from a prior release of Oracle Application Express, this step is unnecessary.
To change the password for the APEX_PUBLIC_USER account:
5.2.4.4 About Password Expiration in Oracle Database 11 g and Later
You can set PASSWORD_LIFE_TIME parameter to unlimited by altering APEX_PUBLIC_USER to prevent password expiration. To do this create another profile in which the PASSWORD_LIFE_TIME parameter is set to unlimited and alter the APEX_PUBLIC_USER account and assign it to the new profile.
In the default profile in Oracle Database 11 g or later, the parameter PASSWORD_LIFE_TIME is set to 180. If you are using Oracle Database 11 g or later with Oracle Application Express, this causes the password for APEX_PUBLIC_USER to expire in 180 days. As a result, your Oracle Application Express instance will become unusable until you change the password.
Oracle Database Security Guide for information on creating profiles and assigning them to database users
5.2.5 Configuring RESTful Services
In a new installation of Oracle Application Express, you must run the configuration script apex_rest_config.sql to configure RESTful Services.
Once configured, the instance administrator can control the availability of the feature. If the instance administrator has disabled RESTful Services for this Application Express instance, RESTful Services are not available for this instance and the RESTful Services icon does not display.
To configure RESTful Services in Oracle Application Express:
When Prompted, enter a password for the APEX_LISTENER and APEX_REST_PUBLIC_USER accounts.
When configuring RESTful Services in Oracle Application Express, it creates two new database accounts.
«Enabling RESTful Services for an Instance» in Oracle Application Express Administration Guide
Установка Oracle APEX 20.1 на Database 18c Express Edition
В посте рассматривается краткий обзор среды разработки Oracle APEX и пошаговая инструкция ее установки на Oracle Database 18c Express Edition.
Краткий обзор среды разработки APEX.
Oracle Application Express (APEX) – это low-code платформа для разработки функциональных, масштабируемых и безопасных web-приложений. На сегодняшний день последней актуальной версией APEX является Oracle APEX 20.1. Данная версия выпущена в апреле 2020 года. Для установки и работы с APEX 20.1 в Oracle Database 18c Express Edition необходимо понимать принцип работы новой опции Oracle Database – Multitenant. Начиная с Oracle Database 12с поддерживается новая архитектура – Multitenant, которая предоставляет возможность использовать множество баз данных для консолидации их в составе единой и главной базы данных. Такое объединение упрощает задачи администрирования баз данных. Единая и главная база данных используется в качестве платформы и называется контейнерная база данных (Container Database – CDB), а база данных из множества работающих в составе контейнерной базы данных называется подключаемой базой данных (Pluggable Database – PDB). Архитектура Multitenat позволяет создать в Oracle Database 18с Express Edition одну CDB базу и до трех PDB баз. По умолчанию в Oracle Database 18с Express Edition APEX отсутствует. В связи с этим, для установки и работы с APEX необходимо подключиться к PDB и выполнять установку и настройку APEX. Ниже пошагово описывается процесс установки APEX 20.1 на Oracle Database 18c Express Edition, работающей под управлением операционной системы Oracle Linux. Данная операционная система установлена и работает в виртуальной машине. Нижеописанные шаги также будут работать с Oracle Database 18c Express Edition установленной на операционную систему Windows.
Для информации: Кроме установки и использования Oracle APEX на локальном компьютере, также есть возможность установить и использовать ее для разработки веб-приложений на бесплатном сервисе Always Free Service облака Oracle или же запросить и настроить свое рабочее пространство в бесплатном облачном сервисе apex.oracle.com. В данном посте рассматривается установка и доступ к среде разработки APEX на локальном компьютере.
Установка Oracle APEX 20.1.
Предполагается, что есть успешно установленная Oracle Database 18c Express Edition. При необходимости, можно установить Oracle Database 18c Express Edition используя следующие материалы: Установка Oracle Database 18c Express Edition на Linux и Установка Oracle Database 18c Express Edition на Windows. В посте подключение к PDB описываются различные способы подключения и работы в PDB.
Шаг 1. Установка APEX на Oracle Database 18c Express Edition.
Oracle APEX распространяется бесплатно и установочный файл можно скачать с официального сайта Oracle:
Для скачивания на портале Oracle необходимо наличие учетной записи с паролем. При ее отсутствии осуществляется регистрация новой учетной записи. Пройдя по ссылке, выбирается версия Oracle APEX 20.1 – All languages.
После ознакомления и принятия условий лицензирования необходимо поставить галочку в разделе I reviewed and accept the Oracle License Agreement. Запускается скачивание zip архива (apex_20.1.zip). Объем архива 160 Мб.
После завершения скачивания, архив apex_20.1.zip нужно скопировать в директорию /home/oracle/ операционной системы Oracle Linux, работающей в виртуальной машине. Выполняется разархивирование файла и проверка содержимого архива:
После разархивирования создалась папка apex с множеством sql скриптов для создания и настройки APEX. Необходимо из директории со скриптами (/home/oracle/apex/) подключиться к PDB XEPDB1 и начать установку APEX:
Подключение к XEPDB1 прошло успешно. Запускается скрипт apexins.sql для установки APEX со следующим синтаксисом:
@apexins.sql tablespace_apex tablespace_files tablespace_temp images
где, tablespace_apex – название табличного пространства для пользователя приложения APEX. tablespace_files – название табличного пространства для пользователя файлов APEX. tablespace_temp – название временного табличного пространства. images – виртуальная директория для изображений APEX. Для обеспечения корректного обновления APEX в будущем необходимо задать значение для этого параметра равное /i/.
Скрипт apexins.sql запускается со следующими значениями параметров:
Выше приводится последняя часть лога установки APEX, так как система генерирует очень много строк лога. Лог показывает, что установка прошла успешно и заняла 18 мин 14 секунд времени.
Шаг 2. Настройки и подключение к APEX.
После успешного завершения установки необходимо создать пользователя с административными правами в APEX и назначить ему пароль, настроить порт подключения к APEX и создать рабочее пространство для разработки приложений.
Для создания администратора и назначения ему пароля запускается скрипт apxchpwd.sql в PDB. Данный скрипт также может быть использован для сброса пароля существующему администратору APEX.
После запуска скрипта система предложит ввести пользовательское имя для администратора (login), его email и пароль. По умолчанию система предлагает ADMIN для пользовательского имени администратора (login). Если необходимо оставить пользователя по умолчанию, то поле Enter the administrator’s username следует оставить пустым и нажать Enter. В поле Enter ADMIN’s email [ADMIN] можно указать свою электронную почту. В поле Enter ADMIN’s password [] надо назначить пароль администратора, который будет удовлетворять следующим требованиям:
Иначе система выдаст следующую ошибку:
ORA-20001: Password validation failed.
ORA-06512: at line 30
ORA-06512: at «APEX_200100.WWV_FLOW_FND_USER_INT», line 3744
ORA-06512: at line 20
Запускается скрипт для создания администратора с именем ADMIN и назначения его email и пароля:
Пользователь успешно создан.
Для настройки встроенного PL/SQL-шлюза необходимо запустить скрипт apex_epg_config.sql со следующим синтаксисом:
директория-на-уровень-выше-директории-распакованного-архива – если после разархивирования архивного файла apex_20.1.zip папка apex со скрипты установки и настройки находятся в директории /home/oracle, то надо при запуске команды указать /home/oracle.
Далее назначается порт для подключения к APEX. Проверяется текущее значение порта. По умолчание значение порта равно 0.
В примере назначается порт 8080 для доступа и проверяется новое значение:
Новое значение порта для доступа к APEX успешно задано.
На последнем шаге разблокируется пользователь ANONYMOUS в контейнерной базе данных (CDB). Для этого выполняется выход из SQL*Plus PDB, подключение к CDB и разблокировка пользователя:
На этом завершается установка и настройки доступа к APEX. Можно подключиться к Oracle APEX 20.1 по следующим адресам:
http://localhost:8080/apex
http://localhost:8080/apex/apex_admin
Вместо localhost можно указать 127.0.0.1 или IP адрес хоста. В примере используется IP адрес хоста равный 192.168.0.1.
Запускается веб-браузер и выполняется переход к следующему адресу: http://192.168.0.1:8080/apex
После завершения установки автоматически создается рабочее пространство (Workspace) для выполнения административных задач в APEX. Название workspace – INTERNAL. Выполняется подключение к административному workspace под пользователем ADMIN и его паролем (данный пользователь и его пароль были созданы при запуске скрипта apxchpwd.sql (см. выше)).
После успешного входа система запросит создать новое рабочее пространство для разработки приложений:
На этапе Identify Schema надо будет указать название схемы (пользователя базы данных), к которой будет привязана новое рабочее пространство. Если в поле Re-use existing schema выбран No, то в поле Schema Name необходимо указать название нового пользователя/схемы, в Schema Password задать ему пароль, а в поле Space Quota (MB) назначить ему квоту на использование пространства в табличном пространстве. В примере для поля Re-use existing schema выбирается значение Yes и в Schema Name указывается тестовая и учебная схема/пользователь hr. Это даст возможность использовать связанные таблицы, представления, триггеры, данные и другие объекта схемы hr во время создания приложений в APEX:
Нажимается Next и выполняется переход на шаг создания пользователя с административными правами для нового создаваемого пространства – Dushanbe. Для нового пространства тоже создается пользователь с именем Admin. Также указывается пароль, имя и фамилия администратора, email нового создаваемого пространства для разработки приложений:
Нажимается Next и выполняется переход на следующий шаг – подтверждения настроек нового рабочего пространства:
После нажатия Create Workspace начнется создание рабочего пространства и при успешном завершении система выдаст следующее сообщение:
Это означает, что в APEX успешно создано новое рабочее пространство с именем Dushanbe. Нажатие кнопки Done позволит пользователю ADMIN получить доступ к своему рабочему пространству и начать работу:
Нажимается на Return to Sign in Page и на новой странице указываются данные для подключения к новому рабочему пространству (workspace) Dushanbe:
При первом входе администратору нового рабочего пространства (workspace) необходимо самостоятельно сменить пароль:
После успешной смены пароля администратор workspace Dushanbe получает доступ к среде:
Рабочее пространство Dushanbe готово для начала разработки веб-приложений.
Как установить oracle apex
Краткая инструкция как установить Application Express на отдельный сервер Oracle. Рассматривается простейший вариант установки в режиме embedded PL/SQL gateway.
Перед установкой
Загрузка последней версии Oracle Application Express
Загрузить архив APEX можно на сайте Oracle. На момент написания этой статьи последней версией являлся APEX 4.1.1, поэтому дальнейшее изложение пойдет исходя из этой версии.
Выбор варианта HTTP-сервера
Существует 3 варианта организации связи с сервером APEX.
Преимуществами данного варианта являются отсутствие необходимости отдельной установки и простота настройки. Т.к. данная архитектура двухуровневая, то нет возможности разделения самого сервера БД и прослушивателя, взаимодействующего с пользователем. Кроме того, шлюз не обладает таким широким набором настроек защиты и журналирования, как первые два варианта. Поэтому, не рекомендуется использование встроенного шлюза для обеспечения работы готового APEX-приложения в сети интернет.
Если же сервер будет использоваться для знакомства с APEX и локальной разработки приложений, то для упрощения установки целесообразно выбрать именно 3-й вариант встроенного PL/SQL шлюза.
Проверка переменных окружения
Если сервер БД Oracle уже настроен и функционирует, то переменные окружения скорее всего настроены должным образом. В любом случае стоит их проверить. Настройки должны быть подобны следующим:
Региональные настройки и кодировка (значение параметра NLS_LANG зависит от предпочтений – utf8, koi8-r или win1251):
Установка
В командной строке следует перейти в директорию apex и запустить sqlplus.
Т.к. сервер устанавливается для разработки, необходима полная установка среды разработки (Full development environment). Синтаксис команды установки имеет следующий общий вид:
В большинстве случаев для стандартной установки достаточно использовать вариант из примера без изменений.
Во время установки Oracle Application Express создается 3 новых пользователя БД:
Установка пароля для администратора APEX
Снова следует запустить sqlplus из той же директории apex.
Команда установки пароля для администратора apex:
При появлении вопроса, введите пароль для пользователя admin.
Настройки после установки
Теперь можно запустить все процессы, остановленные перед началом установки.
Настройка выбранного варианта HTTP-сервера – встроенного PL/SQL шлюза
Снова следует запустить sqlplus из той же директории apex.
Для настройки системных иконок необходимо запустить скрипт apex_epg_config.sql. В качестве параметра следует указать директорию, куда был распакован архив apex_4.1.1.zip. Важно! Не указывайте в пути саму директорию apex.
Далее необходимо разблокировать пользователя ANONYMOUS:
Активация сервера Oracle XML DB HTTP
Для использования этого сервера экземпляр Oracle должен быть сконфигурирован c XML DB. Если изначально это не было сделано, добавить XML DB можно с помощью Database Configuration Assistant (dbca).
Проверка порта, назначенного для XML DB HTTP
Проверка значения заданного порта:
Установка нового значения порта
Если значение порта равно 0, значит, сервер XML DB HTTP отключен. В этом случае, для активации сервера необходимо назначить порт, по которому будут выполняться обращения к серверу APEX (например, 8080).
Доступ к сетевым службам
Для использования в среде APEX различных сетевых служб, например, отправка и получение электронной почты средствами APEX, необходимо настроить политику доступа ACL.
На этом первая часть – установка сервера APEX закончена. Далее необходимо подготовить рабочие пространства, где будут создаваться приложения, и пользователей, которые будут работать с APEX.
Как установить oracle apex
Первым делом скачиваем необходимые архивы с официального сайта oracle:
Предполагается, что на сервере уже установлен Oracle Database, JDK и Weblogic. Во время написания этой статьи применялись следующие версии систем: Oracle Database 12c, Jdk1.8 и Weblogic 12c, в качестве сервера используется Windows Server 2008.
Создадим директорию «C:\oracle\apex» и «C:\oracle\apex\ords».
Содержимое архива apex_5.#.#.zip разархивируем в каталог «C:\oracle\apex», архив ords.3.0.#.###.##.##.zip разархивируем в каталог «C:\oracle\apex\ords».
Директория «C:\oracle\apex» в итоге будет выглядеть так:
Содержимое каталога «C:\oracle\apex\apex»:
Содержимое каталога «C:\oracle\apex\ords»:
Под правами администратора открываем командную строку.
Выполняем команду cd «C:\oracle\apex\apex»
Для подключения к oracle инициализируем переменную ORACLE_SID (в нашем примере SID=rtdm):
Запустим sqlplus командой:
Появится следующее окно:
Далее необходимо подключиться к пользователю с правами sysdba
conn sys/пароль_к_схеме@rtdm as sysdba
Теперь разберёмся с командой для установки apex объектов:
@apexins tablespace_apex tablespace_files tablespace_temp images
tablespace_apex – это табличное пространство которое будут использовать объекты БД apex
tablespace_files – табличное пространство для файлов apex
tablespace_temp – временное табличное пространство
images – имя виртуального каталога с картинками
В моем примере команда выглядит так:
@apexins.sql sysaux sysaux temp /i/
После выполнения команды выше, начнется создание apex объектов в oracle database, минут через 20 в консоли появится текст «PL/SQL procedure successfully completed.» это будет означать, что все объекты успешно созданы.
Теперь мы можем установить пароль администратора APEX, для этого подключаемся к sqlplus с правами sysdba и выполняем команду SQL>@apxchpwd.sql, далее нам предложат ввести логин администратора и пароль, см. рисунок ниже.
Далее выполняем команды:
SQL>ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;
Проверяем, чтобы у пользователей ‘APEX_REST_PUBLIC_USER’, ‘APEX_PUBLIC_USER’, ‘APEX_LISTENER’, ‘APEX_050000’, ‘FLOWS_FILES’ ACCOUNT_STATUS был OPEN:
select * from dba_users d where d.username in (‘APEX_REST_PUBLIC_USER’,’APEX_PUBLIC_USER’,’APEX_LISTENER’,’APEX_050000′,’FLOWS_FILES’)
В каталоге «C:\oracle\apex\ords» создадим папку с названием «config».
Запустим консоль под правами администратора и выполним команды
Зададим необходимые параметры и пароли, по завершению установки нам предложат запустить apex в standalone режиме, откажемся от этого, введем: 0 Enter.
После этого мы можем сделать deploying приложений i.war и ords.war в weblogic 12.
Открываем консоль домена для администрирования:
Переходим в раздел Deployments и устанавливаем приложения ords.war и i.war, которые находятся в директории «C:\oracle\apex\ords».
Открываем браузер и заходим по ссылке «http://localhost:7002/ords/», попадаем на страницу:
Вводим пароль администратора APEX, который мы задавали при выполнении скрипта @apxchpwd.sql и попадаем на главную страницу. УРА! УРА! УРА!
Другие статьи на тему APEX: