Cloud Store Onboarding

Application

User’s Guide For Odin Service Automation

Revision 1.0.1 (19 May 2016)

2

Table of Contents

1. Preface .................................................................................................................. 3

1.1. Documentation Conventions ......................................................................................... 3

1.1.1. Typographical Conventions ..................................................................................... 3

1.1.2. General Conventions.............................................................................................. 4

1.2. Feedback ...................................................................................................................... 4

1.3. Revision History .............................................................. Error! Bookmark not defined.

1.4. Changelog .................................................................................................................... 4

2. Introduction ........................................................................................................... 5

2.1. About This Guide ........................................................................................................... 5

2.2. Audience ....................................................................................................................... 5

2.3. Terms and Abbreviations ............................................................................................... 5

3. Cloud Store Onboarding Application Overview ......................................................... 6

3.1. Pre-conditions ............................................................................................................... 7

4. Cloud Store Activation ............................................................................................ 8

4.1. Activating Cloud Store .................................................................................................. 8

4.2. Managing Cloud Store ................................................................................................. 11

4.2.1. Disabling and enabling restricted access to Online Store ...................................... 11

4.2.2. Uploading new SSL certificates for Online Store and Customer CP ...................... 13

4.2.3. Performing other Online Store configuration activitiesError! Bookmark not

defined.

3

1. Preface

1.1. Documentation Conventions

Before you start using this guide, it is important to understand the documentation

conventions used in it.

1.1.1. Typographical Conventions

The following kinds of formatting in the text identify special information.

Formatting convention Type of Information Example

Special Bold Items you must select, such as menu options, command buttons, or items in a list.

Navigate to the QoS tab.

Titles of modules, sections, and subsections.

Read the Basic Administration module.

Italics Used to emphasize the importance of a point, to introduce a term or to designate a command line placeholder, which is to be replaced with a real name or value.

These are the so-called shared VEs.

To destroy a VE, type vzctl

destroy VEid.

Important An important note provides information that is essential to the completion of a task. Users can disregard information in a note and still complete a task, but they should not disregard an important note.

Important: The device drivers installed automatically during Setup are required by your system. If you remove one of these drivers, your system may not work properly.

Note A note with the heading “Note” indicates neutral or positive information that emphasizes or supplements important points of the main text. A note supplies information that may apply only in special cases—for example, memory limitations, equipment configurations, or details that apply to specific versions of a program.

Note: If Windows prompts you for a network password at startup, your network is already set up and you can skip this section.

Monospace The names of commands, files, and directories.

Use vzctl start to start a VE

Preformatted On-screen computer output in your command-line sessions; source code in XML, C++, or other programming languages.

Saved parameters for VE 101

4

Preformatted Bold What you type, contrasted with on-screen computer output.

# rpm –V virtuozzo-release

CAPITALS Names of keys on the keyboard. SHIFT, CTRL, ALT

KEY+KEY Key combinations for which the user must press and hold down one key and then press another.

CTRL+P, ALT+F4

1.1.2. General Conventions

Be aware of the following conventions used in this book.

Modules in this guide are divided into sections, which, in turn, are subdivided into

subsections. For example, Documentation Conventions is a section, and General

Conventions is a subsection.

When following steps or using examples, be sure to type double-quotes ("), left single-

quotes (`), and right single-quotes (') exactly as shown.

The key referred to as RETURN is labeled as ENTER on some keyboards.

Commands in the directories included into the PATH variable are used without

absolute path names. Steps that use commands in other, less common, directories

show the absolute paths in the examples.

1.2. Feedback

If you have found a mistake in this guide, or if you have suggestions or ideas on how to

improve it, please send your feedback using cloudstoreonboarding@odin.com. Please

include in your report the guide's title, chapter and section titles, and the fragment of text in

which you have found an error.

1.3. Changelog

The change log identifies the updates made to this document.

Version Date Description Author

1.0.0 12 May 2016 Initial version Denis

Svezhentsev

1.0.1 19 May 2016 More details added in the application

overview and prerequisites added

Denis

Svezhentsev

5

2. Introduction

2.1. About This Guide

This guide describes all the tasks administrators can carry out from the Customer Control

Panel.

2.2. Audience

This guide is intended for administrators who intend to perform Online Store configuration

and branding configuration for reseller accounts using the Cloud Store Onboarding

application.

The document is meant for Ingram Micro internal use only.

This document was developed by Odin. For additional information, please contact

cloudstoreonboarding@odin.com.

2.3. Terms and Abbreviations

Below is the list of concepts and abbreviations you will find in this document.

Abbreviation Definition

API Application Programming Interface

APS Application Packaging Standard, an open standard that was

designed to simplify the delivery of SaaS applications in the cloud-

computing industry

CCP Customer Control Panel

OSA Odin Service Automation (former Parallels Automation), which

includes both OA and BA

BA Business Automation

OA Operations Automation

SaaS Software as a Service

CSO Cloud Store Onboarding Application

6

3. Cloud Store Onboarding Application

Overview

Cloud Store Onboarding Application is an extension of the Reseller’s Customer Control Panel

allowing an OSA Reseller (or OSA Provider on their behalf) to configure Online Store and

Customer CP branding using a simplified wizard in Customer CP.

In the wizard, CSO performs the following configuration steps under the OA Reseller account:

Creates a domain specified by the user.

Creates specified subdomains for Customer CP and Online Store.

Creates 2 webspaces and 3 websites: one webspace for the Customer CP domain

website and one for domain and Online Store subdomain websites.

Enables FTP on the webspace used for the domain and Online Store websites and an

internal FTP user that will be used for Online Store synchronization.

Creates Customer CP brand with configured DNS branding.

Generates and installs self-signed SSL certificates for Online Store and Customer CP

or installs signed SSL certificates uploaded by the user.

Copies the Online Store configuration from the upper-level vendor (the Online Store

name used is set up system-wide in CSO settings) and publishes delegated Sales

Categories to the corresponding Online Store screens.

Installs a Proxy Store using the Store server host IP address specified in system-wide

CSO settings.

Configures a predefined set of Online Store Dictionary Translations for English

language according to the values specified by the user.

Configures Logo, uploaded by the user, for Customer CP.

Revokes the LAYOUT_TEMPLATES_MANAGE privilege from all BA roles of the

Reseller to prevent accidental modification of the Online Store template.

Enables temporary basic authentication protection for the reseller’s online store using

the username and password provided by the user to prevent opening the Online Store

to wider audience until fully verified by the reseller.

Note For instructions on setting system-wide CSO settings refer to Cloud Store Onboarding Application Deployment Guide.

When the wizard is passed, CSO displays DNS information of the activated Online Store and

allows to perform the following actions:

Disable and re-enable restricted access to Online Store (using basic HTTP

authentication).

Upload new SSL certificates for Online Store and Customer CP.

7

3.1. Pre-conditions

For CSO activation wizard to operate make sure that the following conditions are met:

1. The Reseller is subscribed to a reseller Service Plan based on the Branding Service

Template that includes the following resources:

a. Branded FTP

b. Branded Website (at least 3 are required in the branding subscription in order for

the application to work correctly)

c. OA Cloud Store Service

d. OA Cloud Store Onboarding Application

2. The Reseller is initialized, that is the Reseller Wizard is completed (the currency is set)

in Billing Reseller CP.

3. The parent reseller of the one Cloud Store is activated for must have a Store with the

name specified in CSO application settings configured and set as Template.

8

4. Cloud Store Activation

This section describes the steps an administrator should make in order to activate Cloud

Store. These steps may be performed by the administrator of the Reseller the Cloud Store is

activated for or by the administrator of the Reseller’s upper-level Reseller or Provider.

4.1. Activating Cloud Store

In order to activate Cloud Store using the CSO activation wizard, login to the Customer CP of

the reseller you want to activate Cloud Store for.

Then perform the following steps:

1. Switch to the Cloud Store tab.

2. Click Activate Cloud Store.

3. On the first step of the wizard, provide Online Store domain settings:

a. Select a domain registered in the reseller’s account or specify a domain

registered externally, and a subdomain that will be used to access the Online

Store

Note The option of using a domain already registered for the reseller account is only available if there are domains registered through BA for this account.

b. Choose whether to generate a self-signed certificate for Online Store or to

upload a CA-signed certificate, and upload the certificate and key in the latter

case.

9

c. Choose whether you want the Online Store to be instantly available to anyone

on the web or restricted to authorized users. In the latter case, specify Login

and Password.

d. Click Next.

4. On the second step of the wizard, provide Customer Control Panel domain settings:

a. Specify a subdomain name that will be used for Customer CP.

b. Choose whether to generate a self-signed certificate for Customer CP or to

upload a CA-signed certificate, and upload the certificate and key in the latter

case.

Note If you used a wildcard SSL certificate for Online Store, you can use

the same one for Customer CP, but it has to be uploaded again on this step.

c. Click Next.

5. Specify reseller company details. This information will be displayed in Online Store to

end-customers.

10

6. Upload a logo that would be displayed in Customer Control Panel.

7. Specify the HTML content to be displayed on the About Us and Contact Us pages of

Online Store:

8. Click Submit. The wizard will perform the configuration according to the user input.

9. The following notification will indicate the successful completion of Cloud Store

activation:

10. To verify the Online Store click the Store URL link.

Note If the domain name was registered recently or an externally registered domain was used it may not resolve to the Online Store branding host. Follow the on-screen instructions to resolve the issue.

11. If access restriction was enabled, the authentication window will appear. Enter the

Login and Password you specified on Step 3c.

11

12. The Online Store main page will open.

4.2. Managing Cloud Store

When Cloud Store is successfully activated, the user can:

Disable and re-enable restricted access to Online Store (using basic HTTP

authentication).

Upload new SSL certificates for Online Store and Customer CP.

4.2.1. Disabling and enabling restricted access to Online Store

To disable restricted access to Online Store, log into the Customer CP of the corresponding

reseller.

Then perform the following steps:

1. Switch to the Cloud Store tab.

12

2. Click Reset.

3. Wait until Access to Cloud Store setting shows Open for any visitor.

To enable restricted access to Online Store, log into the Customer CP of the corresponding

reseller.

Then perform the following steps:

1. Switch to the Cloud Store tab.

2. Enter Cloud Store Login and Cloud Store Password and Click Set.

3. Wait until Access to Cloud Store setting shows Restricted to authorized persons

only.

13

4.2.2. Uploading new SSL certificates for Online Store and

Customer CP

To upload new SSL certificates for Online Store and the Customer CP (e.g. to upload a CA-

signed certificate instead of a temporary self-signed certificate or to replace an expired

certificate), log into Customer CP of the corresponding reseller.

The perform the following steps:

1. Switch to the Cloud Store tab.

2. Upload the new certificate and key files and press the corresponding Update

Certificate button. You can update Online Store and Customer CP certificates

independently.