Oracle_Retail_Xstore_Suite_Install.pdf

Oracle Retail Xstore Suite Install
Oracle Pluggable Database

Oracle Retail Xstore Software Suite Install
Document overview
Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential—Oracle Internal
3
This document will provide instructions on how to install the Oracle Retail Xstore Software Suite.
Covering the following:
1.) Oracle Database 12c PDB install
2.) JRE Packager / Java JDK Install
3.) Creation of Certificates
4.) Xstore Office Database Creation
5.) Xstore Officer Software Install
6.) Xstore POS Software Install

Step 1 of 9
Configure Security Updates
1.) Uncheck – I wish to receive security updates
via My Oracle Support and select Next.
2.) When prompted that no email address was
provided click Yes
4

Step 2 of 9
Select Install Option
1.) Choose Create and configure a database
2.) Click Next
5

Step 3 of 9
Select System Class
1.) Select Desktop class
2.) Click Next
6

Step 4 of 9
Specify Oracle Home User
1.) Select Use Windows Built-in Account
2.) Click Next
3.) Click Yes at the Are you sure you want to
continue? prompt
7

Step 5 of 9
Typical Install Configuration
1.) Change Global database name to orclcdb
2.) For the password , type in pos twice and
click Next
3.) Click Yes at the Are you sure you want to
continue? prompt
8

Remaining steps
1.) The installer will run Prerequisite checks
2.) After the checks you will be presented with
a summary screen.
3.) Click Install. Once the install is finished you
can exit the installer.
Oracle Database 12c should now be installed
9

JRE Packager install
The following files are needed in order to install
Java JDK and Java in order to use Xcenter and
Xstore.
Files required are:
1.) Java 8 JCE Policy
2.) Java 8 32-bit Windows TAR archive
3.) Java 8 JDK x64 Windows installer
4.) Xstore 16 JRE Packager Jar
The first 3 files can be obtained directly from
Oracle’s website.
The JRE packager JAR is pulled from the Oracle
Xstore Office package under the
oraclepdb_install_upgrade path.
10

1.) Extract the Xstore Office package
2.) Navigate to the toolsjrepackager folder
3.) Copy the jce_policy_8 and the JRE 8
Windows tar.gz file into that same folder.
4.) At a dos prompt type: java –jar xstore-
16.0.0.1.848-0.0.0-XST-jrepackager.jar GUI and
press enter
11

1.) Choose the correct path to the JRE 8
windows tar.gz file
2.) Do the same for the JCE 8 zip archive
3.) Click Next and the utility will create a new
archive.
4.) At a dos prompt type: java –jar xstore-
16.0.0.1.848-0.0.0-XST-jrepackager.jar GUI and
press enter
5.) Once completed a new ZIP file will be
created. Extract the JRE folder from the XST-jre-
1.8.0###.zip to c:
12

Java 8 JDK for Windows
Install
1.) Download the Java 8 JDK Windows x64
package from the Oracle website and install it.
2.) Open the jce_policy-8.zip and extract the
local_policy and US_export_policy files to
your JDK ‘s security folder.
Path should be:
C:program
filesJavajdk1.8.0_###jrelibsecurity
Overwrite any files if prompted.
13

Java 8 JDK for Windows
Install
1.) Go into your Windows system properties and
click on Environment Variables
2.) Under System Variables select New and input
Variable name: JAVA_HOME
Variable value: C:Program FilesJavajdk1.8.0_###
Then click OK
3.) Find the Variable Path and click Edit and add the
following to the beginning of the Path
C:Program FilesJavajdk1.8.0_###bin;
Then click OK
4.) Reboot Windows so that these settings take
effect
14

Certification Creation
Certificated that need to be created are:
1.) Xcenter
2.) Xstore-mobile
Each certificate will be create and self signed.
1.) Create folder c:certs
2.) Create folders c:certsxcenter ,
c:certsxstore-mobile.
Use the above folders to store the certificates
you’ve created.
15

Xcenter Certification
Creation
Create the Xcenter keystore
1.) keytool –genkey –keystore server.keystore –alias
xcenter-test –keyalg RSA –keysize 2048 –validity 395
2.) Enter keystore password allgoodthings
3.) Answer the following questions:
First an Last Name: localhost
Organizational Unit: xcenter-test
Organization Name: Oracle
City or Locality: Solon
State or Province Name: Ohio
Two-letter country code: US
4.) When prompted correct? Type yes and press enter.
5.) Press enter when asked for password to keep the same
password.
16

Xcenter Certification
Creation
Self-sign the certificate
1.) keytool –selfcert –alias xcenter-test –keystore
server.keystore –validity 395
2.) Enter in the password used to create the certificate
Export the certificate
1.) keytool –export –alias xcenter-test –keystore
server.keystore –rfc –file xcenter-test.cer
Create the Xstore .truststore
1.) keytool –import –file xcenter-test.cer –keystore
.truststore –alias xcenter-test
2.) Enter password allgoodthings , twice
3.) Trust this certificate? , answer yes and press enter
17

Xstore-mobile Certification
Creation
Create the Xcenter keystore
1.) keytool –genkey –keystore –alias xstoremobile-test –
keyalg RSA –keysize 2048 –validity 395
2.) Enter keystore password allgoodthings
3.) Answer the following questions:
First an Last Name: localhost
Organizational Unit: xstoremobile-test
Organization Name: Oracle
City or Locality: Solon
State or Province Name: Ohio
Two-letter country code: US
4.) When prompted correct? Type yes and press enter.
5.) Press enter when asked for password to keep the same
password.
18

Xstore-mobile Certification
Creation
Self-sign the certificate
1.) keytool –selfcert –alias xstoremobile-test –keystore
–validity 395
2.) Enter in the password used to create the certificate
3.) rename keystore to xstore_mobile.keystore
19

Xcenter database creation
SQL Files Required:
1.) db-create-xcenter.sql
2.) db-create-repqueue.sql
3.) db-create-xadmin.sql
4.) xstore-16.0.0.1.848-0.0.0-XST-xcenter-install-
SCHEMA.sql
SCHEMA-SYNONYM.sql
TEST_DATA_ORG-1000.sql
7.) xstore-16.0.0.1.848-0.0.0-XST-xadmin-install.sql
8.) xstore-16.0.0.1.848-0.0.0-XST-xcenterrepl-install-
SCHEMA.sql
20

xcenter
Edit and Execute db-create-xcenter.sql
1.) Open db-create-xcenter.sql in a text editor
2.) Under Create Xstore PDB edit FILE_NAME_CONVERT
to point to the Oracle path
3.) Under Data and Index edit the XCENTER_DATA and
XCENTER_INDEX to point to the correct Oracle path
4.) Save the sql file
5.) At a DOS prompt execute the script:
sqlplus / as sysdba @ db-create-xcenter.sql
21

xcenterreplication
Edit and Execute db-create-repqueue.sql
1.) Open db-create-repqueue.sql in a text editor
3.) Under Data and Index edit the REPQUEUE_DATA
and REPQUEUE_INDEX to point to the correct Oracle
path
sqlplus / as sysdba @ db-create-repqueue.sql
22

xadmin_test
Edit and Execute db-create-xadmin.sql
1.) Open db-create-xadmin.sql in a text editor
3.) Under Data and Index edit the XADMIN_DATA and
XADMIN_INDEX to point to the correct Oracle path
sqlplus / as sysdba @ db-create-xadmin.sql
23

xcenter_test
Edit and Execute xstore-16.0.0.1.848-0.0.0-XST-
xcenter-install-schema.sql
1.) Open xstore-16.0.0.1.848-0.0.0-XST-xcenter-
schema.sql in a text editor
2.) Find and update all xstore_ to xcenter_
sqlplus dtv/dtv@localhost:1521/xcenter @xstore-
16.0.0.1.848-0.0.0-XST-xcenter-install-schema.sql
24

xcenter_test
Load data into Xcenter database
1.) At a DOS prompt run:
Sqlplus dtv/dtv@localhost:1521/xcenter @xstore-16.0.0.1.848-0.0.0-XST-xcenter-install-SCHEMA-SYNONYM.sql
2.) At a DOS prompt run:
Sqlplus dtv/dtv@localhost:1521/xcenter @xstore-16.0.0.1.848-0.0.0-XST-xcenter-install-TEST_DATA_ORG-1000.sql
The Xcenter database has been successfully created
25

xadmin & xcenterreplication
Load data into the Xadmin and Xcenter Replicaiton databases
1.) At a DOS prompt run to populate the xcenterreplication database
Sqlplus repqueue/repqueue@localhost:1521/xcenterreplication @xstore-16.0.0.1.848-0.0.0-XST-xcenterrepl-install-
SCHEMA.sql
2.) At a DOS prompt run to populate the xadmin database.
Sqlplus xadmin/xadmin@localhost:1521/xadmin @xstore-16.0.0.1.848-0.0.0-XST-xadmin-install.sql
The Xadmin and Xcenter Replication databases are now complete.
26

Genkeys Install
1.) Extract the contents of the genkeys folder into a local temporary folder.
2.) At a DOS prompt type in
Java –jar xstore-16.0.0.1.848-0.0.0-XST-genkeys.jar
This will install genkeys program to the root of your C: drive
The path to this archive is listed below in the picture example
27

Xcenter Jetty Install
1) The following files will need to be copied into the same folder
together.
Jetty-9.3.6-insallter.jar – located in the webcontainers.zip in the
Xstore Office archive
Ant.install.properities – located in the webcontainers.zip in the
Xstore Office archive – not needed , may not be present
CIP files – located in the xstore-genkeysreskeys
Server.keystore – the certificate that was created for Xcenter
War files – located in the Xstore Office archive under
oraclepdb_install,upgrade.ziporaclepdb_install,upgradeOracleRet
ailXstoreOffice_16_0_0_1_848_XST_0_0_0.zip16.0.0.1.848_0.0.0xcent
er folder
Xcenter-config - located in the Xstore Office archive under
oraclepdb_install,upgrade.ziporaclepdb_install,upgradeOracleRet
ailXstoreOffice_16_0_0_1_848_XST_0_0_0.zip16.0.0.1.848_0.0.0xcent
er folder
2.) At a DOS prompt type java –jar jetty-9.3.6-install.jar GUI
28

Install Location
1.) Use default , click Next and create the directory when prompted
Jetty SSL Configuration
Java Keystore: Should already be pointed to server.keystore
Keystore Passoword: allgoodthings
Confirm: allgoodthings
SSL Key Alias: xcenter-test
1.) Click Next
Jetty Memory Configuration
Xms/Xmx Value: 2048
1.) Click Next
2.) Click Next at Jetty Configuration
3.) Uncheck Start Jetty After Installation , click Next
29

Xcenter Authentication Configuration
Username: xcenter
Password: xcenter123
Confirm: xcenter123
1.) Click Next
2.) Application War Files , click Next
3.) Xcenter Config File , click Next
4.) Cipher Files, click Next
5.) Click Install
30

xcenter-config setup
Updating xcenter.properties file
1.) Open xcenter-configxcenter.properties
2.) Change the following properties in this file:
xcenter.org.id=1000
Jvm.preferIPV4Stack=true (uncomment this option)
Comment out all dtv database URLs and enable those for PBD
Oracle PDB Connections should be updated to:
Xcenter
# dtv.local.db.url=jdbc:oracle:thin:@localhost:1521:xcenter
# PDB
dtv.local.db.url=jdbc:oracle:thin:@localhost:1521/xcenter
dtv.local.db.user=Pj4+MAAAAADht/AjIKKaoMs9q1pp4qTU
dtv.local.db.password=Pj4+MAAAAADht/AjIKKaoMs9q1pp4qTU
Xadmin
# dtv.xadmin.db.url=jdbc:oracle:thin:@localhost:1521:xcenter
# PDB
dtv.xadmin.db.url=jdbc:oracle:thin:@localhost:1521/xadmin
dtv.xadmin.db.user=Pj4+MAAAAABHmG8UHtUVWdRlmNEvvHNl
dtv.xadmin.db.password=Pj4+MAAAAABHmG8UHtUVWdRlmNEvvHNl
31
Xcenterreplication
# dtv.xcrepl.db.url=jdbc:oracle:thin:@localhost:1521:xcenter
# PDB
dtv.xcrepl.db.url=jdbc:oracle:thin:@localhost:1521/xcenterreplication
dtv.xcrepl.db.user=Pj4+MAAAAABFjttUmfLXHy6TE+5sPrlb
dtv.xcrepl.db.password=Pj4+MAAAAABFjttUmfLXHy6TE+5sPrlb
3.) Once these changes have been made , save the file

Log4j2.xml setup
Updating xadmin-log4j2.xml
1.) Open xcenter-configxadmin-log4j2.xml
2.) Change the following to look like:
<Configuration status="WARN">
<Properties>

<Property name="log.dir.name">${sys:jetty.logs}</Property>

</Properties>
3.) Save the file
This will enable proper Jetty logging for Xadmin
32

Log4j2.xml setup
Updating xcenter-log4j2.xml
1.) Open xcenter-configxcenter-log4j2.xml
2.) Change the following to look like:
<Configuration status="WARN">
<Properties>

<Property name="log.dir.name">${sys:jetty.logs}</Property>

</Properties>
3.) Save the file
This will enable proper Jetty logging for Xcenter
33

Starting Jetty
1.) In Windows Services , Start the Jetty service
2.) Check the logs located in jetty-9.3.6logs for any
errors
3.) If the service started up you should see bootstrap
status = OK in the logs
4.) Smoke test Xcenter by going to the following URL:
https://localhost:8443/xcenter/dtx/GetById?NAME=It
em&ID=1000::1005::*::*
5.) Test Xadmin by going to the following URL:
https://localhost:8443/xadmin
User Name: 1 Password: 1111
34

Xstore Install
Xstore POS Package is Patch #25734772
1) The following files will need to be copied into the same folder
together.
ant.install.properties
xstore-16.0.1.848-0.0.0-0.0-XST-pos-install.jar
The two file above can be found in the Xstore POS installer archive.
oraclepdb_install,upgrade.ziporaclepdb_install,upgradeOracleReta
ilXstorePointofService_16_0_0_1_848_XST_0_0_0.zip16.0.0.1.848_0.0.
0pos
xstore_mobile.keystore – the certificate created earlier for Xstore
Mobile
2.) At a DOS prompt type java –jar xstore-16.0.1.848-0.0.0-0.0-XST-
pos-install.jar GUI
35

Xstore Install
Install Location
1.) Keep install directly to it’s default setting
2.) Database install directory should point to your Oracle PBD
orclcdb location
For example:
c:app(windows user)oradataorclcdb
3.) Other settings:
Local database present? Yes
Environment: Test
Advanced installation option: Xstore Mobile
4.) Click Next and select Yes to create the Xstore directory
36

Xstore Install
Location Settings
1.) Leave default settings and click Next
Miscellaneous Settings
Xstore Mobile Settings
1.) Enter the following other than the default values:
Register #: 31
Server Key Alias: xstoremobile-test
Server Keystore Password (OBF):
OBF:1v1p1uv81w8t1u9p1vnq1y0q1sov1y101vnc1u9t1w8x1uuy1v2p
Disable Tablet startup?: Yes (Checked off)
2.) Click Next , Yes to create the directory
37

Xstore Install
Email Server
Xstore Configuration Path
Data Sources
1.) Uncheck Customer Engagement and click Next
Xcenter Application Server Settings
1.) Enter in the following settings
App Server Username:Pj4+MAAAAAAcvTjVTHaNT3W5QZN4DqKe
App Server Password:Pj4+MAAAAACWrJ1C02SoH1ZJYmC+6xGG
2.) Leave everything else default and then click Next
38

Xstore Install
StorePrimary Data Source Settings
Local Data Source Settings
Replication Data Source Settings
1.) Change the following settings:
Replication Database: xstorereplication
2.) Leave the remaining as default and click Next
Other Data Source Settings
Training Data Source Settings
1.) Change the following settings:
Training Database: training
2.) Leave the remaining as default and click Next
39

Xstore Install
Select Services
1.) Turn Authorizations Off and click Next
Installation Progress
1.) Click Show Details then Install Xstore
2.) Exit the installer once completed
Post Xstore Install
1.) Stop Xstore by deleting the anchor files in c:Xstoretmp
2.) Once Xstore is stopped , copy the .trustore that was created into
c:Xstoreresssl
3.) Start Xstore c:XstoreXstore.bat and press ALT-V at the login
screen to verify Xstore is communicating with Xcenter.
40

Xenvironment Install
Extract the Xenvironment install jar
1.) The installer xenvironment-16.0.0.1.848-0.0.0-0.0-XST-install ,
can be found in the Xstore POS Install archive
oraclepdb_install,upgrade.ziporaclepdb_install,upgradeOracleReta
ilXstorePointofService_16_0_0_1_848_XST_0_0_0.zip16.0.0.1.848_0.0.
0xenvironment
2.) Also extract the ant.install.properties files and place both files in
a temporary folder
3.) At a DOS prompt type:
java –jar xenvironment-16.0.0.1.848-0.0.0-0.0-XST-install GUI
Installing Xenvironment
1.) Click Next
Install Location
1.) Check off , Xstore Handheld Present?
2.) Click Next and select Yes to create the directory.
41

System Information
1.) Update the Lead Register Hostname to your local hostname
You can obtain this by typing in hostname at a command prompt.
2.) Select Next to continue
System Information
1.) Update the following fields
Store Name: Test Store
2.) You can leave the Helpdesk Phone Number blank
3.) Select Next to continue
Is a local database present?
1.) Select Yes , then Next to continue
SID/Instance
1.) Enter in xstore , then select Next to continue
42

StorePrimary Data Source Settings
Security Parameters
1.) Update the following field
Encrypted Password Algorithm:
Pj4+MAAAAABEJKQVOAJI+5sGlAQ30XIQ
2.) Click Next to continue
Is a local database present?
1.) Select Yes , then Next to continue
Installation progress
1.) Click Install Xenvironment
2.) Once it’s completed Xenvironment will start , exit the installer.
43

Post Install Instructions
Environment
1.) Stop the Xenvironment engine and GUI by deleting anchor files
in c:environmenttmp
2.) Copy the .truststore you created to c:environmentresssl
3.) To start the Environment run c:environmentstart_eng.bat
4.) You may receive an Environment startup error , delete this my
deleting the ERR file in c:environmentmarker
NOTE: The Environment GUI password is pos
Xstore-Mobile
1.) Stop Xstore-Mobile by deleting the anchor files in c:xstore-
mobiletmp
2.) Open the c:xstore-mobilewrapperconfxstore_mobile.conf in a
text editor
3.) Change wrapper.java.additional.11=-Djetty.port to 8450
4.) Save the file
44

Oracle_Retail_Xstore_Suite_Install.pdf

Oracle_Retail_Xstore_Suite_Install.pdf

More Related Content

What's hot

Similar to Oracle_Retail_Xstore_Suite_Install.pdf

Oracle_Retail_Xstore_Suite_Install.pdf