Ci dispiace, ma questo articolo è disponibile solo in Inglese Americano. Per ragioni di convenienza del visitatore, il contenuto è mostrato sotto nella lingua alternativa. Puoi cliccare sul link per cambiare la lingua attiva.
Quante volte abbiamo dovuto affrontare l'ardua configurazione di un'istanza di Oracle Database per il nostro ambiente di sviluppo e lo "sputare sangue"?
Immagino che questi tempi siano stati troppi, ecco un buon motivo per iniziare a utilizzare ciò che Oracle mette a disposizione di noi sviluppatori, ovvero le VM per sviluppatori pre-costruite per Oracle VM VirtualBox .
Nel corso di questo articolo vedremo come configurare una VM Oracle Database 19c dal Database Virtual Box Appliance fornito da Oracle.
1. Requisiti
Prima di iniziare, è necessario verificare che siano soddisfatti i seguenti requisiti.
- Sistema operativo che supporta Virtual Box versione 6.x
- Almeno 2 GB di RAM
- Almeno 15 GB di spazio di archiviazione
- Almeno processo a 2 GHz
- Privilegi di amministratore
L'Appliance Virtuale di riferimento è datata 20/06/2019 il cui contenuto è indicato di seguito.
- Oracle Linux 7
- Database Oracle 19.3
- Sviluppatore Oracle SQL 19.1
- Oracle Application Express 19.1
- Hands-On-Labs (accessibile tramite il menu della barra degli strumenti in Firefox)
- Oracle REST Data Services 19.1
- Oracle SQL Developer Data Modeler 19.1
- DB XML Oracle
Attenzione! Questa appliance virtuale può essere utilizzata solo in ambienti di sviluppo/test, non deve essere utilizzata in un ambiente di pre-produzione o produzione.
2. Configurazione dell'appliance virtuale
La procedura di configurazione consiste in alcuni passaggi riepilogati di seguito:
- Scarica e installa Oracle VM VirtualBox
- Download di Oracle DB Developer VM
- Importazione dell'appliance virtuale su Oracle VM VirtualBox
- Avvio e test dell'appliance virtuale
2.1 Scarica e installa Oracle VM VirtualBox
Dalla home page di Oracle VM VirtualBox, puoi scaricare i binari per il tuo sistema operativo. Nel mio caso, ho provveduto a scaricare la versione per macOS.
La procedura di installazione è molto semplice e non è oggetto di questo articolo; in caso di difficoltà o ulteriori informazioni, fare riferimento al Manuale Utente. La versione di riferimento per questo articolo è 6.1.30. La figura 1 mostra informazioni dettagliate sulla versione installata sul mio MacBook Pro con macOS Monterey (versione 12.1).
Figura 1 – Informazioni su VirtualBox
2.2 Download della VM Oracle DB Developer
Dal link Oracle DB Developer VM è possibile accedere a DeveloperDaysVM2019-05-31_20.ova file che contiene l'appliance virtuale. Il formato OVA/OVF è uno standard per il confezionamento e la distribuzione di Virtual Appliance.
Il download del file richiede la disponibilità di un account Oracle (che puoi creare gratuitamente se necessario). La dimensione del file è superiore a 7 GByte, quindi consiglio di controllare il checksum del file al termine del download. Nella Console 1, uno dei modi per la verifica dell'hash utilizzando md5 e sha viene identificato il comando disponibile su macOS, Unix/Linux e Windows 10.
- MD5 (somma):20b5a5bd91cfe9d4f5acf5128f06146e
- SHA1:e0b9f8af8158664139b9ca970c3500752fc15fd2
# Verify the checksum MD5 and SHA1 on macOS
$ md5 DeveloperDaysVM2019-05-31_20.ova
$ shasum DeveloperDaysVM2019-05-31_20.ova
# Verify the checksum MD5 and SHA1 on Unix/Linux
$ md5sum DeveloperDaysVM2019-05-31_20.ova
$ sha1sum DeveloperDaysVM2019-05-31_20.ova
# Verify the checksum MD5 and SHA1 on Windows 10
> certutil -hashfile DeveloperDaysVM2019-05-31_20.ova MD5
> certutil -hashfile DeveloperDaysVM2019-05-31_20.ova SHA1
2.3 Importazione dell'appliance virtuale su Oracle VM VirtualBox
Una volta ottenuto il file ova, è possibile procedere all'importazione utilizzando la funzione Import Appliance (o Import Virtual Application) di Oracle VM VirtualBox a cui possiamo accedere dal menu File (vedi Figura 2).
Figura 2 – Accesso alla funzione Import Appliance (o Import Virtual Application)
Dopo aver cliccato sulla voce di menu sopra indicata, dovresti vedere una finestra di dialogo come quella mostrata in Figura 3. L'unica informazione da specificare è la posizione del file OVA, dopodiché sarà possibile continuare cliccando sul Continua pulsante.
Figura 3 – Primo passaggio di importazione dell'appliance virtuale:specificare la posizione del file OVA
Dopo aver cliccato su Continua si aprirà una finestra di dialogo successiva che mostra le informazioni dettagliate (come CPU, RAM, età.) dell'appliance virtuale (vedere la Figura 4). È possibile modificare alcune impostazioni, ma consiglio di lasciare quelle proposte; quindi continua facendo clic su Importa pulsante.
Figura 4 – Secondo passaggio dell'importazione di Virtual Appliance:riepilogo delle informazioni dettagliate del VA e avvio dell'importazione
La figura 5 mostra lo stato di avanzamento del processo di importazione. La durata dell'importazione dipende dalla propria forza e dalla disponibilità di risorse al momento dell'importazione. Nel mio caso, il processo di importazione ha richiesto circa 2 minuti.
Figura 5 – Processo di importazione dell'appliance virtuale
Una volta terminato il processo di importazione, dovresti avere una situazione come quella mostrata nella Figura 6, ovvero una nuova Macchina virtuale chiamato Oracle DB Developer VM.
Figura 6 – Macchina virtuale VM Oracle DB Developer importata
Prima di poter avviare la macchina virtuale, devi:
- Controlla e/o crea una nuova rete host. Ciò consentirà di accedere ai servizi di database Oracle anche dalla rete dell'host, ovvero dal nostro PC
- Aggiungi una nuova scheda di rete alla macchina virtuale e configurala per utilizzare la rete dell'host
Per il primo passaggio, accedi alla finestra Host Network Manager da __File -> Host Network Manager menu e dovresti vedere cosa è mostrato nella Figura 7.
Figura 7 – Gestore rete host
In questo caso non è presente l'interfaccia di rete host, bisogna quindi procedere con la creazione, passaggio che si può fare cliccando sul pulsante che mostra il Crea etichetta.
Se sono già presenti una o più configurazioni di rete host, sarebbe possibile utilizzarne una di quelle disponibili.
La figura 8 mostra la nuova rete host (vboxnet0) appena creata e le caratteristiche di base. Dopo la creazione della rete, dobbiamo attivare il server DHCP opzione, lasciando le impostazioni predefinite. Questa rete sarà quella che poi specificheremo sulla configurazione della nuova scheda di rete della macchina virtuale appena importata.
*Importante! * Dopo aver impostato il flag per abilitare il server DHCP, dobbiamo chiudere e riaprire Oracle VM VirtualBox, questo per far partire correttamente il server DHCP.
Figura 8 – Nuova rete host 192.168.56.1/24 con DHCP attivo
Per il secondo passaggio è necessario aggiungere una seconda scheda di rete dalle impostazioni di rete della VM impostando il tipo (“Connesso a”) a scheda solo host, specificando in questo caso il nome della rete host creata nel passaggio precedente.
La Figura 9 mostra la configurazione della nuova scheda di rete configurata per essere connessa alla rete host (vboxnet0), mentre la Figura 10 il riepilogo delle impostazioni della VM dopo aver configurato la nuova scheda di rete.
Figura 9 – Configurazione della seconda scheda di rete connessa alla rete host
Figura 10 – Scheda di rete aggiuntiva visibile anche nel riepilogo VM
2.4 Avvio e test dell'appliance virtuale
Una volta completata la fase di importazione e modifica delle impostazioni di rete, è possibile procedere all'avvio della macchina virtuale tramite il “pulsante verde” di avvio. La figura 11 mostra il Grub menu di avvio che evidenzia Oracle Linux sistema operativo, che verrà avviato di default (senza alcuna azione da parte nostra).
Figura 11 – Avvio della VM. Menu di avvio di Grub del sistema operativo Oracle Linux
Dopo alcuni minuti, che possono variare molto a seconda delle tue risorse hardware, dovresti trovarti davanti al desktop GNOME come mostrato in Figura 12 (anche se la disposizione degli oggetti sul desktop potrebbe essere diversa).
Figura 12 – Desktop GNOME dopo l'avvio della VM
La Figura 12 evidenzia alcuni dati importanti che saranno necessari per connettersi al database e alla macchina Oracle tramite SSH. Di seguito riporto questi parametri.
- Nome utente/Password:oracle/oracle (anche utente sudo)
- SID Oracle:orclcdb
- DB collegabile:orcl
A questo punto, dobbiamo verificare che:
- i servizi di database Oracle in particolare sono in ascolto;
- la connessione al database tramite SQL*Plus funziona correttamente;
- la VM è in grado di comunicare con la rete pubblica (internet);
- la nuova scheda di rete viene vista correttamente dal sistema operativo Oracle Linux e configurala tramite DHCP.
La console 2 mostra i comandi necessari per ottenere le informazioni di cui sopra.
# Verify that the SQLNet service is listening on standard TCP / IP port 1521
$ netstat -ltnp
# Verification of connection to the Oracle database via SQL*Plus with the user who has the SYSDBA role
$ sqlplus sys/oracle as sysdba
# Check connectivity to the public network (internet)
$ ping www.google.it
# Verify the configuration of the network card connected to the host network created earlier
$ ifconfig
# Configuration of the eth1 network card (see output of
# ifconfig command) to get the IP address from the server
# DHCP.
$ sudo dhclient eth1
Le figure 13, 14 e 15 illustrano nell'ordine indicato nella Console 2 l'uscita dei comandi impartiti direttamente sulla macchina. Dalla Figura 13 è possibile notare che il servizio SQLNet è correttamente in LISTEN sulla porta TCP/IP 1521 (tutte le interfacce 0.0.0.0).
Figura 13 – Verifica che il servizio SQLNet di Oracle sia attivo sulla porta TCP/IP 1521
Dalla Figura 14 è possibile notare come la connessione al database Oracle tramite SQL*Plus avvenga in modo corretto mostrando il banner con le informazioni dettagliate sull'istanza Oracle.
Figura 14 – Test di connessione al servizio SQLNet tramite SQLPlus come utente con ruolo di SYSDBA
Sul desktop (vedi Figura 12) è presente un collegamento a SQL Developer strumento che potresti utilizzare come interfaccia per il database Oracle. Lo strumento è già configurato con una connessione al database come utente SYSDBA. La versione di SQL Developer installata sulla VM è piuttosto vecchia, 19.1.
La figura 15 mostra la corretta configurazione della scheda di rete, che ha acquisito l'indirizzo IP 192.168.56.5 dal server DHCP.
Per rendere permanente l'attivazione della scheda di rete tramite DHCP, è possibile agire sul Connetti automaticamente flag e quindi su Applica sul dettaglio di configurazione della scheda di rete accessibile tramite il Gestione rete (vedi figure sotto).
Figura 15 – Verifica della corretta configurazione della scheda di rete configurata per l'utilizzo della rete host
Figura 16 – Accesso alla configurazione delle schede di rete
Figura 17 – Elenco delle schede di rete presenti nel sistema
Figura 18 – Attivazione permanente della nuova scheda di rete eth1 connessa alla rete host
3. Collegarsi al database dalla macchina host
Una volta terminato il setup della Oracle Database VM, possiamo interagire con i suoi servizi direttamente dalla nostra macchina host, grazie al fatto che siamo in grado di raggiungere il servizio SQLNet e SSH.
# Connect to VM via SSH
# The specified IP address is the one obtained from the command
# ifconfig run on the VM. Address assigned by the server
# Host network DHCP. Remember that the default password
# of the oracle user is oracle
$ ssh [email protected]
Per stabilire la connessione al database, sei ovviamente libero di utilizzare qualsiasi client SQL che supporti Oracle. Preferisco stare attorno a Oracle e per questo consiglio di installare e utilizzare SQL Developer la cui ultima versione è la 21.41.
Una volta installato e avviato SQL Developer, possiamo aggiungere la connessione al database utilizzando i seguenti parametri.
- Nome utente:sys
- Password:oracolo
- Ruolo:SYSDBA
- Nome host:192.168.56.5 (indirizzo IP della tua VM che potrebbe essere diverso da quello indicato qui e in Figura 19)
- Nome servizio:orcl
Le Figure 19 e 20 mostrano la configurazione della connessione al database e l'esecuzione della query.
Figura 19 – Configurazione della connessione dal database Oracle
Figura 20 – Esempio di esecuzione di una query sul database Oracle
A questo punto, abbiamo la nostra VM di sviluppo Oracle che possiamo utilizzare per ospitare i database dei progetti su cui lavoriamo.
4. Risorse utili
- Come configurare il contenitore Docker Oracle Database 19c per l'ambiente di sviluppo Liferay
- Come creare un'immagine Docker Liferay 7.2 con il supporto di Oracle Database
- Giornata degli sviluppatori:sviluppo pratico di applicazioni di database
- Download di SQL Developer 21.4.1
- Immagini Docker da Oracle
L'articolo (Inglese) Come utilizzare Oracle Database 19c Pre-Built Developer VM sembra essere il primo sul blog di Antonio Musarra.
