Skip Headers
Oracle® Retail Point-of-Service Installation Guide
Release 14.1
E54459-01
  Go To Table Of Contents
Contents

Previous
Previous
 
Next
Next
 

A Appendix: Installer Windows for Server Installation

You need specific details about your environment for the installer to successfully install the Point-of-Service application. This appendix shows the windows that are displayed during the installation of the Point-of-Service server. Depending on the options you select, you may not see some windows or fields.

For each field in a window, a table is included in this appendix that describes the field.

For the installer windows for a client installation, see Appendix B.


Note:

The paths shown in the window examples in this appendix use the path format for Microsoft Windows. In the table describing those fields, example paths for both Microsoft Windows and Novell SLEPOS are shown.

Figure A-1 Introduction


Figure A-2 Previous POS Install


Figure A-3 License Agreement



Note:

You must choose to accept the terms of the license agreement in order for the installation to continue.

Figure A-4 All Supported Languages


The field in this window is described in the following table:

Details Content
Field Title Select all supported languages
Field Description Choose whether all languages are initially selected on the Supported Languages screen:
  • To have all available languages initially selected, select Yes.

  • To have only English initially selected, select No.

Example No

Figure A-5 Supported Languages


The field in this window is described in the following table:

Details Content
Field Title Please enter the supported languages
Field Description Select the languages that will be available for the Point-of-Service application.

The languages selected in this window determine the available choices in the Enter Default Locale window.

Example English, French, and Spanish

Figure A-6 Enter Default Locale


The field in this window is described in the following table:

Details Content
Field Title Enter Default Locale
Field Description Locale support in Point-of-Service enables the date, time, currency, calendar, address, and phone number to be displayed in the format for the selected default locale.

The choices for default locale are dependent on the selections made in the Supported Languages window. For each selected language, the default locale for that language is displayed in the Enter Default Locale window. For example, if English, French, and Italian are selected in the Supported Languages window, en_US, fr_FR, and it_IT are the available choices for the default locale.

Example en_US

Figure A-7 Tier Type


The field in this window is described in the following table:

Details Content
Field Title Tier Type
Field Description Choose the server tier type for this installation. For more information, see "Determining Tier Type" in Chapter 3.

To install the N-Tier version of the server, choose N-Tier Server.

Example N-Tier Server

Figure A-8 Installation Location


The field in this window is described in the following table:

Details Content
Field Title Install Directory
Field Description Choose the directory into which the Point-of-Service files are copied. The default for the first directory in the path is OracleRetailStore. This directory should be the same for all Oracle Retail POS Suite products.

Note: The server and the client must not be installed into the same directory.

In this guide, <POS_install_directory> refers to the selected installation directory for the server or client.

Files specific to Point-of-Service are copied to the pos subdirectory of <POS_install_directory>.

Example
  • Microsoft Windows:

    C:\OracleRetailStore\Server

  • Novell SLEPOS:

    /opt/OracleRetailStore/Server


Figure A-9 JRE Location


The field in this window is described in the following table:

Details Content
Field Title JRE Location
Field Description Enter the location where the JRE is installed.
Example
  • Microsoft Windows:

    C:\Program Files\Java\jre7

  • Novell SLEPOS:

    /opt/Java/jre7


Figure A-10 JRE Vendor


The field in this window is described in the following table:

Details Content
Field Title Please select the JRE 1.7.x vendor
Field Description Select the vendor for the JRE entered in the JRE Location window:
  • Oracle

  • IBM

Choose Oracle.


Figure A-11 Store Server Details


The fields in this window are described in the following tables:

Details Content
Field Title Hostname
Field Description Enter the host name of the store server.

Details Content
Field Title Port
Field Description Enter the port number of the store server host computer used for JNDI lookups by remote clients.
Example 1300

Details Content
Field Title RMI Port For Dispatcher
Field Description Enter the port number of the store server host computer used for RMI communication to this installation's Point-of-Service dispatcher.
Example 1301

Details Content
Field Title RMI Port Range For Technicians
Field Description Enter the range of port numbers enabled for RMI communication to this installation's technicians.
Example 1310-1399

Figure A-12 Store ID


The field in this window is described in the following table:

Details Content
Field Title Store ID
Field Description Enter the store ID.

Note: The store ID must be five digits. It can be padded with leading zeroes if necessary. The store ID can only contain the numeric characters 0 through 9.

Example 04241

Figure A-13 Integrate Applications


The field in this window is described in the following table:

Details Content
Field Title Please select the applications to integrate with Oracle Point-of-Service
Field Description Select the applications that Point-of-Service is integrated with:
  • Central Office/Back Office

  • Store Inventory Management

  • Returns Management

  • Bill Pay

  • Orders


Figure A-14 Order Integrations


This window is only displayed if Orders is selected in the Integrate Applications window.

The field in this window is described in the following table:

Details Content
Field Title Please select the order integration type
Field Description Select the type of orders to be used:
  • External Order

  • Commerce Anywhere

Example External Order

Figure A-15 Commerce Anywhere Add-on Features


This window is only displayed if Commerce Anywhere is selected in the Order Integrations window.

The field in this window is described in the following table:

Details Content
Field Title Please select the Commerce Anywhere Add-on features
Field Description Select the Commerce Anywhere features that will be used in Mobile Point-of-Service:
  • To use the Assisted Selling Application (ASA), select Assisted Selling.

    Note: This feature is not tested in Release 14.1.

  • To use integrated commerce, select Integrated Commerce Enablement.


Figure A-16 Oracle Returns Management Messaging


This window is only displayed if Returns Management is selected in the Integrate Applications window.

The field in this window is described in the following table:

Details Content
Field Title Select result messaging option for Oracle RM
Field Description Choose the method to use to send return result messages to Oracle Retail Returns Management:
  • If you want messages sent to a JMS queue, choose JMS Queue.

  • If you want to use a web service to send the messages, choose Web Service.


Figure A-17 Secure Options


The fields in this window are described in the following tables:

Details Content
Field Title Enable Secure JDBC?
Field Description Select whether secure JDBC is to be used for communication with the database.
Example Yes

Details Content
Field Title Enable Secure RMI?
Field Description Select whether secure RMI is to be used for communication between the store server and registers.
Example Yes

Figure A-18 Database Owner


The fields in this window are described in the following tables:

Details Content
Field Title Schema Username
Field Description Schema user name that manages the objects in the schema. This user has Create, Drop, and Alter privileges in the schema, that is, Data Definition Language (DDL) execution privileges. For information on creating this user, see "Create the Database Schema Owner and Data Source Users" in Chapter 3.

Note: This user creates the database objects used by Point-of-Service.


Details Content
Field Title Schema Password
Field Description Password for the database owner.

Details Content
Field Title Confirm Password
Field Description Reentered Schema Password used to confirm the password.

Note: The passwords in the Schema Password and Confirm Password fields must match.


Figure A-19 Database Source User


The fields in this window are described in the following tables:

Details Content
Field Title JDBC Driver Path
Field Description Choose the path to the jar containing the database driver. This is the jar entered in the JDBC JAR field.

Note: The ojdbc6.jar file can be found in the <INSTALL-DIR>\product\server\common\db\lib

Example
  • Microsoft Windows:

    C:\oracle

  • Novell SLEPOS:

    /opt/oracle


Details Content
Field Title JDBC Driver Class
Field Description Enter the database driver class name.
Example oracle.jdbc.driver.OracleDriver

Details Content
Field Title JDBC URL
Field Description URL used by the Point-of-Service application to access the database schema. For the expected syntax, see Appendix E.

Note: If Enable Secure JDBC is selected in the Secure Options window, this URL is only used by the installer.

Example jdbc:oracle:thin:@DB_HOST_NAME:1521:DB_NAME

Details Content
Field Title Secure JDBC URL
Field Description Secure URL containing the specific parameters used by Point-of-Service to access the database schema. See Appendix E for the expected syntax.

This field is only displayed if Enable Secure JDBC is selected in the Secure Options window.

Example jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=tcps)(HOST=[host])(PORT=[tcpsPort]))(CONNECT_DATA=(SERVICE_NAME=[dbname])))

Details Content
Field Title JDBC JAR
Field Description Enter the name of the jar containing the database driver.
Example ojdbc6.jar

Details Content
Field Title Data Source Username
Field Description Database user name that can access and manipulate the data in the schema. This user can have Select, Insert, Update, Delete, and Execute privileges on objects in the schema, that is, Data Manipulation Language (DML) execution privileges. For information on creating this user, see "Create the Database Schema Owner and Data Source Users" in Chapter 3.

Note: This schema user is used by Point-of-Service to access the database.


Details Content
Field Title Data Source Password
Field Description Password for the data source user.

Details Content
Field Title Confirm Password
Field Description Reentered Data Source Password used to confirm the password.

Note: The passwords in the Data Source Password and Confirm Password fields must match.


Details Content
Field Title Tablespace Information for Tables
Field Description Name of the tablespace, associated with the data source user, which is used for tables. If this field is blank, tables are installed in the default tablespace.

Details Content
Field Title Tablespace Information for Indexes
Field Description Name of the tablespace, associated with the data source user, which is used for indexes. If this field is blank, indexes are installed in the default tablespace.

Figure A-20 Install Database Option


The field in this window is described in the following table:

Details Content
Field Title Select database installation option
Field Description The database schema must be created and populated before starting Point-of-Service. This window gives you the option to have the installer create and populate the database schema or leave the database schema unmodified.

Caution: If the database schema is already created and populated, select Skip schema creation and data loading. Selecting one of the other options will result in the loss of the data already in the database. If the database schema was created and populated using Back Office, reports data, and Back Office parameters will be lost.

  • To have the installer leave the database schema unchanged, select Skip schema creation and data loading.

  • To have the installer create and populate the database schema with the minimum dataset, select Create schema with minimum dataset.

  • To have the installer create and populate the database schema with the sample dataset, select Create schema with sample dataset.

For more information, see "Database Install Options" in Chapter 3.

Example Skip schema creation and data loading

Figure A-21 Sample Dataset


This window is only displayed when Create schema with sample dataset is selected in the Install Database Option window.

The field in this window is described in the following table:

Details Content
Field Title Sample dataset file
Field Description Enter the path to the sample dataset to be loaded into the database schema.

You can obtain the sample-dataset-14.1.zip file from the Oracle Software Delivery Cloud at the following web site:

https://edelivery.oracle.com/

For more information on the sample dataset, see "Database Install Options" in Chapter 3.

Example
  • Microsoft Windows:

    C:\oracle\retail\samples\sample-db.zip

  • Novell SLEPOS:

    /oracle/retail/samples/sample-db.zip


Figure A-22 Transaction Retrieval Location


This window is only displayed if Central Office/Back Office is selected in the Integrate Applications window.

The field in this window is described in the following table:

Details Content
Field Title Please select location for Transaction Retrieval
Field Description Choose the location for retrieving transactions.
  • If transactions should only be retrieved from the store database, choose Local.

  • If transactions should only be retrieved from the corporate database, choose Central.

  • If transactions should be retrieved from the corporate database, and if not found, then retrieved from the store database, choose Central, Local Failover.

Note: You must choose the same location for both the store server and client installations.

Example Local

Figure A-23 Scratchpad Database Information


This window is only displayed if Central or Central, Local Failover is selected in the Transaction Retrieval Location window.

The fields in this window are described in the following tables:

Details Content
Field Title JDBC Driver Path
Field Description Choose the path to the jar containing the database driver. This is the jar entered in the JDBC JAR field.
Example
  • Microsoft Windows:

    C:\oracle

  • Novell SLEPOS:

    /opt/oracle


Details Content
Field Title JDBC Driver Class
Field Description Enter the database driver class name.
Example oracle.jdbc.driver.OracleDriver

Details Content
Field Title JDBC URL
Field Description URL used by the Point-of-Service application to access the database schema. For the expected syntax, see Appendix E.

Note: If Enable Secure JDBC is selected in the Secure Options window, this URL is only used by the installer.

Example jdbc:oracle:thin:@DB_HOST_NAME:1521:DB_NAME

Details Content
Field Title Secure JDBC URL
Field Description Secure URL containing the specific parameters used by Point-of-Service to access the database schema. See Appendix E for the expected syntax.

This field is only displayed if Enable Secure JDBC is selected in the Secure Options window.

Example jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=tcps)(HOST=[host])(PORT=[tcpsPort]))(CONNECT_DATA=(SERVICE_NAME=[dbname])))

Details Content
Field Title JDBC JAR
Field Description Enter the name of the jar containing the database driver.
Example ojdbc6.jar

Details Content
Field Title Schema Username
Field Description Enter the database user that owns the scratchpad database.

Details Content
Field Title Schema Password
Field Description Password for the database owner.

Details Content
Field Title Confirm Password
Field Description Reentered Schema Password used to confirm the password.

Note: The passwords in the Schema Password and Confirm Password fields must match.


Details Content
Field Title Tablespace Information for Tables
Field Description Name of the tablespace, associated with the data source user, which is used for tables. If this field is blank, tables are installed in the default tablespace.

Details Content
Field Title Tablespace Information for Indexes
Field Description Name of the tablespace, associated with the data source user, which is used for indexes. If this field is blank, indexes are installed in the default tablespace.

Figure A-24 Scratchpad Database Install Options


This window is only displayed if Central or Central, Local Failover is selected in the Transaction Retrieval Location window.

The field in this window is described in the following table:

Details Content
Field Title Create the scratchpad database schema
Field Description Choose whether the installer creates the scratchpad database schema.
Example Yes

Figure A-25 Offline Derby Configuration


The fields in this window are described in the following tables:

Details Content
Field Title Offline Derby Username (Uppercase)
Field Description Enter the user name used for offline Derby processing. The user name must be in uppercase characters.

Details Content
Field Title Offline Derby Password
Field Description Enter the password for the offline Derby user.

Details Content
Field Title Confirm Password
Field Description Reentered Offline Derby Password used to confirm the password.

Note: The passwords in the Offline Derby Password and Confirm Password fields must match.


Details Content
Field Title Offline Derby Encryption Password
Field Description Enter the encryption password for the offline Derby user.

Details Content
Field Title Confirm Offline Derby Encryption Password
Field Description Reentered Offline Derby Encryption Password used to confirm the password.

Note: The passwords in the Offline Derby Encryption Password and Confirm Password fields must match.


Figure A-26 JVM Heap Size


The field in this window is described in the following table:

Details Content
Field Title Select the Maximum Heap Size
Field Description Select the maximum heap size for the offline database.

Note: The number of items in the offline database, as well as other factors, affect the amount of heap size required.

Example 512MB

Figure A-27 POS Administrator User


The fields in this window are described in the following tables:

Details Content
Field Title POS Administrator Username
Field Description Enter the user name used for performing Point-of-Service administrative functions.
Example pos

Details Content
Field Title POS Administrator Password
Field Description Enter the password for the administrator user.

Details Content
Field Title Confirm Password
Field Description Reentered POS Administrator Password used to confirm the password.

Note: The passwords in the POS Administrator Password and Confirm Password fields must match.


Figure A-28 POS-CO WebService Details


This window is only displayed if Central Office/Back Office is selected in the Integrate Applications window.

The fields in this window are described in the following tables:

Details Content
Field Title Central Office Server Hostname
Field Description Enter the host name for the Central Office web service.

Details Content
Field Title Central Office web service Username
Field Description Enter the user ID that is used to access the web service.

Note: The same Web Service Username that was entered when installing Central Office must be entered here. For more information, see the Oracle Retail Central Office Installation Guide.


Details Content
Field Title Central Office web service Password
Field Description Enter the password of the authorized user.

Note: The same Web Service Password that was entered when installing Central Office must be entered here. For more information, see the Oracle Retail Central Office Installation Guide.


Details Content
Field Title Confirm Password
Field Description Reentered Central Office web service Password used to confirm the password.

Note: The passwords in the Central Office web service Password and Confirm Password fields must match.


Details Content
Field Title Enable Secure Communication
Field Description Select Yes for web service communication with Central Office using HTTPS.
Example Yes

Details Content
Field Title Central Office Webs Service Port
Field Description Enter the port number for the Central Office web service.

Figure A-29 Server Journal Configuration


This window is only displayed if Central Office/Back Office is selected in the Integrate Applications window.

The field in this window is described in the following table:

Details Content
Field Title EJounal options
Field Description Select an option for journaling. Journal entries written to a JMS queue or web service are sent to the corporate office.
  • Write Journal Entries to JMS Queue

  • Write Journal Entries to a Web Service

  • Do not Write Journal Entries to CentralOffice

Example Write Journal Entries to a Web Service

Figure A-30 ORSIM Integration


This window is only displayed if Store Inventory Management is selected in the Integrate Applications window.

The field in this window is described in the following table:

Details Content
Field Title Please select the required SIM integration features
Field Description Select the Oracle Retail Store Inventory Management (SIM) features that will be used in Point-of-Service:
  • To inquire about inventory using SIM, select Inventory Inquiry.

  • To enable item baskets created using SIM, select Item Basket.

  • To enable validation of serial numbers using SIM, select Serial Number Validation.

  • To update inventory using SIM, select Inventory Update.


Figure A-31 ORSIM Inventory Update


This window is only displayed if Inventory Update is selected in the ORSIM Integration window.

The field in this window is described in the following table:

Details Content
Field Title Select inventory update method for Oracle SIM
Field Description Select the inventory update method used for SIM:
  • To use batch, select Batch.

  • To use a web service, select Web Service.


Figure A-32 Configure ORSIM Web Services - Security Policy


This window is only displayed if any features are selected in the ORSIM Integration window.

The field in this window is described in the following table:

Details Content
Field Title Select the security policy to use
Field Description Select the security policy certified by Oracle:
  • To use a user name token over https, select Policy A.

  • To use an encrypted user name token with an encrypted and signed body, select Policy B.

Example Policy A

Figure A-33 Configure ORSIM Web Services for Policy A


This window is only displayed Policy A is selected in the Configure ORSIM Web Services - Security Policy window.

The fields in this window are described in the following tables:

Details Content
Field Title ORSIM Server Hostname
Field Description Enter the host name for the Oracle Retail Store Inventory Management web server.

Details Content
Field Title ORSIM Web Service Username
Field Description Enter the user ID used to access the Oracle Retail Store Inventory Management web service.

Details Content
Field Title ORSIM Web Service Password
Field Description Enter the password used to access Oracle Retail Store Inventory Management web service.

Details Content
Field Title Confirm Password
Field Description Reentered ORSIM Web Service Password used to confirm the password.

Note: The passwords in the WebService Password and Confirm Password fields must match.


Details Content
Field Title ORSIM Web Service Port (https)
Field Description Enter the port number used to access Oracle Retail Store Inventory Management web service.

Figure A-34 Configure ORSIM Web Services for Policy B


This window is only displayed Policy B is selected in the Configure ORSIM Web Services - Security Policy window.

The fields in this window are described in the following tables:

Details Content
Field Title ORSIM Server Hostname
Field Description Enter the host name for the Oracle Retail Store Inventory Management web server.

Details Content
Field Title ORSIM Web Service Username
Field Description Enter the user ID used to access the Oracle Retail Store Inventory Management web service.

Details Content
Field Title ORSIM Web Service Password
Field Description Enter the password used to access Oracle Retail Store Inventory Management web service.

Details Content
Field Title Confirm Password
Field Description Reentered ORSIM Web Service Password used to confirm the password.

Note: The passwords in the WebService Password and Confirm Password fields must match.


Details Content
Field Title Enable Secure Communication?
Field Description Select Yes for web service communication with Oracle Retail Store Inventory Management using HTTPS.
Example Yes

Details Content
Field Title ORSIM Web Service Port
Field Description Enter the port number used to access the Oracle Retail Store Inventory Management web service.

Details Content
Field Title Server Certificate Alias
Field Description Enter the alias for the server certificate used to access the Oracle Retail Store Inventory Management web service.

Figure A-35 Configure Commerce Anywhere Web Services - Security Policy


This window is only displayed if Orders in the Integrate Applications window and then Commerce Anywhere is selected in the Order Integrations window.

The field in this window is described in the following table:

Details Content
Field Title Select the security policy to use
Field Description Select the security policy certified by Oracle:
  • To use a user name token over https, select Policy A.

  • To use an encrypted user name token with an encrypted and signed body, select Policy B.

  • To use un-encrypted http, select None.

Example Policy A

Figure A-36 Configure Commerce Anywhere Web Services - Inventory for Policy A


This window is only displayed if Policy A is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The fields in this window are described in the following tables:

Details Content
Field Title Endpoint
Field Description Entry point to the Commerce Anywhere Inventory web service.
Example https://HOST[:PORT]/InvAvailableToPromiseBean/InvAvailableToPromiseService

Details Content
Field Title Username
Field Description User name for the Commerce Anywhere Customer Inventory web service.

Details Content
Field Title Password
Field Description Password for the user.

Details Content
Field Title Confirm Password
Field Description Reentered Password used to confirm the password.

Note: The passwords in the Password and Confirm Password fields must match.


Figure A-37 Configure Commerce Anywhere Web Services - Customer for Policy A


This window is only displayed if Policy A is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The fields in this window are described in the following tables:

Details Content
Field Title Endpoint
Field Description Entry point to the Commerce Anywhere Customer web service.
Example https://HOST[:PORT]/CustomerBean/CustomerService

Details Content
Field Title Username
Field Description User name for the Commerce Anywhere Customer web service.

Details Content
Field Title Password
Field Description Password for the user.

Details Content
Field Title Confirm Password
Field Description Reentered Password used to confirm the password.

Note: The passwords in the Password and Confirm Password fields must match.


Figure A-38 Configure Commerce Anywhere Web Services - Customer Order for Policy A


This window is only displayed if Policy A is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The fields in this window are described in the following tables:

Details Content
Field Title Endpoint
Field Description Entry point to the Commerce Anywhere Customer Order web service.
Example https://HOST[:PORT]/CustomerOrderBean/CustomerOrderService

Details Content
Field Title Username
Field Description User name for the Commerce Anywhere Customer Order web service.

Details Content
Field Title Password
Field Description Password for the user.

Details Content
Field Title Confirm Password
Field Description Reentered Password used to confirm the password.

Note: The passwords in the Password and Confirm Password fields must match.


Figure A-39 Configure Commerce Anywhere Web Services - Shipping for Policy A


This window is only displayed if Policy A is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The fields in this window are described in the following tables:

Details Content
Field Title Endpoint
Field Description Entry point to the Commerce Anywhere Shipping web service.
Example https://HOST[:PORT]/ShippingOptionsBean/ShippingOptionsService

Details Content
Field Title Username
Field Description User name for the Commerce Anywhere Shipping web service.

Details Content
Field Title Password
Field Description Password for the user.

Details Content
Field Title Confirm Password
Field Description Reentered Password used to confirm the password.

Note: The passwords in the Password and Confirm Password fields must match.


Figure A-40 Configure ICE Web Services - Extended Item for Policy A


This window is only displayed if Orders is selected in the Integrate
Application window and then Integrated Commerce Enablement is selected in the Order Integrations window and Policy A is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The field in this window is described in the following table:

Details Content
Field Title Endpoint
Field Description Entry point to the ICE Extended Item web service.
Example https://HOST[:PORT]/ExtendedItemDataServiceBean/ExtendedItemDataService

Figure A-41 Configure ICE Web Services - Extended Customer for Policy A


This window is only displayed if Orders is selected in the Integrate
Application window and then Integrated Commerce Enablement is selected in the Order Integrations window and Policy A is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The field in this window is described in the following table:

Details Content
Field Title Endpoint
Field Description Entry point to the ICE Extended Customer web service.
Example https://HOST[:PORT]/ExtendedCustomerDataServiceBean/ExtendedCustomerDataService

Figure A-42 Configure Commerce Anywhere Web Services - Security for Policy B


This window is only displayed if Policy B is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The field in this window is described in the following table:

Details Content
Field Title Enable Secure Communication?
Field Description Select Yes for web service communication with Commerce Anywhere using HTTPS.
Example Yes

Figure A-43 Configure Commerce Anywhere Web Services - Inventory for Policy B


This window is only displayed if Policy B is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The fields in this window are described in the following tables:

Details Content
Field Title Endpoint
Field Description Entry point to the Commerce Anywhere Inventory web service.
Example https://HOST[:PORT]/InvAvailableToPromiseBean/InvAvailableToPromiseService

Details Content
Field Title Username
Field Description User name for the Commerce Anywhere Customer Inventory web service.

Details Content
Field Title Password
Field Description Password for the user.

Details Content
Field Title Confirm Password
Field Description Reentered Password used to confirm the password.

Note: The passwords in the Password and Confirm Password fields must match.


Details Content
Field Title Server certificate alias
Field Description Alias used for the server key.

Figure A-44 Configure Commerce Anywhere Web Services - Customer for Policy B


This window is only displayed if Policy B is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The fields in this window are described in the following tables:

Details Content
Field Title Endpoint
Field Description Entry point to the Commerce Anywhere web service.
Example https://HOST[:PORT]/CustomerBean/CustomerService

Details Content
Field Title Username
Field Description User name for the Commerce Anywhere Customer web service.

Details Content
Field Title Password
Field Description Password for the user.

Details Content
Field Title Confirm Password
Field Description Reentered Password used to confirm the password.

Note: The passwords in the Password and Confirm Password fields must match.


Details Content
Field Title Server certificate alias
Field Description Alias used for the server key.

Figure A-45 Configure Commerce Anywhere Web Services - Customer Order for Policy B


This window is only displayed if Policy B is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The fields in this window are described in the following tables:

Details Content
Field Title Endpoint
Field Description Entry point to the Commerce Anywhere Customer Order web service.
Example https://HOST[:PORT]/CustomerOrderBean/CustomerOrderService

Details Content
Field Title Username
Field Description User name for the Commerce Anywhere Customer Order web service.

Details Content
Field Title Password
Field Description Password for the user.

Details Content
Field Title Confirm Password
Field Description Reentered Password used to confirm the password.

Note: The passwords in the Password and Confirm Password fields must match.


Details Content
Field Title Server certificate alias
Field Description Alias used for the server key.

Figure A-46 Configure Commerce Anywhere Web Services - Shipping for Policy B


This window is only displayed if Policy B is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The fields in this window are described in the following tables:

Details Content
Field Title Endpoint
Field Description Entry point to the Commerce Anywhere Shipping web service.
Example https://HOST[:PORT]/ShippingOptionsBean/ShippingOptionsService

Details Content
Field Title Username
Field Description User name for the Commerce Anywhere Shipping web service.

Details Content
Field Title Password
Field Description Password for the user.

Details Content
Field Title Confirm Password
Field Description Reentered Password used to confirm the password.

Note: The passwords in the Password and Confirm Password fields must match.


Details Content
Field Title Server certificate alias
Field Description Alias used for the server key.

Figure A-47 Configure ICE Web Services - Extended Item for Policy B


This window is only displayed if Orders is selected in the Integrate
Application window and then Integrated Commerce Enablement is selected in the Order Integrations window and Policy B is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The field in this window is described in the following table:

Details Content
Field Title Endpoint
Field Description Entry point to the ICE Extended Item web service.
Example https://HOST[:PORT]/ExtendedItemDataServiceBean/ExtendedItemDataService

Figure A-48 Configure ICE Web Services - Extended Customer for Policy B


This window is only displayed if Orders is selected in the Integrate
Application window and then Integrated Commerce Enablement is selected in the Order Integrations window and Policy B is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The field in this window is described in the following table:

Details Content
Field Title Endpoint
Field Description Entry point to the ICE Extended Customer web service.
Example https://HOST[:PORT]/ExtendedCustomerDataServiceBean/ExtendedCustomerDataService

Figure A-49 Configure Commerce Anywhere Web Services - Inventory for Policy None


This window is only displayed if None is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The field in this window is described in the following table:

Details Content
Field Title Endpoint
Field Description Entry point to the Commerce Anywhere Inventory web service.
Example http://HOST[:PORT]/InvAvailableToPromiseBean/InvAvailableToPromiseService

Figure A-50 Configure Commerce Anywhere Web Services - Customer for Policy None


This window is only displayed if None is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The field in this window is described in the following table:

Details Content
Field Title Endpoint
Field Description Entry point to the Commerce Anywhere web service.
Example http://HOST[:PORT]/CustomerBean/CustomerService

Figure A-51 Configure Commerce Anywhere Web Services - Customer Order for Policy None


This window is only displayed if None is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The field in this window is described in the following table:

Details Content
Field Title Endpoint
Field Description Entry point to the Commerce Anywhere Customer Order web service.
Example http://HOST[:PORT]/CustomerOrderBean/CustomerOrderService

Figure A-52 Configure Commerce Anywhere Web Services - Shipping for Policy None


This window is only displayed if None is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The fields in this window are described in the following tables:

Details Content
Field Title Endpoint
Field Description Entry point to the Commerce Anywhere Shipping web service.
Example http://HOST[:PORT]/ShippingOptionsBean/ShippingOptionsService

Figure A-53 Configure ICE Web Services - Extended Item for Policy None


This window is only displayed if Orders is selected in the Integrate
Application window and then Integrated Commerce Enablement is selected in the Order Integrations window and None is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The field in this window is described in the following table:

Details Content
Field Title Endpoint
Field Description Entry point to the ICE Extended Item web service.
Example http://HOST[:PORT]/ExtendedItemDataServiceBean/ExtendedItemDataService

Figure A-54 Configure ICE Web Services - Extended Customer for Policy None


This window is only displayed if Orders is selected in the Integrate
Application window and then Integrated Commerce Enablement is selected in the Order Integrations window and None is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The field in this window is described in the following table:

Details Content
Field Title Endpoint
Field Description Entry point to the ICE Extended Customer web service.
Example http://HOST[:PORT]/ExtendedCustomerDataServiceBean/ExtendedCustomerDataService

Figure A-55 Enable POS - External Order Web Service Access Over SSL


This window is only displayed if Orders and then External Order are selected in the Integrate Applications window.

The field in this window is described in the following table:

Details Content
Field Title Enable Secure Communication?
Field Description Select Yes if web service communication with the external order management is using HTTPS.
Example Yes

Figure A-56 POS - External Order Web Service Authentication Type


This window is only displayed if Orders and then External Order are selected in the Integrate Applications window.

The field in this window is described in the following table:

Details Content
Field Title Authentication Type?
Field Description
  • To use Siebel-specific authentication, select Siebel.
  • To send and receive user credentials in a standards-compliant manner, select WS-Security.

Note: Only select Siebel if Point-of-Service is integrated with Siebel 8.1.1.3 and is configured to use Siebel web service authentication.


Figure A-57 POS - External Order Configuration


This window is only displayed if Orders and then External Order are selected in the Integrate Applications window.

The fields in this window are described in the following tables:

Details Content
Field Title Enter the External Order Web Service Endpoint URL
Field Description Enter the URL used by the Point-of-Service application to access the external order management system.
Example https://HOST[:PORT]/eai_secure_enu/start.swe?SWEExtSource=SecureWebService&SWEExtCmd=Execute&WSSOAP=1

Details Content
Field Title User Id authorized to access my store
Field Description Enter the user ID for the user authorized to access my store.

Details Content
Field Title Password of my store authorized user
Field Description Enter the password for accessing my store.

Details Content
Field Title Confirm Password
Field Description Reentered password of my store authorized user used to confirm the password.

Note: The passwords in the Password of my store authorized user and Confirm Password fields must match.


Details Content
Field Title User Id authorized to access all stores
Field Description Enter the user ID for the user authorized to access all stores.

Details Content
Field Title Password of all stores authorized user
Field Description Enter the password for the accessing all stores.

Details Content
Field Title Confirm Password
Field Description Reentered password of all stores authorized user used to confirm the password.

Note: The passwords in the Password of all stores authorized user and Confirm Password fields must match.


Figure A-58 Returns Management Security


This window is only displayed if Returns Management is selected in the Integrate Applications window and JMS Queue is selected in the Oracle Returns Management Messaging window.

The field in this window is described in the following table:

Details Content
Field Title Enable Secure JMS Communication for Returns Management?
Field Description Select whether secure JMS communication is used:
  • To use secure communication, choose Yes.

  • To not use secure communication, choose No.

Example Yes

Figure A-59 Oracle Returns Management JMS Configuration


This window is only displayed if Returns Management is selected in the Integrate Applications window and JMS Queue is selected in the Oracle Returns Management Messaging window.

The fields in this window are described in the following table:

Details Content
Field Title JMS Server Name
Field Description Enter the name for the JMS server.

Details Content
Field Title Weblogic Application Server JMS port
Field Description Enter the port number of the JMS server to use to send return result messages to Oracle Retail Returns Management.
Example 7002

Details Content
Field Title User Id authorized to access JMS Server
Field Description Enter the user ID that is used to access the JMS Server.

Details Content
Field Title Password of authorized user
Field Description Enter the password of the authorized user.

Details Content
Field Title Confirm Password
Field Description Reentered Password of authorized user used to confirm the password.

Note: The passwords in the Password of authorized user and Confirm Password fields must match.


Figure A-60 RM-POS Web Service Details


This window is only displayed if Returns Management is selected in the Integrate Applications window and Web Service is selected in the Oracle Returns Management Messaging window.

The fields in this window are described in the following tables:

Details Content
Field Title Returns Management server hostname
Field Description Enter the host name for the Oracle Retail Returns Management server.

Details Content
Field Title User Id authorized to access webservice
Field Description Enter the user ID that is used to access the web service.

Note: The same Web Service Username that was entered when installing Returns Management must be entered here. For more information, see the Oracle Retail Returns Management Installation Guide.


Details Content
Field Title Password of authorized user
Field Description Enter the password of the authorized user.

Note: The same Web Service Password that was entered when installing Returns Management must be entered here. For more information, see the Oracle Retail Returns Management Installation Guide.


Details Content
Field Title Confirm Password
Field Description Reentered Password of authorized user used to confirm the password.

Note: The passwords in the Password of authorized user and Confirm Password fields must match.


Details Content
Field Title Enable Secure Communication?
Field Description Choose whether secure communication over HTTPS is used.

Details Content
Field Title Returns Management Web Service port
Field Description Enter the port number for the Oracle Retail Returns Management web service.
Example 7001

Figure A-61 Enable Value-Added Tax (VAT)


The field in this window is described in the following table:

Details Content
Field Title Enable Value-Added Tax?
Field Description Select Yes if Value-Added Tax is used.
Example No

Figure A-62 Enable RTLog Export


The field in this window is described in the following table:

Details Content
Field Title Please select RTLog export options
Field Description Choose how the RTLog is to be exported.
  • To not export the log, choose Do not export RTLog.

  • To export the log, choose Export RTLog.

Example Do not export RTLog

Figure A-63 Security Setup: Key Manager Settings


This window is used to configure the Encryption Key Manager.

The fields in this window are described in the following tables:

Details Content
Field Title Hash Algorithm
Field Description Name of the algorithm used by the Key Manager to hash sensitive data.
Example SHA-256

Details Content
Field Title Select Key Manager
Field Description Provider for Key Store management:
  • RSA Data Protection Manager package, select RSA Data Protection Manager. The next window displayed is Figure A-64.

  • To use the simulated key management package, select Simulator. The next window displayed is Figure A-67.

Example RSA Data Protection Manager

Figure A-64 RSA Key Manager Requirements


This window is only displayed if RSA Data Protection Manager is selected in the Security Setup: Key Manager window. This informational window explains the requirements needed to use the RSA Data Protection Manager. Verify that you meet the requirements and then click Next.

Figure A-65 RSA Client JAR Files


This window is only displayed if RSA Data Protection Manager is selected in the Security Setup: Key Manager window.

The field in this window is described in the following table:

Details Content
Field Title RSA Client JAR Files Directory
Field Description Choose the directory where the following RSA client jar files are located:
  • cryptojce.jar

  • cryptojcommon.jar

  • jcm.jar

  • jcmFIPS.jar

  • kmsclient.jar

  • LB.jar

  • LBJNI.jar

  • sslj.jar

Example
  • Microsoft Windows:

    C:\rsa\java_binary\rlmc\lib

  • Novell SLEPOS:

    /opt/rsa/java_binary/rlmc/lib


Figure A-66 RSA Client Configuration


This window is only displayed if RSA Data Protection Manager is selected in the Security Setup: Key Manager window.

The fields in this window are described in the following tables:

Details Content
Field Title Cipher Key Class
Field Description Enter the name of the cipher suite that define the authentication and encryption algorithms that will be used by RSA to negotiate the security settings for the network connection.

Details Content
Field Title RSA Client Configuration File
Field Description Select the location of the RSA client configuration file. This file contains the details for configuring the RSA client.

Details Content
Field Title Generate a new client.app.name value
Field Description To have the installer generate a unique name for the client.app.name value in the RSA client configuration file, select Yes. To not change the value in the configuration file, select No.
Example No

Figure A-67 Key Store Pass Phrase


This window is only displayed if Simulator is selected in the Security Setup: Key Manager window.

The field in this window is described in the following table:

Details Content
Field Title Pass Phrase
Field Description Enter the pass phrase used to access the Key Store simulator.

Note: Use the same pass phrase for all Oracle Retail POS Suite applications in your configuration.


Details Content
Field Title Confirm Pass Phrase
Field Description Reentered Pass Phrase used to confirm the pass phrase.

Note: The pass phrases in the Pass Phrase and Confirm Pass Phrase fields must match.


Figure A-68 Logging Detail Options


The field in this window is described in the following table:

Details Content
Field Title Please select the logging detail
Field Description Choose the level of client logging:
  • To only log some of the messages, choose Standard Logging.

  • To log all of the messages, choose Verbose Logging.

Example Standard logging

Figure A-69 Logging Export Options


This window is only displayed if Central Office/Back Office is selected in the Integrate Applications window.

The field in this window is described in the following table:

Details Content
Field Title Please select logging export options
Field Description Choose how the log is to be exported.
  • To not generate any logs, choose Do not export Point-of-Service logs.

  • To export the logs to a file, choose Export Point-of-Service logs to a file.

  • To have the data pushed from the store to the corporate database using replication, choose Data Replication Export.

Note: If you are using Centralized Transaction Retrieval, you must select Data Replication Export.

Example Do not export Point-of-Service logs

Figure A-70 Data Replication Options


This window is only displayed if Data Replication Export is selected in the Logging Export Options window.

The field in this window is described in the following table:

Details Content
Field Title Select transport mode for Data Replication
Field Description Select the transport mode for data replication.
  • To use a JMS queue, choose Send through JMS.

  • To use a web service, choose Send through Webservice.

Example Send through WebService

Figure A-71 E-Mail Notification for Communication Failures


This window is only displayed if Send through Webservice is selected in the Data Replication Options window.

The fields in this window are described in the following tables:

Details Content
Field Title SMTP host
Field Description Host where the SMTP server is running.

Details Content
Field Title SMTP Port
Field Description Enter the SMTP port number.
Example 25

Details Content
Field Title From Address
Field Description Enter the address for sender of the e-mail.
Example orpos@example.com

Details Content
Field Title To Address (Comma Separated Addresses)
Field Description Enter the addresses for the recipients of the e-mail.

Figure A-72 Data Replication Transport JMS Options


This window is only displayed if Send through JMS is selected in the Data Replication Options window.

The field in this window is described in the following table:

Details Content
Field Title Use Local Queues?
Field Description Select whether local queues are used for JMS transport.
  • To use a local queue, choose Yes.

  • To not use a local queue, choose No.

Example Yes

Figure A-73 Back Office Security


This window is only displayed if Central Office/Back Office is selected in the Integrate Applications window.

The field in this window is described in the following table:

Details Content
Field Title Enable Secure Back Office Communications?
Field Description Select Yes if secure communication with Back Office is required.
Example Yes

Figure A-74 Central Office Security Information


This window is only displayed if Central Office/Back Office is selected in the Integrate Applications window.

The field in this window is described in the following table:

Details Content
Field Title Enable Secure Central Office Communications?
Field Description Select Yes if secure communication with Central Office is required.
Example Yes

Figure A-75 Back Office Server Information


This window is only displayed if Central Office/Back Office is selected in the Integrate Applications window.

The fields in this window are described in the following tables:

Details Content
Field Title Back Office Server Name
Field Description Enter the host name for the Back Office application.

Details Content
Field Title Back Office Server JNDI Secure Port
Field Description Enter the port number for the Back Office application. This is the port number that was selected when the Back Office domain was created.
Example 7002

Figure A-76 Tender Authorization


The field in this window is described in the following table:

Details Content
Field Title Please select the tender authorization method
Field Description Choose where tender authorizations are sent:
  • If approvals do not leave the store server and are based on values and certain numbers, choose Simulated.

  • If approvals are sent by the store server to a third-party system to approve the authorizations, choose ACI PIN Comm on Server, AJB on Server, or PXP Solutions ANYpay POS.

  • If approvals are handled by the client, select ACI PIN Comm on Client or AJB on Client.

Note: If the store server is located at a remote location, it is highly recommended to configure ACI PINComm or AJB at each client in order to help minimize network delay.

Note: Demo installations should use the Simulated option.

Example Simulated

Figure A-77 Tender Authorization: ACI PIN Comm


This window is only displayed if ACI PIN Comm on Server is selected in the Tender Authorization window.

The fields in this window are described in the following tables:

Details Content
Field Title ACI ToolKit JAR Location
Field Description Enter the path to the ACI ToolKit JAR file.
Example
  • Microsoft Windows:

    C:\aci-jars

  • Novell SLEPOS:

    /opt/aci-jars


Details Content
Field Title IMSRTRIBSpecSDK JAR
Field Description Enter the name of the IMSRTRIBSpecSDK JAR file.
Example IMSRTRIBSpecSDK-335a.jar

Details Content
Field Title MSPCommAPI JAR
Field Description Enter the name of the MSPCommAPI JAR file.
Example MSPCommAPI.jar

Details Content
Field Title Location (4-digit numeric value)
Field Description Enter the four digit numeric value for the location.
Example 4241

Details Content
Field Title Primary IP Address
Field Description Enter the primary IP address used for the communication between the store server and the tender authorizer.

Details Content
Field Title Primary Port
Field Description Enter the primary port number used for the communication between the store server and the tender authorizer.

Details Content
Field Title Secondary IP Address
Field Description Enter the secondary IP address used for the communication between the store server and the tender authorizer.

Details Content
Field Title Secondary Port
Field Description Enter the secondary port number used for the communication between the store server and the tender authorizer.

Details Content
Field Title Tertiary IP Address
Field Description Enter the tertiary IP address used for the communication between the store server and the tender authorizer.

Details Content
Field Title Tertiary Port
Field Description Enter the tertiary port number used for the communication between the store server and the tender authorizer.

Details Content
Field Title Image Capture Web Service URI
Field Description Enter the address of the Image Capture web service.
Example http://HOST:PORT/PATH_TO_WEBSERVICE

Details Content
Field Title Enable Secure Communication with PIN Comm?
Field Description Select Yes for communication with ACI PINComm using HTTPS.
Example Yes

Figure A-78 Tender Authorization: AJB


This window is only displayed if AJB on Server is selected in the Tender Authorization window.

The fields in this window are described in the following tables:

Details Content
Field Title AJB JAR Location
Field Description Enter the path to the AJB JAR file.
Example
  • Microsoft Windows:

    C:\ajb-jars

  • Novell SLEPOS:

    /opt/ajb-jars


Details Content
Field Title CAFipay JAR
Field Description Enter the name of the CAFipay JAR file.
Example AJBComm.jar

Details Content
Field Title IP Address
Field Description Enter the IP address used for the communication between the store server and the tender authorizer.
Example 127.0.0.1

Details Content
Field Title Port
Field Description Enter the port number used for the communication between the store server and the tender authorizer.
Example 23999

Details Content
Field Title Enable EMV with AJB?
Field Description Select whether Europay, MasterCard, and Visa (EMV) is enabled with AJB:
  • To enable EMV, select Yes.

  • To not enable EMV, select No.

Example No

Figure A-79 Key Store Details


This window is displayed if Policy B is selected in the Configure Commerce Anywhere Web Services - Security Policy window.

The fields in this window are described in the following tables:

Details Content
Field Title Key Store Location and File
Field Description Enter the location and name of the Key Store.

Details Content
Field Title Key Store Password
Field Description Enter the password for the Key Store.

Details Content
Field Title Confirm Password
Field Description Reentered Key Store Password used to confirm the password.

Note: The passwords in the Key Store Password and Confirm Password fields must match.


Details Content
Field Title Client Key Alias
Field Description Enter the alias for the client key.

Details Content
Field Title Client Key Password
Field Description Enter the password for the client key.

Details Content
Field Title Confirm Password
Field Description Reentered Client Key Password used to confirm the password.

Note: The passwords in the Client Key Password and Confirm Password fields must match.


Figure A-80 SSL Key Store Details


This window is displayed depending on the security options selected.

The fields in this window are described in the following tables:

Details Content
Field Title SSL Key Store Location and File
Field Description Enter the location and name of the Key Store.

Details Content
Field Title SSL Key Store Password
Field Description Enter the password for the Key Store.

Details Content
Field Title Confirm Password
Field Description Reentered SSL Key Store Password used to confirm the password.

Note: The passwords in the SSL Key Store Password and Confirm Password fields must match.


Figure A-81 SSL Trust Store Details


The fields in this window are described in the following tables:

Details Content
Field Title SSL Truststore Location and File
Field Description Enter the location and name of the truststore file.
Example
  • Microsoft Windows:

    C:\Program Files\Java\jre7\lib\security\cacerts

  • Novell SLEPOS:

    /opt/Java/jre7/lib/security\cacerts


Details Content
Field Title SSL Trust Store Password (optional)
Field Description Enter the password for the truststore.

Details Content
Field Title Confirm Password
Field Description Reentered SSL Trust Store Password used to confirm the password.

Note: The passwords in the SSL Trust Store Password and Confirm Password fields must match.


Figure A-82 Installation Progress


Figure A-83 Install Complete