Ozone Marketplace Quick Start Guide

User Manual:

Open the PDF directly: View PDF PDF.
Page Count: 8

DownloadOzone Marketplace Quick Start Guide
Open PDF In BrowserView PDF
Ozone Marketplace Quick Start
Guide
DOD GOSS

Exported on Oct 16, 2018

DOD GOSS – Ozone Marketplace Quick Start Guide

Table of Contents
1 Introduction .......................................................................................................................... 3
1.1
Objectives ........................................................................................................................... 3
1.2
Document Scope ................................................................................................................ 3
1.3
Related Documents ............................................................................................................ 3
2 Instructions ........................................................................................................................... 4
2.1
Overview ............................................................................................................................. 4
2.1.1

2.2
2.3
2.3.1

2.4
2.4.1
2.4.2

2.5
2.5.1
2.5.2
2.5.3

Supported Browsers...................................................................................................................... 4

Download Release Bundles ............................................................................................... 4
Install Java .......................................................................................................................... 4
Configure the JAVA_HOME environment variable ........................................................................ 4

Unpack the Bundles ........................................................................................................... 5
Consolidate the Bundles ............................................................................................................... 5
Replace default configuration files ................................................................................................ 5

Start the Web Server .......................................................................................................... 6
Sign in to the OZONE Widget Framework .................................................................................... 6
Add the Store to OWF ................................................................................................................... 7
Sign in to the OZONE Store .......................................................................................................... 7

Table of Contents – 2

DOD GOSS – Ozone Marketplace Quick Start Guide

1 Introduction
1.1 Objectives
This quick start guide defines how to setup and run a minimally configured Store. At this end of
this procedure you will have the Store running inside the OZONE Widget Framework (OWF) on
your desktop.

1.2 Document Scope
This guide is intended for administrators or developers who wish to learn how to install and
deploy the Store for the purposes of gaining an overall familiarity with product.

1.3 Related Documents
Document

Purpose

Quick Start
Guide

Setting up and integrating the Store into OWF.

Configuration
Guide

Modifying Default Settings, Security, Database Settings, Upgrading to a
newer Store version.

User Guide

Searching, Creating and Editing Listings, Adding Comments, Ratings,
Navigating a Store, Scorecards Explanation of Store Elements.

Administrator's
Guide

Importing / Exporting Store Data, Adding Affiliated Stores, Approving
Listings, Creating Types, States, Categories, and Custom Fields, Scorecard
Configuration.

Developer's
Guide

Custom Security Modules, Creating and Editing Themes

Release Notes

Major and minor changes for the current release.

Introduction – 3

DOD GOSS – Ozone Marketplace Quick Start Guide

2 Instructions
2.1 Overview
These procedures are written for Windows 10, but can be easily adapted to other versions of
Windows or Linux.

2.1.1 Supported Browsers
The Store is fully supported and tested with the following browsers:
Browser

Version(s)

Microsoft Internet Explorer

11

Microsoft Edge

38

Google Chrome

43

Mozilla Firefox

57

2.2 Download Release Bundles
Download the following application release bundles from:
•

OZONE Marketplace – https://github.com/DoDGOSS/omp-marketplace/releases

•

OZONE Widget Framework – https://github.com/DoDGOSS/owf-framework-patch/releases

2.3 Install Java
Both the Ozone Marketplace and Widget Framework require the Java run-time environment
(JRE).
It is recommended to use the supported Java 8 JRE. However, the minimum requirement is the
Java 7 JRE.
The Oracle JRE will suffice for this quick start. Download and install the package that is
appropriate for your system:
•

(Recommended) Java 8 JRE Downloads –
http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html

•

Java 7 JRE Archive Downloads –
http://www.oracle.com/technetwork/java/javase/downloads/java-archive-downloadsjavase7-521261.html

Note the location where the JRE is installed (for example, C:\Program Files\Java\jre8) –
this path will be used in the next section.

2.3.1 Configure the JAVA_HOME environment variable
1. Click the Start button, and in the search field, type "environment variable".
2. Select the option that says "Edit environment variables for your account".
o

If the JAVA_HOME environment variable already exists, ensure that the value is the
same as the path of the installation from the previous section.

Instructions – 4

DOD GOSS – Ozone Marketplace Quick Start Guide

o

If the JAVA_HOME environment variable does not exist, click the "New..." button.

a. For the "Variable name" field, enter "JAVA_HOME".
b. For the "Variable value" field, enter the full pathof the installation from the previous
section (for example, C:\Program Files\Java\jre8).
c.

Click the "OK" button.

3. Click the "OK" button to save the changes.

2.4 Unpack the Bundles
If you have not yet obtained the bundles for the following steps, please see the Download
Release Bundles section for more details.
•

Create a folder on your file system for the Marketplace (for example,
C:\Ozone\Marketplace\)

•

Unzip the Ozone Marketplace bundle into the created folder.

•

Create a folder on your file system for the Widget Framework (for example,
C:\Ozone\Framework\)

•

Unzip the Ozone Widget Framework bundle into the created folder.

2.4.1 Consolidate the Bundles
The Marketplace and Widget Framework applications, while meant to work together, can also
be run independently. They are packaged as such to easily run them as standalone products.
The following steps will consolidate them into a single web application server that can be run
locally on your computer.
Note: Replace the example paths below with the paths created in the previous section, if
different.
1. Copy the file Marketplace\tomcat\webapps\marketplace.war to
Framework\tomcat\webapps\
2. Copy the contents of Marketplace\tomcat\lib\config to
Framework\tomcat\lib\config\marketplace
3. Copy the following files from franchise-store\tomcat\lib to owf\tomcat\lib
a. mp-override-log4j.xml
b. MarketplaceConfig.xml (not present by default)
c.

MarketplaceConfig.groovy

4. Copy the following files from franchise-store\tomcat to owf\tomcat
a. ompProdDb.h2
b. ompProdDb.lock

2.4.2 Replace default configuration files
Note: May need to expand the owf.war and marketplace.war files if the server has not
been started yet.
By default, the Marketplace and Widget Framework applications run on an in-memory database
(h2). While we have included sample configuration files for each database that is officially

Instructions – 5

DOD GOSS – Ozone Marketplace Quick Start Guide

supported, you must ensure the correct file is being referenced if using a more robust database.
The folowing steps will replace the default configuration file.
1. Navigate to Framework\tomcat\lib\config
2. Copy the database specific .yml file (i.e ozone-framework_mysql.yml) to
Framework\tomcat\webapps\owf\WEB-INF\classes
3. Rename the existing application.yml file to application_orig.yml
4. Rename ozone-framework_mysql.yml to application.yml
5. Navigate to Framework\tomcat\lib\config\marketplace
6. Copy the database specific .yml file (i.e ozone-marketplace_mysql.yml) to
Framework\tomcat\webapps\marketplace\WEB-INF\classes
7. Rename the existing application.yml file to application_orig.yml
8. Rename ozone-marketplace_mysql.yml to application.yml
Note: If you wish to return to the in memory database settings simply remove the
application.yml files and rename application_orig.yml to application.yml.

2.5 Start the Web Server
To start the applications, run the following using a command prompt from the
Marketplace\tomcat\ folder:
Note: May need to replace the default application.yml file in the owf and marketplace
exploded war files with the appropriate database specific configuration .yml files
> start.bat /init

The startup process may take up to a few minutes the first time it is run. You will know it is done
when the command prompt output stops scrolling and a line like this is displayed:
2013-05-08 10:43:00,433 [main] INFO org.apache.catalina.startup.CatalinaServer startup in 110769 ms

2.5.1 Sign in to the OZONE Widget Framework
1. Open your web browser and navigate to: https://localhost:8443/owf.
2. If you receive warnings about untrusted connections, ignore the warnings or add
exceptions, using the dialog box.
3. Log in using the following credentials:
o

Username: testAdmin1

o

Password: password

Instructions – 6

DOD GOSS – Ozone Marketplace Quick Start Guide

2.5.2 Add the Store to OWF
1. Open the OWF drop-down User Menu and click Administration. This opens the
Administration Manager.
2. Click Configuration to open the Configuration Console.
3. From the left-hand panel, click Store.
4. Click the Add Store button. This opens the Store Configuration window.
5. Enter the Store URL, then click Next. OWF will use the URL and automatically gather Store
details.
Figure 1 Store Configuration Wizard

6. The Review page appears. Review or Edit the Store details:
a. Review the icon used to identify the Store to users in OWF
b. Add a Store Name to identity the Store to users in OWF
c.

Click Save.

7. Refresh your browser.

The Store button will appear on the OZONE Toolbar for all OZONE users (see below).
Note: If the Store button does not appear in the toolbar, refresh your browser window.
Figure 2 Store Button on OZONE Toolbar

2.5.3 Sign in to the OZONE Store
1. Open your web browser and go to: https://localhost:8443/marketplace
2. If you receive a warning in your browser about an untrusted connection, add an exception

Instructions – 7

DOD GOSS – Ozone Marketplace Quick Start Guide

3. Log in using the following credentials:
o

Username: testAdmin1

o

Password: password

Instructions – 8



Source Exif Data:
File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.7
Linearized                      : No
Page Count                      : 8
Language                        : en-US
Tagged PDF                      : Yes
XMP Toolkit                     : 3.1-701
Producer                        : Microsoft® Word for Office 365
Creator                         : Stefan
Creator Tool                    : Microsoft® Word for Office 365
Create Date                     : 2018:10:16 12:27:57-04:00
Modify Date                     : 2018:10:16 12:27:57-04:00
Document ID                     : uuid:3C525063-3AA4-4BCE-BB78-F4AFA0DAE228
Instance ID                     : uuid:3C525063-3AA4-4BCE-BB78-F4AFA0DAE228
Author                          : Stefan
EXIF Metadata provided by EXIF.tools

Navigation menu