Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Configurazione di Oracle APEX e Oracle Rest Data Services (ORDS)
L’argomento seguente elenca i passaggi necessari per configurare Oracle APEX e ORDS
**Topics**
+ [Aggiunta delle opzioni APEX e APEX-DEV all’istanza database](#Appendix.Oracle.Options.APEX.Add)
+ [Sblocco dell’account utente pubblico sull’istanza database](#Appendix.Oracle.Options.APEX.PublicUser)
+ [Configurazione dei RESTful servizi per Oracle APEX](#Appendix.Oracle.Options.APEX.ConfigureRESTful)
+ [Preparazione per installare ORDS su un host separato](#Appendix.Oracle.Options.APEX.ORDS.ords-setup)
+ [Impostazione del listener Oracle APEX](#Appendix.Oracle.Options.APEX.Listener)
## Aggiunta delle opzioni APEX e APEX-DEV all’istanza database
Per aggiungere le opzioni `APEX` e `APEX-DEV` a un’istanza database di RDS per Oracle, esegui le operazioni indicate di seguito:
1. Creare un nuovo gruppo di opzioni oppure copiare o modificare un gruppo di opzioni esistente.
1. Aggiungi le opzioni `APEX` e `APEX-DEV` al gruppo di opzioni.
1. Associa il gruppo di opzioni a questa istanza database.
Quando aggiungi le opzioni `APEX` e `APEX-DEV`, si verifica una breve interruzione mentre l’istanza database viene riavviata automaticamente.
**Nota**
`APEX_MAIL` è disponibile se l'opzione `APEX` è installata. Il privilegio di esecuzione per il pacchetto `APEX_MAIL` è concesso a `PUBLIC` e quindi non è necessario l'account amministrativo APEX per utilizzarlo.
**Per aggiungere le opzioni APEX e APEX-DEV a un’istanza database**
1. Determinare il gruppo di opzioni che si vuole usare. È possibile creare un nuovo gruppo di opzioni oppure usare un gruppo di opzioni esistente. Se si desidera usare un gruppo di opzioni esistente, puoi passare alla fase successiva. In caso contrario, creare un gruppo di opzioni database personalizzato con le seguenti impostazioni:
1. Per **Engine (Motore)**, scegliere l'edizione di Oracle da utilizzare. Le opzioni `APEX` e `APEX-DEV` sono supportate in tutte le edizioni.
1. In **Major engine version (Versione principale del motore)**, scegliere la versione dell'istanza database.
Per ulteriori informazioni, consulta [Creazione di un gruppo di opzioni](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create).
1. Aggiungere le opzioni al gruppo di opzioni. Per distribuire solo l’ambiente di runtime Oracle APEX aggiungi solo l’opzione `APEX`. Per distribuire l’ambiente di sviluppo completo, aggiungi entrambe le opzioni `APEX` e `APEX-DEV`.
In **Versione**, scegli la versione di Oracle APEX che desideri utilizzare.
**Importante**
Se aggiungi le opzioni `APEX` o `APEX-DEV` a un gruppo di opzioni esistente già associato a una o più istanze database, si verifica una breve interruzione. Durante questa interruzione, tutte le istanze database vengono riavviate automaticamente.
Per ulteriori informazioni sull'aggiunta di opzioni, consulta [Aggiunta di un'opzione a un gruppo di opzioni](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption).
1. Applicare il gruppo di opzioni a un'istanza database nuova o esistente:
+ Per una nuova istanza database, si applica il gruppo di opzioni quando viene avviata l'istanza. Per ulteriori informazioni, consulta [Creazione di un'istanza database Amazon RDS](USER_CreateDBInstance.md).
+ Per un'istanza database esistente, viene applicato il gruppo di opzioni modificando l'istanza e collegando il nuovo gruppo di opzioni. Quando aggiungi le opzioni `APEX` o `APEX-DEV` a un’istanza database esistente, si verifica una breve interruzione mentre l’istanza database viene riavviata automaticamente. Per ulteriori informazioni, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md).
## Sblocco dell’account utente pubblico sull’istanza database
Dopo aver installato le opzioni `APEX` o `APEX-DEV` sull’istanza database, assicurati di eseguire le operazioni indicate di seguito:
1. Modifica della password per l’account `APEX_PUBLIC_USER`.
1. Sbloccare l'account.
Per farlo, utilizza l'utilità a riga di comando Oracle SQL\$1Plus. Connettiti alla tua istanza database come utente master e utilizza i seguenti comandi. Sostituisci `new_password` con una password a tua scelta.
```
1. ALTER USER APEX_PUBLIC_USER IDENTIFIED BY new_password;
2. ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;
```
## Configurazione dei RESTful servizi per Oracle APEX
Per configurare RESTful i servizi in Oracle APEX (non necessari per Oracle APEX 4.1.1.v1), usa SQL\$1Plus per connetterti all'istanza DB come utente principale. Successivamente, esegui la stored procedure `rdsadmin.rdsadmin_run_apex_rest_config`. Quando esegui la stored procedure, fornisci le password per i seguenti utenti:
+ `APEX_LISTENER`
+ `APEX_REST_PUBLIC_USER`
La stored procedure esegue lo script `apex_rest_config.sql`, che crea nuovi account database per questi utenti.
**Nota**
Oracle APEX versione 4.1.1.v1 non necessita configurazione. Per questa versione di Oracle APEX non devi eseguire la procedura archiviata.
Il comando seguente avvia la procedura archiviata.
```
1. EXEC rdsadmin.rdsadmin_run_apex_rest_config('apex_listener_password', 'apex_rest_public_user_password');
```
## Preparazione per installare ORDS su un host separato
Installa ORDS in un host separato, come un’istanza Amazon EC2, un server on-premises nella tua azienda oppure il tuo computer desktop. Negli esempi riportati in questa sezione si suppone che l’host esegua Linux e sia denominato `myapexhost.example.com`.
Prima di poter installare ORDS, è necessario creare un utente del sistema operativo senza privilegi, quindi scaricare e decomprimere il file di installazione Oracle APEX.
**Per preparare l'installazione di ORDS**
1. Accedere a `myapexhost.example.com` come `root`.
1. Creare un utente del sistema operativo senza privilegi che possieda l'installazione del listener. Il comando seguente crea un nuovo utente denominato *apexuser*.
```
useradd -d /home/apexuser apexuser
```
Il seguente comando assegna una password al nuovo utente.
```
passwd apexuser;
```
1. Accedi a `myapexhost.example.com` come `apexuser` e scarica il file di installazione Oracle APEX da Oracle e salvalo nella directory `/home/apexuser`:
+ [http://www.oracle. com/technetwork/developer-tools/apex/downloads/index.html](http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html)
+ [Oracle Application Express Prior Release Archives](http://www.oracle.com/technetwork/developer-tools/apex/downloads/all-archives-099381.html)
1. Decomprimi il file nella directory `/home/apexuser`.
```
unzip apex_version.zip
```
Dopo aver decompresso il file, troverai una directory `apex` nella directory `/home/apexuser`.
1. [Mentre sei ancora connesso`apexuser`, scarica il file Oracle REST Data Services da Oracle `/home/apexuser` nella tua directory: http://www.oracle. `myapexhost.example.com` com/technetwork/developer-tools/apex-listener/downloads/index.html.](http://www.oracle.com/technetwork/developer-tools/apex-listener/downloads/index.html)
## Impostazione del listener Oracle APEX
**Nota**
Il listener Oracle APEX è obsoleto.
Amazon RDS per Oracle continua a supportare Oracle APEX versione 4.1.1 e Oracle APEX Listener versione 1.1.4. Si consiglia di utilizzare le versioni più recenti supportate di Oracle APEX e ORDS.
Installa Oracle APEX Listener in un host separato, come un'istanza Amazon EC2, un server locale nella tua azienda oppure il tuo computer desktop. Ipotizziamo che il nome del tuo host sia `myapexhost.example.com` e che esegua Linux.
### Preparazione all'installazione del listener Oracle APEX
Prima di installare il listener Oracle APEX, è necessario creare un utente del sistema operativo senza privilegi, quindi scaricare e decomprimere il file di installazione Oracle APEX.
**Per preparare l'installazione del listener Oracle APEX**
1. Accedere a `myapexhost.example.com` come `root`.
1. Creare un utente del sistema operativo senza privilegi che possieda l'installazione del listener. Il comando seguente crea un nuovo utente denominato *apexuser*.
```
useradd -d /home/apexuser apexuser
```
Il seguente comando assegna una password al nuovo utente.
```
passwd apexuser;
```
1. Accedi a `myapexhost.example.com` come `apexuser` e scarica il file di installazione Oracle APEX da Oracle e salvalo nella directory `/home/apexuser`:
+ [http://www.oracle. com/technetwork/developer-tools/apex/downloads/index.html](http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html)
+ [Oracle Application Express Prior Release Archives](http://www.oracle.com/technetwork/developer-tools/apex/downloads/all-archives-099381.html)
1. Decomprimi il file nella directory `/home/apexuser`.
```
unzip apex_.zip
```
Dopo aver decompresso il file, troverai una directory `apex` nella directory `/home/apexuser`.
1. Rimanendo collegato a `myapexhost.example.com` come `apexuser`, scarica il file di APEX Listener da Oracle e salvalo nella directory `/home/apexuser`:
#### Installazione e configurazione del listener Oracle APEX
Prima di poter utilizzare Oracle APEX, è necessario scaricare il file `apex.war`, utilizzare Java per installare il listener Oracle APEX e quindi avviare il listener.
**Per installare e configurare il listener Oracle APEX**
1. Creare una nuova directory basata sul listener Oracle APEX e aprire il file listener:
Eseguire il seguente codice:
```
mkdir /home/apexuser/apexlistener
cd /home/apexuser/apexlistener
unzip ../apex_listener.version.zip
```
1. Eseguire il seguente codice.
```
java -Dapex.home=./apex -Dapex.images=/home/apexuser/apex/images -Dapex.erase -jar ./apex.war
```
1. Il programma richiede le seguenti informazioni.
+ Nome dell'utente amministratore di APEX Listener. Il valore predefinito è *adminlistener*.
+ Una password per l'amministratore APEX Listener.
+ Nome dell'utente manager di APEX Listener. Il valore predefinito è *managerlistener*.
+ Una password per l'amministratore APEX Listener.
Il programma stampa un URL necessario per completare la configurazione nel modo seguente:
```
INFO: Please complete configuration at: http://localhost:8080/apex/listenerConfigure
Database is not yet configured
```
1. Lasciare il listener Oracle APEX in esecuzione in modo da poter utilizzare Oracle Application Express. Al termine della procedura di configurazione è possibile eseguire il listener in background.
1. Dal browser web, accedere all’URL fornito dal programma Oracle APEX Listener. Viene visualizzata la finestra di amministrazione di Oracle Application Express Listener. Immettere le seguenti informazioni:
+ **Username (Nome utente** – `APEX_PUBLIC_USER`
+ **Password** – La password per *APEX\$1PUBLIC\$1USER*. La password è una di quelle specificate in precedenza durante la configurazione del repository Oracle APEX. Per ulteriori informazioni, consulta [Sblocco dell’account utente pubblico sull’istanza database](#Appendix.Oracle.Options.APEX.PublicUser).
+ **Connection Type (Tipo di connessione)** – Basic (Di base)
+ **Hostname (Nome host)** – Endpoint dell'istanza database Amazon RDS, ad esempio `mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com`.
+ **Port (Porta** – 1521
+ **SID** – Nome del database nell'istanza database Amazon RDS, ad esempio `mydb`.
1. Scegliere **Apply (Applica)**. Viene visualizzata la finestra di amministrazione Oracle APEX.
1. Imposta una password per l’utente `admin` di Oracle APEX. Per farlo, utilizzare SQL\$1Plus per connettersi alla propria istanza database come utente master, quindi utilizzare i seguenti comandi:
```
1. EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
2. grant APEX_ADMINISTRATOR_ROLE to master;
3. @/home/apexuser/apex/apxchpwd.sql
```
Sostituire `master` con il proprio nome utente master. Quando lo script `apxchpwd.sql` lo richiede, inserire una nuova password `admin`.
1. Torna alla finestra di amministrazione Oracle APEX nel browser e scegli l’opzione **Administration**. Scegliere quindi **Application Express Internal Administration (Amministrazione interna Application Express)**. Quando vengono richieste le credenziali, inserire le seguenti informazioni:
+ **User name (Nome utente** – `admin`
+ **Password** – La password impostata usando lo script `apxchpwd.sql`
Scegliere **Login (Accedi)**, quindi impostare una nuova password per l'utente `admin`.
Il listener è ora pronto per essere utilizzato.