OPERA V5 OPI Installation and Reference Guide Release 20.1 F26820-01 Copyright © 2010, 2020, Oracle And/Or Its Affiliates
Total Page:16
File Type:pdf, Size:1020Kb
Oracle® Hospitality Payment Interface OPERA V5 OPI Installation and Reference Guide Release 20.1 F26820-01 July 2020 Oracle Hospitality Payment Interface OPERA V5 OPI Installation and Reference Guide Release 20.1 F26820-01 Copyright © 2010, 2020, Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation 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 be error-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 it on behalf of the U.S. Government, then the following notice is applicable: U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition 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 be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government. This software or hardware is developed for general use in a variety of information management applications. 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 or hardware 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 its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. 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 responsible for 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. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle. Contents Contents 3 Preface 4 1 Pre-Installation Steps 1-1 2 Installing the OPI 2-1 Certificates 2-10 3 OPERA Configuration 3-1 Creating an EFT Interface 3-1 Configuring CHIP AND PIN (EMV) 3-2 Configuring the CC Vault 3-5 Cashiering Overview 3-6 Overview of Credit Card Payment Types 3-7 Credit Card Type Payment Setup Information 3-8 Configuring the Workstation 3-14 Configuring the Hotel Property Interface (IFC8) Instance to the OPERA Hotel Property Interface (IFC) 3-14 Configuring Authentication for the Hotel Property Interface (IFC8) with OPI 3-16 Perform a Tokenization 3-18 4 Upgrading the OPI 4-1 Upgrading OPI 6.2.0.0 to 20.1.0.0 4-1 Upgrading OPI 19.1.0.0 to 20.1.0.0 4-3 iii Preface Purpose This document describes how to configure the Oracle Payment Interface On Premise Token Exchange Service. Audience This document covers the installation of OPI, as well as the OPERA and IFC8 Configuration needed to support OPI. Customer Support To contact Oracle Customer Support, access My Oracle Support at the following URL: https://support.oracle.com When 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 Screen shots of each step you take Documentation Oracle Hospitality product documentation is available on the Oracle Help Center at http://docs.oracle.com/en/industries/hospitality/ Table 1 Revision History Date Description April 2020 Initial publication. July 2020 Revised content across the entire document. iv 1 Pre-Installation Steps IF UPGRADING OPI, YOU MUST READ THE UPGRADING THE OPI SECTION FIRST. Minimum OPERA Property Management Systems (for V5 Hosted) releases you can integrate with OPI: – OPERA V5 Hosted 5.5.25 or higher – OPERA V5.6.4 or higher OPI 20.1 does not install a database. If doing a clean install of OPI, a database must be installed first. You cannot upgrade directly from OPI 6.1 to OPI 20.1. Upgrading from OPI 6.2 and OPI 19.1 (including patch releases) to OPI 20.1 is supported. OPI requires 64bit Operating System only. OPI requires at least 6 GB of free disk space and you must install OPI as a System Administrator. NOTE: Stay current by upgrading your Java version as Oracle CPUs/Alerts are announced. During the installation you must confirm the following: Merchant IDs IP address of the OPI Server If there is an existing MySQL database installed, then the SQL root password is required. If there is an existing database installed, the root password is required Workstation IDs and IPs that integrate with the PIN pad 1-1 2 Installing the OPI 1. Right-click OraclePaymentInterfaceInstaller_20.1.0.0.exe file and select Run as Administrator to perform an installation. 2. Select your language from the drop-down list, and click OK. 3. Click Next twice. 4. Ensure all the prerequisites for the OPI installation are met. 5. Select either the Complete or Custom installation option: a. Complete: All program features will be installed. b. Custom: Select which program features you to install. Recommended for advanced users only. 6. Make a selection (only for Custom install), and then click Next. If you select Complete Install, it will go to the Step 8 directly. 2-1 Chapter 2 Installing the OPI If you selected the Custom install option, the Select Features screen appears with the following options: a. Database Schema b. OPI Services c. Configuration Tool All these three features must be installed. Ensure whether they all are installed on the same computer or on separate computers. 7. Select the features to install on this computer, and then click Next. 8. Click Change to amend the installation drive or path, if required and click Next. 9. Click Install to begin the installation. When the file transfer is finished, Setup prompts for the next set of configuration settings. 10. Select your Database type: My SQL Oracle DB 2-2 Chapter 2 Installing the OPI 11. Enter the relevant connection details for your database type. Details can be provided by the individual who installed or configured the database software. NOTE: OPI does not install any database, so the database must already be installed. MySQL – Name/IP: The Hostname or IP Address used for communication to the database. If you are using MySQL, then this can be left as localhost as the default value. If you cannot use localhost for the Name/IP field (because you have installed the database schema on another computer), then you should run some commands manually on the MySQL database before proceeding. See the Granting Permission in MySQL section in the OPI Installation and Reference guide for instructions. Setup will not be complete if this step is missed. – Port #: The Port number used for communication to the database Oracle DB SID – Name/IP: The Hostname or IP Address used for communication to the database. – Port #: The Port number used for communication to the database. – SID: The unique name that uniquely identifies the Oracle database. Service Name – Name/IP: The Hostname or IP Address used for communication to the database. 2-3 Chapter 2 Installing the OPI – Port #: The Port number used for communication to the database. – Service: The TNS alias used to connect to the Oracle database. 12. Confirm the database admin user used to connect to the database. The database admin user is used to create an OPI database user, which is used once the installation completes. 13. Enter the username and password to create a new database user account. If the username already exists in the database, you are prompted to select a different username. The installer attempts to connect to the database using the admin credentials provided and creates the OPI database user. 14. Enter the username and password to create a Super User System Admin level account that is used for configuring and maintaining the system. 15. Enter the Host and Port. NOTE: In the previous step you are not configuring the port the service will listen on. Instead, it is prompting for the details on how to connect. The IP will depend on where the OPI Config Service is installed. If you are performing a complete installation, this can be left as the localhost address.