OPERA IFC Controller And Hotel Property Interface (IFC8)
Oracle Hospitality OPERA IFCController and Hotel Property Interface(IFC8)Information and Installation GuideRelease 2.0December 2021
Copyright 2018, 2021, Oracle and/or its affiliates. All rights reserved.This software and related documentation are provided under a license agreement containingrestrictions on use and disclosure and are protected by intellectual property laws. Except asexpressly permitted in your license agreement or allowed by law, you may not use, copy,reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, ordisplay any part, in any form, or by any means. Reverse engineering, disassembly, ordecompilation of this software, unless required by law for interoperability, is prohibited.The information contained herein is subject to change without notice and is not warranted to beerror-free. If you find any errors, please report them to us in writing.If this software or related documentation is delivered to the U.S. Government or anyone licensing iton behalf of the U.S. Government, then the following notice is applicable:U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integratedsoftware, any programs installed on the hardware, and/or documentation, delivered to U.S.Government end users are "commercial computer software" pursuant to the applicable FederalAcquisition Regulation and agency-specific supplemental regulations. As such, use, duplication,disclosure, modification, and adaptation of the programs, including any operating system,integrated software, any programs installed on the hardware, and/or documentation, shall besubject to license terms and license restrictions applicable to the programs. No other rights aregranted to the U.S. Government.This software or hardware is developed for general use in a variety of information managementapplications. It is not developed or intended for use in any inherently dangerous applications,including applications that may create a risk of personal injury. If you use this software orhardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe,backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and itsaffiliates disclaim any liability for any damages caused by use of this software or hardware indangerous applications.Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may betrademarks of their respective owners.Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARCtrademarks are used under license and are trademarks or registered trademarks of SPARCInternational, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks orregistered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The OpenGroup.This software or hardware and documentation may provide access to or information about content,products, and services from third parties. Oracle Corporation and its affiliates are not responsiblefor and expressly disclaim all warranties of any kind with respect to third-party content, products,and services unless otherwise set forth in an applicable agreement between you and Oracle. OracleCorporation and its affiliates will not be responsible for any loss, costs, or damages incurred due toyour access to or use of third-party content, products, or services, except as set forth in anapplicable agreement between you and Oracle.ii
ContentsPreface . 4Audience . 4Customer Support . 4Documentation . 4Revision History . 4IFC8 Components . 51 IFC8 Overview. 5 Oracle Hospitality Suite8 Property Interfaces . 52 Hardware and Operating System . 63 Pre-Requisites (Shared Security Domain. 74 Installation of IFC Controller . 8Verify the Service is Running . 125 Shared Domain Security Services . 146 OPERA Cloud Security Non-SSD Services Enabled Environment . 15Adding Service Accounts. 157 Configuring IFC Controller for OPERA Cloud or SSD Services Enabled16Installation . 188 IFC8 Installation. 189 OPERA IFC Controller Troubleshooting . 25iii
PrefaceThis document describes how Hotel Property Interface (IFC8) works with OPERAProperty Management System (PMS) and includes the basic configuration of IFC8 toconnect to a configured OPERA Property Interface. You must have a basic level offamiliarity with OPERA, OPERA Property Interfaces, and the 3rd party vendors thatutilize IFC8.AudienceThis document is intended for Oracle Hospitality members who need generalinformation on the installation and functionality of Hotel Property Interfaces (IFC8) withOPERA PMS.Customer SupportTo contact Oracle Customer Support, access My Oracle Support at the following URL:https://support.oracle.comWhen contacting Customer Support, please provide the following: Product version and program/module name Functional and technical description of the problem (include business impact) Detailed step-by-step instructions to re-create Exact error message received and any associated log files Screen shots of each step you takeDocumentationOracle Hospitality product documentation is available on the Oracle Help Center /Revision HistoryDateivDescription of ChangeJanuary 2019 Initial publicationMarch 2020 Update Hardware Sizing LinksJune 2021 OPERA Cloud environment and OPERA 5environment URL format examples added.December 2021 Added Microsoft Patch(KB2919355) for WindowsServer 2012 R2 pg 13.Preface
1IFC8 OverviewIFC8 ComponentsHotel Property Interface (IFC8) with OPERA PMS contains three components: OPERAInterface web service, OPERA IFC Controller, and the IFC8 executable file. OPERA Interface Web Service — this web service is installed as part of the standardOPERA Installation (For Example: Ifc8ws for v5, IFCInternalService for OPERACloud). It functions as a connection between the IFC Controller and OPERADatabase. OPERA IFC Controller — the OPERA IFC Controller is responsible for transferringXML messages from the IFC8.exe to the web service to be actioned in the databaseand polling the web service to get the queued messages from the database to be sentto IFC8.exe. IFC8 Executable file — this program takes XML messages transferred to it fromOPERA via the OPERA IFC Controller and translates them into messages thatexternal systems can understand.Figure 1 IFC8 Non-Hosted ArchitectureFor the latest IFC8 component and OPERA IFC Controller, visit My Oracle Support(MOS) at https://support.oracle.com/epmos/faces/Dashboard. Navigate to the ‘Patches &Updates’ tab and search within the product field for the following: Oracle Hospitality Suite8 Property Interfaces Oracle Hospitality OPERA Property - Special InterfacesIFC8 Overview 1
2Hardware and Operating SystemConsiderationsThe OPERA IFC Controller is a 32-bit Windows Service written in C# originally, withinthe .NET 2.0 framework. Latest versions ( 5.03.00015) require .NET 4.5 or greaterframework. Find the specific IFC8 version information in the Hotel Property Interfacesection on hotels.htmlBoth programs are expected to be installed on a Windows (current Microsoft supportedOS) machine at the customer site.A rule of thumb concerning memory requirements for that Windows machine: 256 MB for the Windows OS. For the specific IFC8 version in use (Hotel Property Interface section y/hotels.html), see the DeploymentInstallation Guide for the memory requirements needed. Plus 100 MB for the OPERA IFC Controller.Hardware and Operating System Considerations 2
3Pre-Requisites (Shared Security DomainEnvironments Only) OPERA V5 internal load balancer certificates are loaded into the SSD OSB keystore.–For step by step documentation for this pre-requisite, see P00548 - OPERA 5.6.0 SSD Integration – SSD Configuration on OPERA V5 Server - v1.1.docxPre-Requisites (Shared Security Domain Environments Only) 3
4Installation of IFC Controller1.Install the latest OPERA IFC Controller, Version 5.03.00016 or higher for OPERA 5and TLS support; V5.03.00018 or higher for OPERA Cloud - .NET 4.5 or higher isneeded.2.Run the OperaIFCController-Installer.exe as an Administrator. (This can be a newinstall or an upgrade to an existing Controller on the machine.)Note: If the IFC controller is already installed, the exerequires time at startup to stop the Service.3.Click Next.4.Choose the destination folder for the .exe and dlls to reside.Note: The default options can be used.Installation of IFC Controller 4
5.Click NextIf there is an existing Controller, the fields populate with the current Registry settingsfound at HKEY LOCAL MACHINE Software- Wow6432Node Micros-Fidelio OPERA IFC Controller.For a new installation, enter the following fields: Log Level. This determines the granularity of the data logged by the controller. Therecommended setting is ‘Error’.–TRACE – Highest level of logging. Only set if instructed by Oracle Developmentfor troubleshooting.–DEBUG – Logs all Messages, Warnings and Errors, plus communicationmessages. This is the common setting for troubleshooting an issue.–MESSAGE – Logs Error, Warning, and all messages from PMS.–WARNING – Logs Error and Warning messages.–ERROR – Logs Error messages and is the recommended setting. Log Size. The maximum size of a log file before it creates a new file (entry is in bytes,and the recommended setting is 1500000). Log Purge. The number of days to keep log files. At Controller startup, any logsearlier than this setting will be deleted. Log Path. The physical path where log files are generated. It is recommended thatyou route the Controller logs to the same directory structure as the interface logs forIFC8. Such as Instdrive, Fidelio, and IFC8. Ensure that the following three style filesare copied to whatever location you store these files. (UP.gif, DOWN.gif, Log.xsl).These files are needed for viewing the logs. These files, by default, are extracted intothe C:\Program Files\Micros Systems, Inc\OperaIFCController path by theinstallation wizard. Send Interval, Timeout, Max Retry, Retry Interval, Use Clob and the Send Cfg Xmlare used for specific scenarios and can be kept at the default settings with install.Installation of IFC Controller 5
–Send Interval. Configurable value (in ms) for the interval between each messagesent to IFC8. A default value of 50ms is used when nothing is set. This canalleviate a backup on the vendor side if they cannot process a single message in50 ms, this can be set higher to allow more time between the messages theController sends in (like with the DB Swap messages).–Timeout. This is the Time out value (seconds) for web service connections. Ifnothing is set then .NET uses the default value of 100 secs. This is sufficient formost cases. The only reason to set it would be to set it 100 seconds whendealing with a very slow system. (For example: Web service returning responsesafter 100 secs.) In reality this should not occur or there would be seriousperformance issues in OPERA in general.–Use Clob. It is used when a LinkPmsConf has to support 32K or higher in size.The Default setting of N would suffice in the majority of installs.OPERA V5, OPERA App Server Name or IP Address. The URL to connect to the OPERAIFC web service on the Application, Load Balance, or OHS machine. Only thecomputer name should be entered. The exe will automatically add the full path.–For OPERA v5Syntax: https:// Application Server Name /Operajserv/Ifc8ws/Ifc8wsExample: RA Cloud, the OSB Server Name is entered. Installer must edit the Registrysetting (OperaIfcWS) after the install completes for the correct path used with theOPERA Cloud web service. This could be the OHS server name or OSB servername depending on the environment. For Example:https://OSBSERVER ervice orhttps://OHSSERVER erviceNote: This assumes the implementation of the OPERAServices Deployment Guide as per standard OPERAinstallation of the web services used with the Hotel PropertyInterfaces.–Shared Security Domain (SSD, the Installer must edit the Registry settings forOperaIfcWS after the install completes for the correct path used with SSD OSBweb services. SSD uses a load balancer for the OSB Server.Example:https://OSBLOADBL SERVER/OPERAOSB/OPERA IFC8/opera/IFC8/IFCInternalServiceFor GBUCS2.0 and GBUCS3.0, a dedicated OHS server is built to handle IFCtraffic. New URLs with OHS will appear in the following format:For the OPERA Cloud environment:https://OHSLOADBL rnalServiceFor the OPERA 5 environment:https://OHSLOADBL te: Registry settings can be found at -HKEY LOCAL MACHINE- Software- Wow6432Node(when on a 64-bit machine)- Micros-Fidelio- OPERA IFCController OPERA DB Datasource is the connection string to the database. This is only needed
for the on-premise and hosted version 5 installs.Note: In the case of an OPERA Cloud installation, thisvariable can be kept with the default value.The format will always be as follows: jdbc/ schema name database SID dsExample: jdbc/operaoperadsYou can run this SQL Statement to retrieve that connection string: selectjava util.get jndi connection from dual; Property: (Hotel Code/Resort) Enter the property that will be running IFC. This isused to initialize any properties in this chain. This variable should be entered in allcaps. Send Cfg Xml This is used to allow the Controller to send the existing config.xml toOPERA when IFC8 is started. The recommended setting is the default of N.6.Click Next.7.Click Next again.
8.When installation is complete, click Finish.Verify the Service is Running1.Navigate to the Run command and enter services.msc8 OPERA IFC Controller and Hotel Property Interface (IFC8)
2.The windows services window opens. Select the Service OPERA IFC Controller.Under status, the OPERA IFC Controller should be started.Note: Refer to the above to modify registry settings asneeded based on the specific deployment.Installation of IFC Controller 9
5Shared Domain Security ServicesEnvironmentTo learn more about configuring interface users and roles for the environments protectedby Shared Security Domain services, visit My Oracle Support using the Doc ID 2329730.1.It covers the following areas: The Cutover process to a Shared Security Domain Services environment anddescribes the required actions for each day in the cutover process prior toonboarding tenants to the new environment. How to create OPERA users as an Organization Admin using the Shared SecurityDomain Services. How to create an interface user in Oracle Identity Management (OIM) for the SharedSecurity Domain Services environment. How to reset an interface user’s password in Oracle Identity Management (OIM) forthe Shared Security Domain Services environment.Shared Domain Security Services Environment 10
6OPERA Cloud Security Non-SSDServices Enabled EnvironmentFor OPERA Cloud, additional credentials are needed that will be passed from theController to the web service endpoint to validate authorization of the use of the service.A user and password must be configured in Role Management for the Service Account oruser being utilized for this purpose.Adding Service AccountsUser logging in to OPERA Cloud’s Role Manager must have a WS-ACCESS role or a rolethat has one of the following tasks added: Manage Users/New/Edit Users/Show AllUsers. Create a new service account with a password if one does not exist.OPERA Cloud Security Non-SSD Services Enabled Environment 11
7Configuring IFC Controller for OPERACloud or SSD Services EnabledEnvironmentsTo configure the IFC Controller for OPERA Cloud or SSD Services EnabledEnvironments:1.Run the OperaControllerExe.exe as Administrator to add/change the username andpassword. This data is stored in encrypted format.2.Go to Config User Credentials.3.Enter the UserName and Password setup used previously in RoleManagement/OIM.4.Click Apply.Any existing data will be overwritten.Configuring IFC Controller for OPERA Cloud or SSD Services Enabled Environments 12
Note: This cannot be used to view existing credentials.Note: The Security Level Settings configuration is thesecurity level expected for the communication between theIFC Controller and the OPERA web service. This will defaultto Moderate with the install.Minimum Security Level will enable up to TLS 1.1communication protocol. OPERA does not recommend theuse of this setting.Moderate Security Level enables the use of the TLS 1.2protocol but does not specify which ciphers or hashes arewhitelisted or blacklisted, so the operating system defaultsare used.Maximum Security Level enables the use of the TLS 1.2protocol and inserts Cipher and Hash subkeys in the OSRegistry Editor to ensure the cipher set used by theController matches what OHS (used by OPERA ApplicationServers for IFC web services) allows.For Windows Server 2012 R2 install the following Microsoft Patch (KB2919355) and thelatest available Windows security patches to support approved Ciphers (e.g.TLS DHE RSA WITH AES 128 GCM SHA256,TLS DHE RSA WITH AES 256 GCM tails.aspx?id 42334If other settings were changed, use the Update button to implement those changes. TheRestart button can be used to conduct a quick restart of the Opera IFC ControllerService. The View Log and the Test URL buttons should not be used (improvements areforthcoming for these buttons).Quit or X out of the window.Configuring IFC Controller for OPERA Cloud or SSD Services Enabled Environments 13
8IFC8 InstallationInstallationScreenshots depicted here are for an older IFC8 version but reflective of general installation. Please findthe specific IFC8 version information in the Hotel Property Interface section y/hotels.html and follow the Installation Guide.1.Right click on the Installation file and select Run as Administrator.2.The IFC8 installation wizard is launched. Click Next.IFC8 Installation 14
3.Select option 3: IFC8 for OPERA.4.Click Next.5.Select the Drive you wish to install IFC8 and click Next.Note: The default drive is Drive C.IFC8 Installation 15
6.The Installation Path window appears. Click OK.This will install files to c:\fidelio\programs & c:\fidelio\ifc8 .7.Click Install to begin the installation.16 OPERA IFC Controller and Hotel Property Interface (IFC8)
8.When the installation is complete, click Finish to close the Installation Wizard.Files are copied to C:\fidelio\programs.Ensure that IFC8ComEx.tlb is available. If not, check that your .NET 4.x installation isvalid.IFC8 Installation 17
The files have been copied to c:\fidelio\ifc8.Link IFC8 instance to OPERA IFC Config1.Open an IFCConfig.xml file with IFC8.exe2.Navigate to Properties Configuration.3.Enter User Credentials for the machine running IFC8. Domain can be left blank.4.Go to PMS1 tree Application Layer OPERA.5.Enter the previously created Interface Number from OPERA against the parameter"IfcNum."Note: For information on creating a new property interface,visit the Oracle Help Center website and see the OPERAProperty Management User Guide.https://docs.oracle.com/cd/E98457 01/index.htmlYou can find the related IFC number in the OPERA IFC Configuration of the related IFC:For OPERA V518 OPERA IFC Controller and Hotel Property Interface (IFC8)
OPERA Cloud6.Click Enter and Apply. IFC8 will reinitialize.7.Click the Red Save button to save the Config file.8.Click OK to close the IFC8 Config file.9.Click Properties.10. Uncheck “Enable Config Mode” if it is enabled.IFC8 connection status: Green: Connection OK (connected) Yellow: awaiting connection (listening mode) Red: No connectionIFC8 Installation 19
In the above example, the IFC status is yellow, indicating it is waiting for OPG to connectto the defined port.The PMS status is green as the connection to OPERA IFC Controller has been established.Middle links will change to green once all connections/communications are established.20 OPERA IFC Controller and Hotel Property Interface (IFC8)
9OPERA IFC Controller TroubleshootingTroubleshooting of OPERA IFC Controller can be reviewed with the error messagesfound in the IFC Controller Log file found at the path defined with install.Some common error scenarios and the error that may be seen:When there is an incorrect server name or URL endpoint provided for the Controllerconnection to OPERA. (see Chapter 4, Part 5, point 6 for configuration of endpoint)WARNING: on: Theremote name could not be resolved: 'appserverorOSB.us.hoteltest.com'at rtContext& am()at ol.Invoke(StringObject[] parameters)methodName,at IFCProcessor.ifc8WS.Ifc8ws.getGenericMsg(String inConnectStr, String inResort,String inProcedure, String inParam1, String inParam2, String inParam3, String inParam4,String inParam5, String ice()With the OPERA Cloud web service in use, and there is no username/pwd or incorrectusername/pwd configured for the Controller. (see Chapter 7 for User Credentials)ERROR Opera IFC Controller : CIfcOperaConn.CheckWebServiceSoap exception: FAULT CODE - Server; SOURCE - System.Web.Services; MESSAGE - OSB-386200:General web service security errorWhen the TLS settings or protocol levels are not in sync between the IFC machine andOSB/WS machine. (see Chapter 7 for Security Level Settings)ERROR Opera IFC Controller : CIfcOperaConn.RecheckWebServiceconnecting to Web Service with SSL protocolErrorWhen the Hotel Code/Resort/Property is not found for the tenant the Controllerusername is linked with. (see Chapter 4, Part 5, point 8 for Property configuration)ERROR Opera IFC Controller : CIfcOperaConn.CheckWebServiceSoap exception: FAULT CODE - SSD00002; SOURCE - System.Web.Services; MESSAGE - Error in SSDResource: User is not authorized for the hotel code in the payload.When the specific IFC Machine name, where the Controller is installed, is not configuredin OPERA Property Interfaces IFC Machine Configuration. (log in to OPERA UI andcheck the IFC Machines configuration)ERROR Opera IFC Controller : CIFCOperaConn.ReadMachineInfois missing for machine IFCMACHINE4. Assuming default values.ConfigurationWhen there is an issue in the OPERA Database. (verify OPERA DB is up and check onWebServices)OPERA IFC Controller Troubleshooting 21
ERROR Opera IFC Controller : CIfcOperaConn.SetRegSettingsORA-06508: PL/SQL: could not find program unit being calledset reg settings -When the start of an IFC8 executable for a specific property interface doesn’t come up tofull communication handling. (see Chapter 8, Link IFC8 instance to OPERA)ERROR : CIfcOperaConn.ProcessLinkDescerror processing link desc" LinkDescription Date "200326" Time "134420" InterfaceFamily "PB"RequestType "4023" IfcNum "6635" ProcessId "4796" VerNum "9.6.11" FktLogo "SIM"Cryptogram "FidCryptDI 0;97;PSezh8L1TziMBQTOFB0tQA "/ "; ERROR : Interfaceis not active.(6635)22 OPERA IFC Controller and Hotel Property Interface (IFC8)
Interface web service, OPERA IFC Controller, and the IFC8 executable file. OPERA Interface Web Service — this web service is installed as part of the standard OPERA Installation (For Example: Ifc8ws for v5, IFCInternalService for OPERA Cloud). It functions as a connection between the IFC Controller and OPERA
987 Prague Hotel, Hotel Adria, Hotel Ametyst, Aria Hotel, Art Deco Imperial Hotel Praha, . Hotel Belvedere Praha, Hotel Beránek Praha, Hotel Caesar Praha, Hotel Čechie Praha, Hotel Don Giovanni Praha, Hotel Duo Praha, Hotel Elite, Hotel Elysee Praha, Hotel Esplanade praha, Hotel Expo, Hotel Extol Inn, Hotel
Classical Music CHINESE COMMUNITY CELEBRATION IN SF BAY AREA Classical Music TITO PUENTES Classical Music MUSIC IN THE MOUNTAINS, PAUL PERRY DIRECTOR . Opera LUCIA DI LAMERMOOR Opera LA BOHEME Opera LES MIZ AND PHANTOM OF THE OPERA Opera BRIGADOON Opera CINDERELLA Opera PHANTOM OF THE OPERA Opera PHANTOM OF THE OPERA
Sigma Alpha Epsilon Fraternity IFC 3.030 16 All Fraternity 3.002 Alpha Sigma Phi Fraternity IFC 2.972 17 All Campus Male 2.990 Sigma Chi Fraternity IFC 2.957 18 Theta Xi Fraternity IFC 2.946 19 Omega Psi Phi Fraternity, Inc. Fraternity NPHC 2.938 20 Pi Kappa Alpha Fraternity IFC 2.878 21 Pi Kappa Phi Fraternity IFC 2.846 22
A Broadway World reviewer recently commented on Shell’s new production of Leonard Bernstein’s Candide: “This production was one I could watch over and over again.” Shell has directed productions for Atlanta Opera, Pittsburgh Opera, Michigan Opera Theater, Opera Omaha, Opera San José, Opera Tampa, Opera North, Virginia Opera, Santa Fe and
"The Threepenny Opera" remains the most famous and popular example of what Brecht called "epic theatre." It received its world premiere in Berlin on Aug 31, 1928. The premiere of The Threepenny Opera on this day in 1928 came almost exactly 200 years after the premiere of the work on which it was based: John Gay's The Beggar's Opera. In Gay's .File Size: 699KBPage Count: 14Explore furtherScript for The Threepenny Opera by Bertolt Brecht at the .archiveshub.jisc.ac.ukThe Threepenny Opera Pdf ePub Free Readfreereadebookonline.comBertolt Brecht The Threepenny Opera 1928 PDF .www.scribd.comThe Threepenny Opera Study Guide GradeSaverwww.gradesaver.com(PDF) The threepenny Opera (Complete ver.) - Bertolt .www.academia.eduRecommended to you based on what's popular Feedback
Minnesota Opera Debut: Tosca, 2005 Notable Engagements: Cold Mountain, Santa Fe Opera La bohème, English National Opera The Barber of Seville, Canadian Opera Company Rigoletto, Bremen Opera Company Ainadamar, Santa Fe Opera Un ballo in maschera, Minnesota Opera LEVI HERNANDEZ Baritone Hometown: El Paso, TX Minnesota Opera Debut: Madama .
1. Airport Hotel 3-5 star 2. Beach Hotel 3-5 star 3. Boutique Hotel 4-5 star 4. Business Hotel 1-5 star 5. City Hotel 1-5 star 6. Convention Hotel 1-5 star 7. Family Hotel 3-5 star 8. Resort Hotel 3-5 star 9. Apartment Hotel 1-5 star Designators are awarded after the hotel has met the requirements of the respective designators.
Alex Rider is not your average fourteen-year-old. Raised by his mysterious uncle, an uncle who dies in equally mysterious circumstances, Alex finds himself thrown into the murky world of espionage. Trained by MI6 and sent out into the field just weeks later, Alex [s first mission is to infiltrate the base of the reclusive billionaire suspected of killing his uncle. Filmic and fast-paced (the .
