OPERA v5.

OPERA v5.6
Change Hostname Guide
New Openings and Upgrades
OPERA VERSION 5

MARRIOTT INTERNATIONAL CONFIDENTIAL & PROPRIETARY INFORMATION Change Hostname Guide | 27-MAY-21 1
OPERA v5.6

Contents
Contents ........................................................................................................................................................ 1
Approach ....................................................................................................................................................... 2
Environment Details...................................................................................................................................... 2
Requirements................................................................................................................................................ 3
Step 1 – Update Windows Services .............................................................................................................. 4
Step 2 – Update Hosts File ............................................................................................................................ 5
Step 3 – Extract Change Hostname............................................................................................................... 7
Step 4 – Run Change Hostname Utility ......................................................................................................... 9
Support ....................................................................................................................................................... 11
Document Change Log ................................................................................................................................ 12

MARRIOTT INTERNATIONAL CONFIDENTIAL & PROPRIETARY INFORMATION Change Hostname Guide | 27-MAY-21 1
OPERA v5.6

Approach
The scripts are designed to update the new hostname of server within the configuration files
after the server hostname has been physically changed.

The scripts make changes to Database, Weblogic Server, JDBC, OHS, OPERA, and Report
configuration files.

Environment Details
Operating System: Windows Server 2016 R2 Standard
Oracle Version: 12.2.0.1
Opera Version: 5.6.X
Weblogic Version: 12.2.1.3.0
Forms Version: 12c
Scripting Languages: Power shell, Python
Java Version: 1.8

MARRIOTT INTERNATIONAL CONFIDENTIAL & PROPRIETARY INFORMATION Change Hostname Guide | 27-MAY-21 2
OPERA v5.6

Requirements
If your OPERA server does not meet the requirements listed below, the Change Hostname Utility should
not be used.
• Running the Change Hostname Utility on a server that does not meet the
requirements can cause harm to the server and require redeployment

1. The Server has been built to the specifications outlined in the OPERA assessment.

• 64GB of RAM is the minimum value for the OPERA server

2. The user account executing the script has full admin access (including being a part of the
ora_dba user group) on the server, ideally using the "Administrator" user which is already a part
of the necessary groups
3. Server hostname should be changed before execution of the script.
4. OPERA SSL certificate has already been successfully implemented
5. Only an OPERA single server environment has been considered.
6. There is no OPERA v5.6 Dataguard / Standby Database setup or Clustered environment
functionality.
7. Scripts are designed with an assumption that the OPERA, Oracle, and WebLogic are defaulted to
a D drive installation.

MARRIOTT INTERNATIONAL CONFIDENTIAL & PROPRIETARY INFORMATION Change Hostname Guide | 27-MAY-21 3
OPERA v5.6

Step 1 – Update Windows Services

Follow the steps below to update the startup type of the Windows services for OPERA.

1. Click Start > Run > services.msc

2. Locate the services in the table below and update their startup type
NOTE: Do not start the services

Service Name Startup Type

Oracle Weblogic OperaDomain NodeManager Automatic (Delayed Start)
Oracle Weblogic OperaOHSDomain Automatic (Delayed Start)
NodeManager
OracleORA12201TNSListener Automatic
OracleServiceOpera Automatic

MARRIOTT INTERNATIONAL CONFIDENTIAL & PROPRIETARY INFORMATION Change Hostname Guide | 27-MAY-21 4
OPERA v5.6

Step 2 – Update Hosts File

Managed and Franchise
Follow the steps below to add the XXXXX.marriott.com entry to the hosts file on the OPERA server. This
step is required by OPERA servers for the change hostname to function correctly.

1. Run Notepad as Administrator

2. Open "C:\Windows\System32\drivers\etc\hosts"
change file type to all files to see the hosts files

MARRIOTT INTERNATIONAL CONFIDENTIAL & PROPRIETARY INFORMATION Change Hostname Guide | 27-MAY-21 5
OPERA v5.6

3. If not already added, create a line for the CN value of the certificate. This should follow the
pattern XXXXX.marriott.com, where XXXXX is the MARSHA code of the hotel and the IP address
is the CURRENT IP address of the OPERA v5.6 server
NOTE: this entry will be modified to the final IP address in a later process
Example Below is for RESOM with an OPERA server IP address of 162.130.8.236

4. Save the file

MARRIOTT INTERNATIONAL CONFIDENTIAL & PROPRIETARY INFORMATION Change Hostname Guide | 27-MAY-21 6
OPERA v5.6

Step 3 – Extract Change Hostname

The latest version of the change hostname utility will need to be downloaded and extracted to the
OPERA server.

• 64GB of RAM is the minimum value for the OPERA server

• Folder structure of the scripts must be maintained (D:\OracleScripts) as details in the
steps below

1. Download the files from the Marriott Box at the link below, the download button should be in
the top right
https://marriottpilot.box.com/s/m07jo6akw9kwzdq4fg2mzat5gbdq7zl2

2. Navigate to the download location

3. Right click “Change_Hostname_V1.3.zip” > Select 7-Zip > Extract Files…
NOTE: filename may vary due to version differences

MARRIOTT INTERNATIONAL CONFIDENTIAL & PROPRIETARY INFORMATION Change Hostname Guide | 27-MAY-21 7
OPERA v5.6

4. Change the Extract to: field to D:\, and uncheck the box in red as seen in the screenshot below,
then click OK

5. The directory should appear like the below screenshot

6. Run PowerShell as administrator

7. Run the command below

dir -Path D:\OracleScripts -recurse | Unblock-File

8. Close the PowerShell window

MARRIOTT INTERNATIONAL CONFIDENTIAL & PROPRIETARY INFORMATION Change Hostname Guide | 27-MAY-21 8
OPERA v5.6

Step 4 – Run Change Hostname Utility

The change hostname utility needs to be run in order to update OPERA configurations with the new
hostname of the server.

• 64GB of RAM is the minimum value for the OPERA server

1. Run Windows PowerShell as Administrator

2. Run the commands below in PowerShell

cd D:\OracleScripts
.\MasterScript.ps1

3. The script will run automatically and can take anywhere from 1.5 to 3 hours
NOTE: Do not interact with the PowerShell window or you can cause the script to get stuck.
NOTE: Best practice is to login locally to the server to prevent session timeouts or interruptions
to the change hostname utility
4. The change hostname Utility will reboot the server
5. Once the reboot is complete, the same user that started the Change Hostname scripts will need
to login into the server for the process to finish

MARRIOTT INTERNATIONAL CONFIDENTIAL & PROPRIETARY INFORMATION Change Hostname Guide | 27-MAY-21 9
OPERA v5.6

6. The following message will be displayed when it completes

MARRIOTT INTERNATIONAL CONFIDENTIAL & PROPRIETARY INFORMATION Change Hostname Guide | 27-MAY-21 10
OPERA v5.6

Support
New OPERA Install/New Property Opening:
Contact your Marriott Installation or IT Project Manager.

OPERA v5.6 Upgrade:

Submit a Marriott Service Portal (ServiceNow) support request:

1. Log into https://marriott.service-now.com/msp

2. Select “REPORT AN ISSUE” / “GET HELP”
3. Select “Property Management Systems”
4. Select “OPERA v5.6 Upgrade”
5. Select your Continent and if applicable, Above-Property or On-Property OPERA

Direct link the OPERA v5.6 Upgrade support form: https://marriott.service-

now.com/msp?id=msp_record_producer&sys_id=f095bfe6dbcdac14b478502bdc9619a6&u_support_ca
tegory=&application_service_clicked=5ea0723edbf7364019d7fd7aae961929&u_portal_name=OPERAv5
_6Upgrade&readonly=true&u_visible=true&u_portal_category=cb610ddddb833f44b478502bdc9619ce

MARRIOTT INTERNATIONAL CONFIDENTIAL & PROPRIETARY INFORMATION Change Hostname Guide | 27-MAY-21 11
OPERA v5.6

Document Change Log

Update On Description Updated By Document
Version
01-FEB-19 Initial Document Rachel Heatherly 1.00
01-NOV-20 Update title page, Add revision history, Update Jason Clark 1.01
environment details, Update assumptions, update
utility download location, added steps for unzipping,
added steps for windows services, updated steps for
config files, separated extract and run change
hostname, added post utility config file modifications
01-FEB-21 Added section for updating the hosts file for franchise Jason Clark 1.02
hotels
08-MAR-21 Removed configuration file step for default_oxi.env as Jason Clark 1.03
the file does not exist, updated hosts file section to
include both managed and franchise hotels
25-Mar-21 Update steps to include step #, clarify requirements Jason Clark 1.04
for the update of config files, moved delete temporary
schema section to subsection of run change host to
clarify site requirements
20-APR-21 Removed Step 5 as this is resolved in change Jason Clark 1.05
hostname version 1.5, removed temporary schema
error message from Step 4 as this is resolved in
change hostname version 1.5, updated final
screenshot
27-May-21 Correct typo in windows services Jason Clark 1.06

MARRIOTT INTERNATIONAL CONFIDENTIAL & PROPRIETARY INFORMATION Change Hostname Guide | 27-MAY-21 12