

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menyiapkan Oracle APEX dan Oracle Rest Data Services (ORDS)
<a name="Appendix.Oracle.Options.APEX.settingUp"></a>

Topik berikut mencantumkan langkah-langkah yang diperlukan untuk mengatur Oracle APEX dan ORDS

**Topics**
+ [

## Menambahkan opsi APEX dan APEX-DEV ke instans DB Anda
](#Appendix.Oracle.Options.APEX.Add)
+ [

## Membuka kunci akun pengguna publik pada instans DB Anda
](#Appendix.Oracle.Options.APEX.PublicUser)
+ [

## Mengkonfigurasi RESTful layanan untuk Oracle APEX
](#Appendix.Oracle.Options.APEX.ConfigureRESTful)
+ [

## Bersiap untuk menginstal ORDS pada host terpisah
](#Appendix.Oracle.Options.APEX.ORDS.ords-setup)
+ [

## Menyiapkan pendengar Oracle APEX
](#Appendix.Oracle.Options.APEX.Listener)

## Menambahkan opsi APEX dan APEX-DEV ke instans DB Anda
<a name="Appendix.Oracle.Options.APEX.Add"></a>

Untuk menambahkan `APEX-DEV` opsi `APEX` dan ke RDS Anda untuk instans Oracle DB, lakukan hal berikut: 

1. Buat grup opsi baru, atau salin atau ubah grup opsi yang ada.

1. Tambahkan opsi `APEX` dan `APEX-DEV` opsi ke grup opsi.

1. Kaitkan grup opsi dengan instans DB Anda.

Saat Anda menambahkan `APEX-DEV` opsi `APEX` dan, pemadaman singkat terjadi saat instans DB Anda dimulai ulang secara otomatis. 

**catatan**  
`APEX_MAIL` tersedia saat opsi `APEX` diinstal. Hak istimewa eksekusi untuk paket `APEX_MAIL` diberikan ke `PUBLIC` sehingga Anda tidak memerlukan akun administratif APEX untuk menggunakannya.

**Untuk menambahkan opsi APEX dan APEX-DEV ke instans DB**

1. Tentukan grup opsi yang ingin Anda gunakan. Anda dapat membuat grup opsi baru atau menggunakan grup opsi yang ada. Jika Anda ingin menggunakan grup opsi yang ada, lanjutkan ke langkah berikutnya. Jika tidak, buat grup opsi DB kustom dengan pengaturan berikut: 

   1. Untuk **Mesin**, pilih edisi Oracle yang ingin Anda gunakan. `APEX-DEV`Opsi `APEX` dan didukung pada semua edisi. 

   1. Untuk **Versi mesin utama**, pilih versi instans DB Anda. 

   Untuk informasi selengkapnya, lihat [Membuat grup opsi](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create). 

1. Tambahkan opsi ke grup opsi. Jika Anda hanya ingin menerapkan lingkungan runtime Oracle APEX, tambahkan hanya opsi. `APEX` Untuk menerapkan lingkungan pengembangan penuh, tambahkan `APEX-DEV` opsi `APEX` dan opsi.

   Untuk **Versi**, pilih versi Oracle APEX yang ingin Anda gunakan.
**penting**  
Jika Anda menambahkan `APEX-DEV` opsi `APEX` atau ke grup opsi yang ada yang sudah dilampirkan ke satu atau beberapa instans DB, pemadaman singkat terjadi. Selama penonaktifan ini, semua instans DB secara otomatis dimulai ulang. 

   Untuk informasi selengkapnya tentang cara menambahkan opsi, lihat [Menambahkan opsi ke grup opsi](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption). 

1. Terapkan grup opsi ke instans DB baru atau yang sudah ada: 
   + Untuk instans DB baru, Anda menerapkan grup opsi saat Anda meluncurkan instans. Untuk informasi selengkapnya, lihat [Membuat instans DB Amazon RDS](USER_CreateDBInstance.md). 
   + Untuk instans DB yang ada, Anda menerapkan grup opsi dengan memodifikasi instans dan melampirkan grup opsi baru. Saat Anda menambahkan `APEX-DEV` opsi `APEX` atau ke instans DB yang ada, pemadaman singkat terjadi saat instans DB Anda dimulai ulang secara otomatis. Untuk informasi selengkapnya, lihat [Memodifikasi instans DB Amazon RDS](Overview.DBInstance.Modifying.md). 

## Membuka kunci akun pengguna publik pada instans DB Anda
<a name="Appendix.Oracle.Options.APEX.PublicUser"></a>

Setelah Anda menginstal `APEX` atau `APEX-DEV` opsi instans DB Anda, pastikan untuk melakukan hal berikut:

1. Ubah kata sandi untuk `APEX_PUBLIC_USER` akun.

1. Buka kunci akun.

Anda dapat melakukannya dengan menggunakan utilitas baris perintah Oracle SQL\$1Plus. Hubungkan ke instans DB Anda sebagai pengguna master dan berikan perintah berikut. Ganti `new_password` dengan kata sandi pilihan Anda. 

```
1. ALTER USER APEX_PUBLIC_USER IDENTIFIED BY new_password;
2. ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;
```

## Mengkonfigurasi RESTful layanan untuk Oracle APEX
<a name="Appendix.Oracle.Options.APEX.ConfigureRESTful"></a>

Untuk mengonfigurasi RESTful layanan di Oracle APEX (tidak diperlukan untuk Oracle APEX 4.1.1.V1), gunakan SQL\$1Plus untuk terhubung ke instans DB Anda sebagai pengguna utama. Setelah Anda melakukan tindakan ini, jalankan prosedur tersimpan `rdsadmin.rdsadmin_run_apex_rest_config`. Ketika Anda menjalankan prosedur tersimpan, Anda memberikan kata sandi untuk pengguna berikut ini:
+ `APEX_LISTENER`
+ `APEX_REST_PUBLIC_USER`

Prosedur tersimpan menjalankan skrip `apex_rest_config.sql`, yang membuat akun basis data baru untuk pengguna ini.

**catatan**  
Konfigurasi tidak diperlukan untuk Oracle APEX versi 4.1.1.v1. Untuk versi Oracle APEX ini saja, Anda tidak perlu menjalankan prosedur tersimpan.

Perintah berikut menjalankan prosedur tersimpan.

```
1. EXEC rdsadmin.rdsadmin_run_apex_rest_config('apex_listener_password', 'apex_rest_public_user_password');
```

## Bersiap untuk menginstal ORDS pada host terpisah
<a name="Appendix.Oracle.Options.APEX.ORDS.ords-setup"></a>

Instal ORDS pada host terpisah seperti instans Amazon EC2, server lokal di perusahaan Anda, atau komputer desktop Anda. Contoh di bagian ini, asumsikan bahwa host Anda menjalankan Linux dan diberi nama`myapexhost.example.com`.

Sebelum Anda dapat menginstal ORDS, Anda perlu membuat pengguna OS yang tidak memiliki hak istimewa, dan kemudian mengunduh dan membuka zip file instalasi Oracle APEX.

**Untuk mempersiapkan instalasi ORDS**

1. Masuk ke`myapexhost.example.com` sebagai`root` . 

1. Buat pengguna OS non-hak istimewa untuk memiliki instalasi pendengar. Perintah berikut membuat pengguna baru bernama *apexuser*. 

   ```
   useradd -d /home/apexuser apexuser
   ```

   Perintah berikut memberikan kata sandi untuk pengguna baru. 

   ```
   passwd apexuser;
   ```

1. Masuk ke `myapexhost.example.com` as`apexuser`, dan unduh file instalasi Oracle APEX dari Oracle ke direktori Anda: `/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. Ekstrak file di direktori `/home/apexuser`.

   ```
   unzip apex_version.zip
   ```

   Setelah Anda mengekstrak file, ada direktori `apex` di direktori `/home/apexuser`.

1. [Saat Anda masih masuk `myapexhost.example.com` sebagai`apexuser`, unduh file Oracle REST Data Services dari Oracle ke `/home/apexuser` direktori Anda: http://www.oracle. com/technetwork/developer-tools/apex-listener/downloads/index.html](http://www.oracle.com/technetwork/developer-tools/apex-listener/downloads/index.html).

## Menyiapkan pendengar Oracle APEX
<a name="Appendix.Oracle.Options.APEX.Listener"></a>

**catatan**  
Pendengar Oracle APEX tidak digunakan lagi. 

Amazon RDS for Oracle terus mendukung Oracle APEX versi 4.1.1 dan Oracle APEX Listener versi 1.1.4. Sebaiknya gunakan versi terbaru Oracle APEX dan ORDS yang didukung.

Instal Pendengar Oracle APEX pada host terpisah seperti instans Amazon EC2, server on-premise di perusahaan, atau komputer desktop Anda. Kami berasumsi bahwa nama host Anda adalah `myapexhost.example.com`, dan bahwa host Anda menjalankan Linux.

### Bersiap untuk menginstal pendengar APEX Oracle
<a name="Appendix.Oracle.Options.APEX.Listener.preparing"></a>

Sebelum Anda dapat menginstal Oracle APEX Listener, Anda perlu membuat pengguna OS yang tidak memiliki hak istimewa, dan kemudian mengunduh dan membuka zip file instalasi Oracle APEX.

**Untuk mempersiapkan instalasi pendengar Oracle APEX**

1. Masuk ke `myapexhost.example.com` sebagai `root`. 

1. Buat pengguna OS non-hak istimewa untuk memiliki instalasi pendengar. Perintah berikut membuat pengguna baru bernama *apexuser*. 

   ```
   useradd -d /home/apexuser apexuser
   ```

   Perintah berikut memberikan kata sandi untuk pengguna baru. 

   ```
   passwd apexuser;
   ```

1. Masuk ke `myapexhost.example.com` as`apexuser`, dan unduh file instalasi Oracle APEX dari Oracle ke direktori Anda: `/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. Ekstrak file di direktori `/home/apexuser`.

   ```
   unzip apex_<version>.zip                
   ```

   Setelah Anda mengekstrak file, ada direktori `apex` di direktori `/home/apexuser`.

1. Saat Anda masih masuk ke `myapexhost.example.com` sebagai `apexuser`, unduh file Oracle APEX Listener dari Oracle ke direktori `/home/apexuser`.

#### Menginstal dan mengonfigurasi pendengar Oracle APEX
<a name="Appendix.Oracle.Options.APEX.Listener.installing"></a>

Sebelum Anda dapat menggunakan Oracle APEX, Anda perlu mengunduh `apex.war` file, menggunakan Java untuk menginstal Oracle APEX Listener, dan kemudian mulai pendengar.

**Untuk menginstal dan mengonfigurasi pendengar APEX Oracle**

1. Buat direktori baru berdasarkan Oracle APEX Listener dan buka file pendengar.

   Jalankan kode berikut:

   ```
   mkdir /home/apexuser/apexlistener
   cd /home/apexuser/apexlistener 
   unzip ../apex_listener.version.zip
   ```

1. Jalankan kode berikut.

   ```
   java -Dapex.home=./apex -Dapex.images=/home/apexuser/apex/images -Dapex.erase -jar ./apex.war
   ```

1. Masukkan informasi untuk program yang meminta hal berikut: 
   + Nama pengguna Administrator APEX Listener. Default-nya adalah *adminlistener*. 
   + Kata sandi untuk Administrator APEX Listener. 
   + Nama pengguna Pengelola APEX Listener. Default-nya adalah *managerlistener*. 
   + Kata sandi untuk Administrator APEX Listener. 

   Program mencetak URL yang Anda perlukan untuk menyelesaikan konfigurasi, sebagai berikut.

   ```
   INFO: Please complete configuration at: http://localhost:8080/apex/listenerConfigure
   Database is not yet configured
   ```

1. Biarkan Oracle APEX Listener berjalan sehingga Anda dapat menggunakan Oracle Application Express. Setelah Anda menyelesaikan prosedur konfigurasi ini, Anda dapat menjalankan pendengar di latar belakang. 

1. Dari browser web Anda, buka URL yang disediakan oleh program Oracle APEX Listener. Jendela administrasi Oracle Application Express Listener akan muncul. Masukkan informasi berikut: 
   + **Nama pengguna** – `APEX_PUBLIC_USER`
   + **Kata sandi** - kata sandi untuk *APEX\$1PUBLIC\$1USER*. Kata sandi ini adalah kata sandi yang Anda tentukan sebelumnya saat Anda mengonfigurasi repositori Oracle APEX. Untuk informasi selengkapnya, lihat [Membuka kunci akun pengguna publik pada instans DB Anda](#Appendix.Oracle.Options.APEX.PublicUser). 
   + **Tipe koneksi** - Basic 
   + **Nama host** - titik akhir instans DB Amazon RDS Anda, seperti `mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com`. 
   + **Port** - 1521
   + **SID** - nama basis data di instans DB Amazon RDS Anda, seperti `mydb`. 

1. Pilih **Terapkan**. Jendela administrasi Oracle APEX muncul. 

1. Tetapkan kata sandi untuk pengguna Oracle APEX`admin`. Untuk melakukannya, gunakan SQL\$1Plus untuk menghubungkan ke instans DB Anda sebagai pengguna master, lalu jalankan perintah berikut.

   ```
   1. EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
   2. grant APEX_ADMINISTRATOR_ROLE to master;
   3. @/home/apexuser/apex/apxchpwd.sql
   ```

   Ganti `master` dengan nama pengguna master Anda. Ketika diminta oleh skrip `apxchpwd.sql`, masukkan kata sandi `admin` yang baru. 

1. **Kembali ke jendela administrasi Oracle APEX di browser Anda dan pilih Administrasi.** Selanjutnya, pilih **Application Express Internal Administration**. Saat Anda diminta untuk memberikan kredensial, masukkan informasi berikut ini: 
   + **Nama pengguna** – `admin` 
   + **Kata sandi** - kata sandi yang Anda tetapkan menggunakan skrip `apxchpwd.sql` 

   Pilih **Masuk**, lalu tetapkan kata sandi baru untuk pengguna `admin`. 

Pendengar Anda sekarang siap digunakan.