Skip to Main Content

 

Auswahl  

Installation der Oracle 23c FREE Edition auf Rocky Linux mit APEX 22.2 und ORDS 23.1 

Oracle
APEX
APEX 22.2:ORDS 23.1
30.04.23 (MP)
14.08.23(MP)
Rocky Linux, Oracle 23c, Free Edition, APEX Installation

Passende Schulungen zum Thema

Als vor zwei Wochen die Oracle Version 23c FREE Edition herauskam, waren wir sehr (positiv) überracht, dass die kostenlose Version vor der Produktiv Version veröffentlicht wurde.
Es wurde also mal wieder Zeit einen Artikel für die jeweils neusten Oracle Versionen zu schreiben. et voila …

Wir installieren auf einem Server mit der Ip Adresse 172.30.30.99. Sie können natürlich eine andere IP Adresse wählen, sollten dann aber an allen Stellen wo wir diese IP verwenden Ihre eintragen.
Da man ja seit Version Oracle 21c nun mit Pluggable Database Containern arbeiten muss, verwenden wir hier den Container apex222. Auch den können Sie natürlich umbenennen.

Wir empfehlen mit mindestens 2 SSH Sessions parallel zu arbeiten um die Zeit drastisch zu verkürzen.
Wir nennen im folgenden die beiden Sessions SES_1 und SES_2. Bitte lesen Sie die folgenden Schritte zuerst komplett durch
weil einige Punkte weiter unten zusammengefasst werden :-)

1. Redhat 8 / Centos 8 / Rocky 8 Preinstall Packages für Oracle 23c herunterladen:

https://yum.oracle.com/repo/OracleLinux/OL8/developer/x86_64/getPackage/oracle-database-preinstall-23c-1.0-0.5.el8.x86_64.rpm

2. FREE Edition herunterladen
https://download.oracle.com/otn-pub/otn_software/db-free/oracle-database-free-23c-1.0-1.el8.x86_64.rpm

3. Wir benennen den Pluggable Database Container um( muss man nicht, wenn man mit dem Namen freepdb1 zufrieden ist)

ALTER PLUGGABLE DATABASE freepdb1 CLOSE;
ALTER PLUGGABLE DATABASE freepdb1 OPEN RESTRICTED;
ALTER SESSION SET CONTAINER=freepdb1;
ALTER PLUGGABLE DATABASE RENAME GLOBAL_NAME TO apex222;


Laden Sie APEX 22.2 (oder neuer) herunter:
https://download.oracle.com/otn_software/apex/apex_22.2.zip

Laden Sie den neusten Patch für APEX herunter (dazu ist ein gültiger Support-Vertrag mit Oracle notwendig):
https://support.oracle.com/epmos/faces/PatchDetail?patchId=34628174

Laden Sie die ORDS-Version herunter (April 2023 war Version 23.1.1 aktuell):
https://download.oracle.com/otn_software/java/ords/ords-23.1.1.109.1003.zip

Laden Sie die neueste Apache TomCat 9 Version herunter. Version 10 wird aktuell (01.05.2023) nicht von ORDS unterstützt:
https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.74/bin/apache-tomcat-9.0.74.zip

Session SES_1
dnf -y install wget
dnf -y update

Download Skript für alle Dateien (bis auf Patch, da müssen Sie beim Support angemeldet sein) in SES_2:

mkdir -p /tmp/oracle
cd /tmp/oracle
wget https://yum.oracle.com/repo/OracleLinux/OL8/developer/x86_64/getPackage/oracle-database-preinstall-23c-1.0-0.5.el8.x86_64.rpm
wget https://download.oracle.com/otn-pub/otn_software/db-free/oracle-database-free-23c-1.0-1.el8.x86_64.rpm
wget https://download.oracle.com/java/17/latest/jdk-17_linux-x64_bin.rpm
wget https://download.oracle.com/otn_software/apex/apex_22.2.zip
wget https://download.oracle.com/otn_software/java/ords/ords-23.1.1.109.1003.zip
wget https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.74/bin/apache-tomcat-9.0.74.zip

 

Nun kann mit der Installation der in SES_2 heruntergeladenen Programme begonnen werden

Session SES_1:

dnf -y install oracle-database-preinstall-23c*
dnf -y localinstall oracle-database-free-23c*
export DB_PASSWORD=mein_password_fuer_2023
(echo "${DB_PASSWORD}"; echo "${DB_PASSWORD}";) | /etc/init.d/oracle-free-23c configure

In der Datei /etc/oratab die Datenbank auf Autostart (N durch Y in der letzten Zeile am Ende ersetzen)

FREE:/opt/oracle/product/23c/dbhomeFree:Y

Wenn die Oracle Datenbank Instanz und der Oracle Listener beim Start des Betriebssystem mitstarten sollen:

systemctl enable oracle-free-23c

Wenn Oracle DB + Listener manuell gestoppt und gestartet werden sollen:

systemctl stop oracle-free-23c
systemctl start oracle-free-23c

Wenn Ihnen der Name oracle-free-23 zulange ist, können Sie auch stattdessen “oracle”als Servicename einrichten

Kopieren Sie dazu nur die Datei /etc/rc.d/init.d/oracle-free-23c in die Datei oracle um:

cp /etc/rc.d/init.d/oracle-free-23c /etc/rc.d/init.d/oracle

... dauert wieder ein paar Minuten .. wir wechseln in SES_2

Session SES_2:

mkdir -p /opt/tomcat
mv apache-tomcat-9.0.74.zip /opt/tomcat/
cd /opt/tomcat
unzip apache*
ln -s apache-tomcat-9.* latest
useradd -r tomcat --shell /bin/false
chown -R tomcat /opt/tomcat
chmod +x /opt/tomcat/latest/bin/*.sh
# Passen Sie die Firewall an Ihre Bedürfnisse an. Hier werden in Zone Public einige Ports freigegeben
firewall-cmd --zone=public --permanent --add-port=1521/tcp
firewall-cmd --zone=public --permanent --add-service=https
firewall-cmd --zone=public --permanent --add-service=http
firewall-cmd --zone=public --permanent --add-port 8080/tcp
firewall-cmd --reload

dnf -y localinstall jdk-17*
java -version
which java

Datei anlegen zum Autostart von TomCat
vi /etc/systemd/system/tomcat.service

[Unit]
Description=Tomcat 9 servlet container
After=network.target
[Service]
Type=forking
User=tomcat
Group=tomcat
Environment="JAVA_HOME=/usr"
Environment="JAVA_OPTS=-Djava.security.egd=file:///dev/urandom -Dconfig.url=/opt/oracle/ords"
Environment="CATALINA_BASE=/opt/tomcat/latest"
Environment="CATALINA_HOME=/opt/tomcat/latest"
Environment="CATALINA_PID=/opt/tomcat/latest/temp/tomcat.pid"
Environment="CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC"
ExecStart=/opt/tomcat/latest/bin/startup.sh
ExecStop=/opt/tomcat/latest/bin/shutdown.sh
[Install]
WantedBy=multi-user.target

Tomcat als Autostart einrichten

systemctl daemon-reload
systemctl enable tomcat
systemctl start tomcat
systemctl status tomcat

 

Bash Profile für Oracle Benutzer anlegen:

cat << EOF > /home/oracle/.bash_profile
export TERM=vt220
export EDITOR=vi
export PS1="[\u@\h:\w]>"
export DISPLAY=:0.0
export ORACLE_BASE=/opt/oracle
export ORACLE_HOME=\$ORACLE_BASE/product/23c/dbhomeFree
export ORACLE_SID=FREE
export ORACLE_INSTANCE=free
export ORACLE_TERM=vt220
export ORA_NLS10=\$ORACLE_HOME/nls/data
export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:\$ORACLE_HOME/lib
export NLS_LANG=GERMAN_GERMANY.WE8MSWIN1252
export PATH=\$ORACLE_HOME/bin:\$PATH:/usr/sbin:/usr/ccs/bin

alias cdo="cd \$ORACLE_HOME; pwd"
alias cdd="cd \$ORACLE_BASE/oradata"
alias cda="cd \$ORACLE_BASE/diag/rdbms/\$ORACLE_INSTANCE/\$ORACLE_SID/trace; pwd"
alias cdn="cd \$ORACLE_HOME/network/admin; pwd"
alias cde="cd \$ORACLE_BASE/admin/\$ORACLE_SID/dpdump"
alias sp="\$ORACLE_HOME/bin/sqlplus '/ as sysdba'"
alias l="ls -l"
alias ll="ls -la"
alias ipconfig="/sbin/ifconfig | grep Bcast"
echo Folgende Einstellungen wurden gesetzt:
env | grep ORA
ps aux | grep [t]omcat | awk '{print "Tomcat-Prozess:" \$2}'
ps aux | grep [d]b_pmon | awk '{print "Oracle-Prozess:" \$2}'
ps aux | grep [t]ns | awk '{print "Listener-Prozess:" \$2}'
EOF
. .bash_profile

APEX und ORDS auspacken:

cd /tmp/oracle
unzip apex_22*
chown -R oracle:oinstall apex*
mkdir ords
unzip ords-2*.zip -d ords

Session SES_1

APEX muss in der anderen Session bereits ausgepackt worden sein!

su - oracle

 

REM Bei uns wurde bei der Installation ein exotischer Port für den Listener benutzt. 
Wenn Sie den Oracle Standard-Port 1521 wieder möchten, ersetzen Sie ihn in der Datei listener.ora

lsnrctl stop
IP=$(hostname -I)

 

cat << EOF >$ORACLE_HOME/network/admin/listener.ora
# listener.ora Network Configuration File: /opt/oracle/product/23c/dbhomeFree/network/admin/listener.ora
# Generated by Oracle configuration tools.
DEFAULT_SERVICE_LISTENER = FREE
LISTENER =
 (DESCRIPTION_LIST =
   (DESCRIPTION =
     (ADDRESS = (PROTOCOL = TCP)(HOST = \$IP)(PORT = 1521))
   )
 )
EOF

Nun wird APEX installiert. Hier können verschiedene Passwörter für die Oracle APEX Benutzer gesetzt werden. Wir haben aber bis auf den Internal Workspace Admin Benutzer
das gleiche Passwort gesetzt.

Auch kann ein eigener Tablespace für die Installation verwendet werden. Wir haben hier APEX jedoch in den Tablespace SYSAUX installiert.

lsnrctl start
cd /tmp/oracle/apex
cat << EOF >preinstall.sql
alter system set local_listener='(ADDRESS = (PROTOCOL = TCP)(HOST = \$IP)(PORT = 1521))';
alter system register;
host lsnrctl status
define pwd_apx=apex
define pwd_ws_int=Apex2023#
@apxsilentins.sql SYSAUX SYSAUX TEMP /i222/ &pwd_apx. &pwd_apx. &pwd_apx. &pwd_ws_int.
EOF
sqlplus sys/sys@172.30.30.99/apex222 as sysdba
@preinstall.sql

Während die APEX Installation läuft, kann wieder in die andere Session gewechselt werden, dort installieren wir den ORDS…

cd /tmp/oracle/ords
bin/ords --config /opt/oracle install
[2] Datenbankpool erstellen oder aktualisieren ...
[1] Basis (Hostname, Port, Servicename)
=> 172.30.30.99
=> 1521
=> apex222
=> sys
=> <Ihr sys-pwd>
=> SYSAUX
=> TEMP
[1] Datenbankaktionen (aktiviert alle Features)
[2] Überspringen

Nun kopieren wir den ORDS in den TomCat Ordner:

cp ords.war /opt/tomcat/latest/webapps/

Dateien von APEX auch in den TomCat Ordner verschieben:

mv /tmp/oracle/apex/images/ /opt/tomcat/latest/webapps/i222

So, das war´s. gar nicht so schwer, oder ? :-)

Wenn man mit zwei Sessions arbeitet und in keine Probleme läuft, sollte das in ca. einer Stunde erledigt sein.

Bonus-Track:

Apache TomCat hat leider keine Redirect Funktion, dazu braucht man den Apache Webserver. Aber Sie können mit einem kleinen Trick dafür sorgen, dass Sie gleich auf Ihre Lieblingsapp weitergeleitet werden, sobald Sie die folgende URL eingeben:

http://172.30.30.99:8080

Wir machen dazu einfach einen Refresh als Meta-Tag auf die Datei index.html

cp /opt/tomcat/latest/webapps/ROOT/index.html /opt/tomcat/latest/webapps/ROOT/index.html.old
echo '<html><head><meta http-equiv="refresh" content="0; url=http://172.30.30.99:8080/ords/f?p=100" /></head></html>'>/opt/tomcat/latest/webapps/ROOT/index.html

oder wenn Sie TEST-Maschine haben und kein Problem damit haben, dass Ihr Password im Klartext in einer Datei steht…. können Sie die Anmeldedaten für den Applikation Builder bereits eintragen

echo '<html><head><meta http-equiv="refresh" content="0; url=http://172.30.30.100:8080/ords/f?p=4550:1:1::::F4550_P1_COMPANY,F4550_P1_USERNAME,F4550_P1_PASSWORD:schulung,admin,ganzschöngeheim2023" /></head></html>'>/opt/tomcat/latest/webapps/ROOT/index.html

Hier sind eingetragen:

Workspace-Name (F4550_P1_COMPANY) = schulung
Username (F4550_P1_USERNAME) = admin
Password: (F4550_P1_PASSWORD) = ganzschöngeheim2023

Das sollte natürlich von Ihnen angepasst werden :-)

Rufen Sie nun im Browser die Seite http://172.30.30.99:8080/ords auf bzw. wenn der Bonustrack installiert wurde: http://172.30.30.99:8080

Bonus-Bonus-Track:

Unter Windows können Sie auch gleich eine Portweiterleitung einrichten, dann wird Port 80 auf Port 8080 weitergeleitet. Dies geschieht (als Administrator) mit:

netsh interface portproxy add v4tov4 listenaddress=172.30.30.99 listenport=80 connectaddress=172.30.30.99 connectport=8080

Dann lautet der Aufruf nur noch:

http://172.30.30.99

und dann besuchen Sie uns doch bald mal in einer von unseren 48 verschiedenen Oracle Schulungen in München-Unterhaching :-)