Als vor zwei Wochen die Oracle Version 23ai 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 23ai herunterladen:
wget https://yum.oracle.com/repo/OracleLinux/OL8/appstream/x86_64/getPackage/oracle-database-preinstall-23ai-1.0-2.el8.x86_64.rpm
2. FREE Edition herunterladen
wget https://download.oracle.com/otn-pub/otn_software/db-free/oracle-database-free-23ai-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 23.2 (oder neuer) herunter:
https://download.oracle.com/otn_software/apex/apex_23.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.2024) nicht von ORDS unterstützt:
https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.93/bin/apache-tomcat-9.0.93.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-23ai-1.0-0.5.el8.x86_64.rpm
wget https://download.oracle.com/otn-pub/otn_software/db-free/oracle-database-free-23ai-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_23.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.89.zip
Nun kann mit der Installation der in SES_2 heruntergeladenen Programme begonnen werden
Session SES_1:
dnf -y install oracle-database-preinstall-23ai*
dnf -y localinstall oracle-database-free-23ai*
export DB_PASSWORD=mein_password_fuer_2023
(echo "${DB_PASSWORD}"; echo "${DB_PASSWORD}";) | /etc/init.d/oracle-free-23ai configure
In der Datei /etc/oratab die Datenbank auf Autostart (N durch Y in der letzten Zeile am Ende ersetzen)
FREE:/opt/oracle/product/23ai/dbhomeFree:Y
Wenn die Oracle Datenbank Instanz und der Oracle Listener beim Start des Betriebssystem mitstarten sollen:
systemctl enable oracle-free-23ai
Wenn Oracle DB + Listener manuell gestoppt und gestartet werden sollen:
systemctl stop oracle-free-23ai
systemctl start oracle-free-23ai
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-23ai in die Datei oracle um:
cp /etc/rc.d/init.d/oracle-free-23ai /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.89.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/23ai/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/23ai/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:http://172.30.30.99:8080/ords
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 :-)