Merge branch 'main' into GCP-IC

Author: Ej4z4K

app-dev/devops-and-containers/functions/java-helloworld-AI-with-local-dev-and-oci-functions/README.md

@@ -63,16 +63,25 @@ IAM user option will work on both cases above, as local and as OCI Function.
 
 <p>
 
-Testing with curl (or pasting the APi Gateway url to a browser):
+Testing with curl (or copy-pasting the API Gateway deployment url to a browser):
 
 <p>
 
 <pre>
 curl https://n3yu.....ghhi.apigateway.eu-frankfurt-1.oci.customer-oci.com/
-What happened today 05/31/2024 100 years ago ?
+What happened today 06/13/2024 100 years ago ?
 
-May 31, 2024 is May 31, 1924. Here are some events that occurred on this date:
-...
+June 13, 2024 is June 13, 1924. Here are some events that occurred on this date:
+
+1. The German airline Deutsche Lufthansa (DL) was officially founded on June 13, 1924. It is Germany's largest airline and is one of the world's largest airlines in terms of overall passengers carried.
+ 
+2. The British Broadcasting Corporation (BBC) aired its first radio broadcast. 
+
+3. The Hollywood Sign was officially dedicated in California, marking the beginning of Hollywood's rise to prominence in the American film industry. 
+
+4. The Ford Motor Company introduced the firstassembly line to mass produce cars, making cars more accessible to the general public. 
+
+5. The German aerospace company Zeppelin began constructing the Hindenburg, a large passenger airship.
 </pre>
 
 ## License

cloud-architecture/oracle-apps-hyperion-siebel-gbu/hyperion-essbase/hyperion-fsdr/LICENSE

@@ -0,0 +1,36 @@
+
+Copyright (c) 2024 Oracle and/or its affiliates.
+
+The Universal Permissive License (UPL), Version 1.0
+
+Subject to the condition set forth below, permission is hereby granted to any
+person obtaining a copy of this software, associated documentation and/or data
+(collectively the "Software"), free of charge and under any and all copyright
+rights in the Software, and any and all patent rights owned or freely
+licensable by each licensor hereunder covering either (i) the unmodified
+Software as contributed to or provided by such licensor, or (ii) the Larger
+Works (as defined below), to deal in both
+
+(a) the Software, and
+(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+one is included with the Software (each a "Larger Work" to which the Software
+is contributed by such licensors),
+
+without restriction, including without limitation the rights to copy, create
+derivative works of, display, perform, and distribute the Software and make,
+use, sell, offer for sale, import, export, have made, and have sold the
+Software and the Larger Work(s), and to sublicense the foregoing rights on
+either these or other terms.
+
+This license is subject to the following condition:
+The above copyright notice and either this complete permission notice or at
+a minimum a reference to the UPL must be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cloud-architecture/oracle-apps-hyperion-siebel-gbu/hyperion-essbase/hyperion-fsdr/README.md

@@ -0,0 +1,31 @@
+# Oracle Hyperion EPM System Full Stack Disaster Recovery scripts
+
+This GitHub repository provides custom scripts that serve as a starting point for creating your own scripts to use with OCI Full Stack Disaster Recovery for Hyperion applications.
+
+Included scripts:
+- start_services.ps1/sh - script to start all EPM System services, including WLS and OHS, on Windows (PowerShell) or Linux (Bash) compute
+- stop_services.ps1/sh - script to start all EPM System services, including WLS and OHS, on Windows (PowerShell) or Linux (Bash) compute
+- host_switch_failover.ps1/sh - script to update host file after switch to the standby region. Windows (PowerShell) or Linux (Bash). 
+- host_switch_failback.ps1/sh - script to update host file after switch from standby region back to the primary region. Windows (PowerShell) or Linux (Bash).
+
+Reviewed: 6.6.2024
+
+# When to use this asset?
+
+Use these scripts to customize your Full Stack Disaster Recovery plans and automate switchovers and failovers between OCI regions for EPM System applications.
+
+# How to use this asset?
+
+Use these scripts in FSDR user defined plan groups [link](https://docs.oracle.com/en-us/iaas/disaster-recovery/doc/add-user-defined-plan-groups.html)
+
+# Useful Links
+
+OCI Full Stack Disaster Recovery documentation can be found [here](https://docs.oracle.com/en-us/iaas/disaster-recovery/index.html) .
+
+# License
+
+Copyright (c) 2024 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

cloud-architecture/oracle-apps-hyperion-siebel-gbu/hyperion-essbase/hyperion-fsdr/files/LICENSE

@@ -0,0 +1,36 @@
+
+Copyright (c) 2024 Oracle and/or its affiliates.
+
+The Universal Permissive License (UPL), Version 1.0
+
+Subject to the condition set forth below, permission is hereby granted to any
+person obtaining a copy of this software, associated documentation and/or data
+(collectively the "Software"), free of charge and under any and all copyright
+rights in the Software, and any and all patent rights owned or freely
+licensable by each licensor hereunder covering either (i) the unmodified
+Software as contributed to or provided by such licensor, or (ii) the Larger
+Works (as defined below), to deal in both
+
+(a) the Software, and
+(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+one is included with the Software (each a "Larger Work" to which the Software
+is contributed by such licensors),
+
+without restriction, including without limitation the rights to copy, create
+derivative works of, display, perform, and distribute the Software and make,
+use, sell, offer for sale, import, export, have made, and have sold the
+Software and the Larger Work(s), and to sublicense the foregoing rights on
+either these or other terms.
+
+This license is subject to the following condition:
+The above copyright notice and either this complete permission notice or at
+a minimum a reference to the UPL must be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cloud-architecture/oracle-apps-hyperion-siebel-gbu/hyperion-essbase/hyperion-fsdr/files/host_switch_failback.ps1

@@ -0,0 +1,29 @@
+#ps1
+
+# For usage instructions see host_switch_readme.txt
+
+$hostsFile = "C:\Windows\System32\drivers\etc\hosts"
+$primaryHostsFile = "C:\scripts\primary_hosts.txt"
+$standbyHostsFile = "C:\scripts\standby_hosts.txt"
+
+# Mode: "failover" or "failback"
+$mode = "failback"
+
+# Get the current date and time for the backup filename
+$currentDate = Get-Date -Format "yyyyMMdd_HHmmss"
+$backupFile = $hostsFile + ".bak_" + $currentDate
+
+if ($mode -eq "failover") {
+    # Create an archive backup of the current hosts file
+    Copy-Item $hostsFile $backupFile -Force
+
+    # Overwrite hosts file with standby version
+    Copy-Item $standbyHostsFile $hostsFile -Force
+
+} elseif ($mode -eq "failback") {
+    # Overwrite hosts file with primary version
+    Copy-Item $primaryHostsFile $hostsFile -Force
+
+} else {
+    Write-Error "Invalid mode! Please specify either 'failover' or 'failback'."
+}

cloud-architecture/oracle-apps-hyperion-siebel-gbu/hyperion-essbase/hyperion-fsdr/files/host_switch_failback.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+
+# For usage instructions see host_switch_readme.txt
+
+hosts_file="/etc/hosts"
+primary_hosts_file="/path/to/primary_hosts.txt"
+
+# Overwrite hosts file with primary version
+sudo cp $primary_hosts_file $hosts_file
+
+echo "Failback to primary complete."

cloud-architecture/oracle-apps-hyperion-siebel-gbu/hyperion-essbase/hyperion-fsdr/files/host_switch_failover.ps1

@@ -0,0 +1,29 @@
+#ps1
+
+# For usage instructions see host_switch_readme.txt
+
+$hostsFile = "C:\Windows\System32\drivers\etc\hosts"
+$primaryHostsFile = "C:\scripts\primary_hosts.txt"
+$standbyHostsFile = "C:\scripts\standby_hosts.txt"
+
+# Mode: "failover" or "failback"
+$mode = "failover"
+
+# Get the current date and time for the backup filename
+$currentDate = Get-Date -Format "yyyyMMdd_HHmmss"
+$backupFile = $hostsFile + ".bak_" + $currentDate
+
+if ($mode -eq "failover") {
+    # Create an archive backup of the current hosts file
+    Copy-Item $hostsFile $backupFile -Force
+
+    # Overwrite hosts file with standby version
+    Copy-Item $standbyHostsFile $hostsFile -Force
+
+} elseif ($mode -eq "failback") {
+    # Overwrite hosts file with primary version
+    Copy-Item $primaryHostsFile $hostsFile -Force
+
+} else {
+    Write-Error "Invalid mode! Please specify either 'failover' or 'failback'."
+}

cloud-architecture/oracle-apps-hyperion-siebel-gbu/hyperion-essbase/hyperion-fsdr/files/host_switch_failover.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+
+# For usage instructions see host_switch_readme.txt
+
+hosts_file="/etc/hosts"
+backup_file="${hosts_file}.bak"  # Change if needed
+standby_hosts_file="/path/to/standby_hosts.txt"
+
+# Get the current date and time for the optional backup filename
+current_date=$(date +"%Y%m%d_%H%M%S")
+
+# Create an archive backup of the current hosts file (optional)
+sudo cp $hosts_file "${backup_file}_${current_date}"
+
+# Overwrite hosts file with standby version
+sudo cp $standby_hosts_file $hosts_file
+
+echo "Failover to standby complete."

cloud-architecture/oracle-apps-hyperion-siebel-gbu/hyperion-essbase/hyperion-fsdr/files/host_switch_readme.txt

@@ -0,0 +1,61 @@
+# README for Host Switch Scripts
+
+During a failover to a standby region, applications often rely on hostnames to access critical resources. These hostnames usually resolve to IP addresses within the primary region. By switching the hosts file to a version containing the corresponding IP addresses for the standby region, applications can continue to function seamlessly without needing code modifications. This ensures minimal disruption and a smoother transition during a failover event. The host_switch scripts automate this process and can be integrated into Full Stack Disaster Recovery plans.
+
+## Instructions
+
+### Prerequisites
+
+- Ensure the PowerShell execution policy allows script execution (set to at least RemoteSigned or similar if the script is not signed).
+- The script needs to be run with sufficient privileges to modify the hosts files.
+- Make sure you are able to run commands on OCI compute nodes: https://docs.oracle.com/en-us/iaas/Content/Compute/Tasks/runningcommands.htm
+
+### Files
+
+- `host_switch_failover.ps1`: PowerShell script to switch the hosts file after failover to the standby region.
+- `host_switch_failback.ps1`: PowerShell script to restore the original hosts file after failback to the primary region.
+- `primary_hosts.txt`: Contains the original host file for the primary region.
+- `standby_hosts.txt`: Maps standby region IP addresses to primary region hostnames.
+
+### Overall Process
+
+#### Preparation
+
+1. Create `primary_hosts.txt` and `standby_hosts.txt` files with the appropriate IP address and hostname mappings for their corresponding regions.
+2. Place all files (`host_switch_failover.ps1`, `host_switch_failback.ps1`, `primary_hosts.txt`, `standby_hosts.txt`) in an accessible location on both the primary and standby systems.
+
+#### Failover to Standby
+
+1. On the standby system, execute the script `host_switch_failover.ps1`:
+
+    C:\Windows\System32\WindowsPowerShell\v1.0\Powershell.exe c:\scripts\host_switch_failover.ps1
+
+   Or, if using a shell script:
+
+    /path/to/host_switch_failover.sh
+
+2. This will replace the hosts file with the standby mappings.
+
+#### Failback to Primary
+
+1. On the original primary system, execute the script `host_switch_failback.ps1`:
+
+    C:\Windows\System32\WindowsPowerShell\v1.0\Powershell.exe c:\scripts\host_switch_failback.ps1
+
+   Or, if using a shell script:
+
+    /path/to/host_switch_failback.sh
+
+2. This will restore the hosts file to the original primary mappings.
+
+### Important Notes
+
+- **File Paths**: Adjust file paths in the instructions and the script if your files are located in a different directory.
+- **Backup**: The script creates an archive backup of the hosts file with a date and time appended to the filename (e.g., `hosts.bak_20240308_163012`) before any modifications are made.
+- **Permissions**: Ensure the user or process executing the script has permissions to modify the hosts file in `C:\Windows\System32\drivers\etc`. You may need to run the script with administrative privileges.
+- **Automation**: Consider integrating this script into your broader disaster recovery orchestration processes for automated execution, if applicable.
+
+### Additional Tips
+
+- **Test Thoroughly**: Test the script in a non-production environment to ensure it works as expected before using it in your production switchover process.
+- **Script Protection**: Store the script and host files in a secure location with appropriate access controls to prevent unauthorized modifications.

cloud-architecture/oracle-apps-hyperion-siebel-gbu/hyperion-essbase/hyperion-fsdr/files/primary_hosts.txt

@@ -0,0 +1,19 @@
+# Copyright (c) 1993-2009 Microsoft Corp.
+#
+# This is a sample HOSTS file used by Microsoft TCP/IP for Windows.
+#
+# This file contains the mappings of IP addresses to host names. Each
+# entry should be kept on an individual line. The IP address should
+# be placed in the first column followed by the corresponding host name.
+# The IP address and the host name should be separated by at least one
+# space.
+#
+# Additionally, comments (such as these) may be inserted on individual
+# lines or following the machine name denoted by a '#' symbol.
+#
+
+# This file should contain content of the original host file from the primary OCI region 
+
+# localhost name resolution is handled within DNS itself.
+#	127.0.0.1       localhost
+#	::1             localhost