Marketplace Configuration

A Marketplace is essentially a catalogue containing a subset of all the services offered by a Service provider in the Master Marketplace.

A Marketplace is typically associated with a Master Reseller or Master Agent who resells the services defined and published by the service provider (owner of the marketplace/appliance) in the Master Marketplace. The Master Reseller or Master Agent may either offer services directly - through a Web store, or recruit and manage their own set of reseller partners. These reseller partners will in turn offer services from the Marketplace to customers using their own custom branded Web stores.

Each Jamcracker Platform instance can contain one or multiple Marketplaces.

The Marketplace is created and administered by a marketplace administrator. The marketplace administrator is responsible for managing and publishing a catalogue of all services that comprise the marketplace. These are the services that will be made available for resale via resellers and their web stores or directly to a customer/end-user through a web store created by the marketplace administrator.

Master Marketplace

The Master Marketplace (Source Marketplace) is typically associated with a service provider. Within the Jamcracker Platform Instance, a Source Marketplace refers to the master catalogue of all services that a service provider may choose to offer. Each service that is part of this Master Catalogue or Source Marketplace is defined in the Jamcracker Platform Instance by a Platform or Super admin and published for further distribution through the channel by resellers. Resellers will be able to take any Service published in the Source Marketplace and offer it as part of their own Marketplace or Web Store with their own custom branding or pricing.

After the instance setup, we proceed to create a Source Marketplace for the instance.

Login to the Super admin portal with Super admin Credentials <will be provided by the Jamcracker Support Team>. Click Add Marketplace.

Fill in the details as per the IG shared by the customer and click Create Marketplace.

  • Marketplace URL: URL to access the marketplace over internet which has a valid DNS entry
  • Company Acronym: Short name of the company (Cannot be changed or modify later once its configured in the UI)
  • Company Name: Name of Marketplace that is being created
  • Root User ID: User email address to login to marketplace and perform administrative functions
  • Password: Password to access the marketplace
  • Marketplace Full Name: Same as company name
  • Marketplace Short name: Same as Acronym (Cannot be changed or modify later once its configured in the UI)

Branding

The JSDN Super Administrator creates a new marketplace. The newly-created marketplace will be in In-Active state, you must activate to access all functions and features that are available by default. However, as an administrator, you can do a lot to personalize your marketplace. This section explains how you can setup your marketplace and make it your own. Setting up the marketplace involves changing the marketplace branding, updating content displayed to members, updating e-mail notifications, adding content and many more features.

Step:1

In order to do that proxy to the marketplace by clicking the Proxy icon (make sure to add the marketplace URL to your HOST entry to access) and it will take you to the marketplace home page.

Step:2

Click the Setup link and do the necessary setting/configuration as per the IG.

Step:3

Branding

Upload the Marketplace Logo provided by customer. Select Color theme. (Save and Next)

**Maximum logo size is 300 x 75

Step:4

Regional Settings

Setup the available and default Language > Time Zone > Date Formats.

Step:5

On Demand Service Delivery Network Policies and Information:

Update the below fields with HTML file or URL (Use dummy html for Source Marketplace)

(Copyright, Privacy Policy, Security Policy, About us, Contact Us and EULA) and click Save and Next.

Step:6

Identity Management

Enable No radio button and click Save and Finish.

Step:7

Customer Email Notifications

Keep generic email id’s as it is Source Marketplace and keep the same email address for notification (In order to get email notifications please provide a valid email id’s) and clickSave and Next.

Step:8

Billing Options

Select the currency as per the customer's requirement, you can also select multiple currencies.

However you cannot edit some fields such as Default Payment Method and the Billing Cycle and date as these are configured while creating the Marketplace and cannot be changed once configured. ClickSave and Next.

Step:9

Tax Setup:

Not required for Source Marketplace.

Step:10

Preferences/UI

You can set number of records to be display in the marketplace in the drop-down. ClickSave and Next.

Step:11

Content Options

This is not mandatory to configure during branding the marketplace for the first time. You can make the later also below are the steps to how to add and edit the contents. ClickSave and Next.

Here either you can add a new content or edit any existing static content (please make sure that contents are in HTML format for better view). You can put pictures, flash files or texts from clients website in the content you are creating and the result will show up in the login page of the Marketplace, I usually put Content for Contact us and a good Flash or picture from client website.

Steps to add content.

Click Add Content.

Provide the Display Title, check Public. All users can view and use this content. Button in Access, Select Roles as All Check Static HTML Content button and add the Content in HTML format.

Once complete activate the content (by clicking button)

Steps to edit Content.

Suspend existing static content under action and edit it.

Click on HTML editor to make the changes.

Once complete activate the content (by clicking button)

Step:12

Page Customization

This is not mandatory to configure during setting the marketplace for the time. You can make the later also below are the steps to how to edit the contents. ClickFinish.

Step:13

Regional Setting

Navigate to My Company > Regional Setting and complete the setup process and click Save.

Step:14

Once saved you can close the window or click the click here button to return to Super admin page.

Step:15

Now the Marketplace is ready for activation, click on the red button to activate.

Step: 16

Once the Marketplace setup is completed follow the below steps to enable Source Marketplace, where you have to update marketplace company acronym in pp_config,

How to get the Marketplace acronym

Navigate to Marketplace > Administration > Member Management page, refer to the Company ID column, which is your Marketplace acronym.

Login to APP server with the server credentials

IP:

Username: Enter the username

Password: Enter the password or attach the ppk file

Switch to root user using

sudo su

Open the below file

cd /d01/wildfly/pp_config/jsdn
vi jsdn.properties

Search for the keyword (jsdn.sourceservices.companyacronym) and replace with new value after ' = '(jsdn.sourceservices.companyacronym= <<acronym>>)

Save and Exit.

Restarting the jsdn service

ps -ef|grep jboss (To check the jboss process)

If any processes running then switch to jboss user

sudo su jboss
cd /d01/wildfly/bin
source ~jboss/.bash_profile
./wk ps -ef|grep jboss (Ensure no processes are running)

Starting the jsdn service

sudo su jboss
cd /d01/wildfly/bin
source ~jboss/.bash_profile
./sj ll /d01/wildfly/standalone/deployments (make sure all the files are deployed, wait till all files are changed to deployed state)

Restarting the jsdn in job server

Login to JOB server

IP:

Username: Enter the username

PPK: Enter the password or attach ppk

Switch to root user

sudo su
ps -ef|grep jboss (To check the jboss process)

If any processes running then switch to jboss user

sudo su jboss
cd /d01/wildfly/bin
source ~jboss/.bash_profile
./wk
ps -ef|grep jboss (Ensure no processes are running)

Starting the jsdn service

sudo su jboss
cd /d01/wildfly/bin
source ~jboss/.bash_profile
./sj
ll /d01/wildfly/standalone/deployments (make sure all the files are deployed, wait till all files are changed to deployed state)

Once the OPS Activity is completed, Source marketplace setup is ready.

Target Marketplace

Each Jamcracker Platform instance can contain multiple Marketplaces. A Marketplace is essentially a catalogue containing a subset of all the services offered by a Service provider in the Master Marketplace.

A Marketplace is typically associated with a Master Reseller or Master Agent who resells the services defined and published by the service provider in the Source Marketplace. The Master Reseller or Master Agent may either offer services directly - through a Web Store, or recruit and manage their own set of reseller partners. These reseller partners will in turn offer services from the Marketplace to customers using their own custom branded Web Stores.

The Marketplace is created and administered by a marketplace administrator who uses web-based portal in the Jamcracker Platform Instance to manage and publish a catalogue of all services that will be available for resale via resellers or directly to a customer/end-user through a Web Store. Some key things to note with respect to the market place are:

  • Services that are part of a Marketplace are a subset of the services defined and published in the Source Marketplace. In order to add a new service to the Marketplace, the Marketplace administrator will have to first request the Source Marketplace’s super administrator to add the service to the Source Marketplace.
  • The Marketplace is simply a catalogue of available services. No transactions can be conducted directly using the catalogue. Services in the Marketplace must be defined and published as part of a Web Store before they can be transacted.
  • All services in the Marketplace catalogue must be of the same language and currency. Specifically, two services with different languages and currency settings cannot be part of the same Marketplace.

After the instance setup, we proceed to create a Target Marketplace for the instance.

Login to the Super admin portal with Super admin Credentials <will be provided by the Jamcracker Support Team>. Click Add Marketplace.

On the next page, Fill in the details as per the IG shared by the customer and click Create Marketplace.

  • Marketplace URL: URL to access the marketplace over internet which has a valid DNS entry
  • Company Acronym: Short name of the company (Cannot be changed or modify later once its configured in the UI)
  • Company Name: Name of Marketplace that is being created
  • Root User ID: User email address to login to marketplace and perform administrative functions
  • Password: Password to access the marketplace
  • Marketplace Full Name: Same as company name
  • Marketplace Short name: Same as Acronym (Cannot be changed or modify later once its configured in the UI)

Branding

The JSDN Super Administrator creates a new marketplace. The newly-created marketplace will be in In-Active state, you must activate to access all functions and features that are available by default. However, as an administrator, you can do a lot to personalize your marketplace. This section explains how you can setup your marketplace and make it your own. Setting up the marketplace involves changing the marketplace branding, updating content displayed to members, updating e-mail notifications, adding content and many more features.

Step:1

In order to do that proxy to the marketplace by clicking on proxy button (make sure to add the marketplace URL to your HOST entry to access) and it will take you to the marketplace home page.

Step:2

Click the Setup link and do the necessary setting/configuration as per the IG

Step:3

Branding

Upload the Company Logo(**Maximum logo size is 300 x 75). Select Color theme and clickSave and Next.

Step:4

Regional Settings

Setup the available and default Language > Time Zone > Date Formats

Step:5

On Demand Service Delivery Network Policies and Information:

Update the below fields with HTML file or URL as per the IG

(Copyright, Privacy Policy, Security Policy, About us, Contact Us and EULA) and clickSave and Next.

Step:6

Identity Management

Enable No radio-button and clickSave and Finish.

Step:7

Customer Email Notifications

Provide the email id’s as per the IG. (Note: In order to get email notifications please provide a valid email id’s) ClickSave and Next.

Step:8

Billing Options

Select the currency as per the customers requirement, you can also select multiple currencies.

Note you cannot edit some fields like Default Currency, Payment method and Bill Generation Options as it was configured while creating the MP and cannot be changed once configured. ClickSave and Next.

Step:9

Tax Setup:

Its not mandatory to configure during branding setup, you can set it up later also.

Click Add Tax.

Fill the details provided as per the IG.
Note: Effective Date should be the date when you are creating the tax.

Step: 10

Preferences/UI

You can set number records to be display in the marketplace in the drop-down and clickSave and Next.

Step: 11

Content Options

This is not mandatory to configure during setting the marketplace for the time. You can make the later also below are the steps to how to add and edit the contents. ClickSave and Next.

Here either you can add a new content or edit any existing static content (please make sure that contents are in HTML format for better view). You can put pictures, flash files or texts from clients website in the content you are creating and the result will show up in the login page of the Marketplace, I usually put Content for Contact us and a good Flash or picture from client website.

Steps to add content.

Click Add Content.

Provide the below details,

  • Display Title
  • Enable Public radio-button
  • Select Roles as All
  • Check Static HTML Content button and add the Content in HTML format.

Once complete activate the content (by clicking button)

Steps to edit Content.

Suspend existing static content under action and edit it.

Click on HTML editor to make the changes

Once complete activate the content (by clicking button)

Step:12

Page Customization

This is not mandatory to configure during setting the marketplace for the time. You can make the later also below are the steps to how to edit the contents. Click Finish.

Steps:

Click the Edit icon from the Actions column.

Select the content module and click Add to display the selected modules in the below content.

By default it will go to left column, you can modify the module by selecting the module and use the navigation buttons to move over column or up and down. Click Save to complete the setup.

Step:13

Regional Setting

Navigate to My Company > Regional Setting and complete the setup and click Save.

Step:14

Once saved you can close the window or click the click here link to return to Super admin page.

Now the Marketplace is ready for activation, click on the red button to activate.