RES IT Store Integration Guide: RES Suite
RES IT Store Integration Guide: RES Suite
1
Disclaimer
Whilst every care has been taken by RES Software to ensure that the information contained in this document is correct and complete, it is possible
that this is not the case. RES Software provides the information "as is", without any warranty for its soundness, suitability for a different purpose or
otherwise. To the maximum extent permitted by applicable law, RES Software is not liable for any damage which has occurred or may occur as a
result of or in any respect related to the use of this information. RES Software may change or terminate this document at any time without further
notice and shall not be responsible for any consequence(s) arising there from. Subject to this disclaimer, RES Software is not responsible for any
contributions by third parties to this information.
Copyright Notice
Copyright © on software and all Materials 1998-2014 Real Enterprise Solutions Development B.V., P.O. Box 33, 5201 AA `s-Hertogenbosch, The
Netherlands. RES and the RES Software Logo are either registered trademarks or service marks of Real Enterprise Solutions Nederland B.V. in
Europe, the United States and other countries. RES Automation Manager, RES Workspace Manager, RES Suite, RES Virtual Desktop Extender,
RES IT Store and RES VDX are trade names of Real Enterprise Solutions Nederland B.V. in Europe, the United States and other countries. All
other product and company names mentioned may be trademarks and/or service marks of their respective owners. Real Enterprise Solutions
Development B.V., The Netherlands has the following patents: U.S. Pat. "US 7,433,962", "US 7,565,652", "US 7,725,527", other patents pending or
granted.
RES IT Store Integration Guide: RES Suite
2
TABLE OF CONTENTS:
Introduction....................................................................................................................................................... 4
Use Case Overview ........................................................................................................................................ 5
Configuring RES IT Store Integration – Step by step ................................................................................ 6
Prerequisites ................................................................................................................................................. 7
Service Templates ....................................................................................................................................... 8
Service Publications .................................................................................................................................. 10
Integration with RES Workspace Manager ............................................................................................ 12
Integration with RES Automation Manager ........................................................................................... 18
More information............................................................................................................................................ 21
RES IT Store Integration Guide: RES Suite
3
Introduction
This document describes how you can improve usability in RES Workspace Manager and RES Automation
Manager by configuring integration with RES IT Store.
In RES Workspace Manager 2014 and RES Automation Manager 2014, it is possible for administrators to
create new RES IT Store services directly from the RES Workspace Manager and RES Automation
Manager Consoles.
RES Workspace Manager reduces the complexity of managing how IT services are made available to
users across all Microsoft Windows environments and multiple delivery platforms and devices, while
reducing costs. It offers an improved desktop experience to users and, through context awareness,
optimizes the way they consume IT services.
RES Automation Manager centrally manages the complex daily tasks faced by IT with a very simple
interface, targeting and provisioning a variety of resources for the data center and dynamic desktop
environments.
The key benefits of the integration are:


Offer self-servicing capabilities in the RES Workspace Manager Workspace Composer to gain
access to applications, printers and settings.
Publish Run Books as a service in the RES IT Store Web Portal for delegation and self-servicing.
This document assumes that you have basic knowledge of RES IT Store 2014, RES Workspace Manager
and RES Automation Manager 2014.
RES IT Store Integration Guide: RES Suite
4
Use Case Overview
Use Case 1:
In RES Workspace Manager, it is possible to use RES IT Store services as access principle when
configuring managed applications and objects like printers and settings. It is now also possible to create
new RES IT Store services when configuring these items.
Use Case 2:
In RES Automation Manager, it is possible to create an RES IT Store service of a Run Book and include the
Run Book in the service.
RES IT Store Integration Guide: RES Suite
5
Configuring RES IT Store Integration – Step by step
In order to configure integration of RES Workspace Manager and RES Automation Manager with RES IT
Store, the following needs to be configured:
In RES IT Store



Service Templates
Service Publications
RES Automation Manager integration settings
In RES Workspace Manager:


RES IT Store integration settings
Managed applications and objects (such as printers and settings)
In RES Automation Manager:


RES IT Store integration settings
Run Books
RES IT Store Integration Guide: RES Suite
6
Prerequisites



RES IT Store 2014
RES Workspace Manager 2014
RES Automation Manager 2014
RES IT Store Integration Guide: RES Suite
7
Service Templates
For the first step of the integration, create at least two templates, one for RES Workspace Manager and
one for RES Automation Manager.
A service template is a preconfigured service that makes it possible in RES Workspace Manager and RES
Automation Manager to create new RES IT Store services directly from the RES Workspace Manager
Console and RES Automation Manager Consoles, based upon these templates. This allows for further
integration of RES Software products and improves usability when creating and managing services.
Please note that you can only convert a service to a template if it is currently unused. That means:



The service has no subscribers.
The service is not already used in a Service Publication.
The service is not referenced by other services (i.e. not as a qualification restriction or dependency
of other services or in their service attributes.
Once services are converted to a template, they can be added to a Service Publication, at Setup > Service
Publications. Templates can only be used in Service Publications; they are no longer available as a
service in the RES IT Store Web Portal, and can no longer be referenced by other services.
RES IT Store Integration Guide: RES Suite
8
Configuration
1. In the RES IT Store Console, click the Services section.
2. Open the service that you want to convert to an RES Workspace Manager template, or create a
new service.
3. On the Properties tab of the Service window, select the option Use as template.
 If the service is currently unused, the options Show in publications, Show in IT Store, Show
in IT Service Panels and Enable transactions will be grayed out and no longer apply.
 If the service is currently in use, you will be prompted to clone the service first and create a
template from the clone.
4. Make any changes to the configuration of the template.
5. Save the changes by clicking OK.
6. Repeat the steps to convert a service to an RES Automation Manager template.
Templates are shown in the Service section with a different icon than services and in the format "<service
name> [TEMPLATE]". Using this search criteria in the Instant Search bar makes it easier to retrieve
service templates.
Best practice
When configuring a service template for RES Automation Manager, make sure the first action is an
Approve action, to build in an extra security for new services. For example, if you use this template to
create a service that invokes a Run Book to delete users in your Active Directory, it provides an option to
cancel the service before the Run Book is executed.
RES IT Store Integration Guide: RES Suite
9
Service Publications
A new RES IT Store environment contains two default Service Publications: RES Workspace Manager and
RES Automation Manager.
RES Workspace Manager
This publication allows you to integrate RES IT Store into RES Workspace Manager and use services in
Access Control rules for applications and objects like printers and settings.
It contains a default template Workspace Template. This template can be used to create new services and
use them in Access Control rules for applications, printers and settings.
RES Automation Manager
This publication allows you to integrate RES IT Store into RES Automation Manager and use services to
invoke Run Books. It contains a default template Run Book Template. This template can be used to
publish Run Books as a service in the RES IT Store Web Portal for delegation and self-servicing.
Configuration
1. In the RES IT Store Console, click Setup > Service Publications. This opens the Service
Publications window.
2. Select the publication RES Workspace Manager and click Edit. This opens the Publication
“RES Workspace Manager” window.
3. On the Properties tab, optionally specify a Password and a People Identifier. Please note
that these must also be specified in RES Workspace Manager (e.g. Windows user
account).
RES IT Store Integration Guide: RES Suite
10
4. On the Published Templates tab, click Add to make service templates available for use in
RES Workspace Manager. When adding templates to a publication, you can only select
templates in which the options Use as template and Show in publications are selected.
You can find these options on the service's Properties tab.
5. Repeat the steps to add services to the publication RES Automation Manager.
RES IT Store Integration Guide: RES Suite
11
Integration with RES Workspace Manager
In an RES Workspace Manager site with enabled RES IT Store Integration, you can base Access Control
on managed applications, printers and settings on a delivered RES IT Store Service.
The first thing you need to do is to configure RES IT Store Integration.
Configuration
1. In the RES Workspace Manager Console, click Setup > RES Software > RES IT Store.
2. Select the option Enable RES IT Store Integration.
 Enter the Catalog host name and Port. The Catalog host is the machine on which the
Catalog Services run. The Catalog Services are used by RES Workspace Manager to query
which RES IT Store services have been delivered to a user. The default port of the Catalog
host is 8080.
 Enter the Publication name and password of the RES IT Store Catalog host.
 When configuring RES IT Store Integration, use the Test now button to test whether you
can actually connect to the specified Catalog host. If connection is possible, an overview of
all available RES IT Store Services will be shown.
When RES IT Store Integration has been configured, you can create new RES IT Store services when
configuring the Access Control settings of managed applications, printer settings, etc.
The procedure below will focus on creating a service for an application.
Configuration
1.
2.
3.
4.
In the RES Workspace Manager Console, go to Composition > Applications.
Open the managed application that you want to edit or create a new one.
In the Edit application window, click the tab Access Control > Identity.
In the Type field, select RES IT Store Service. You now have two options: restricting access by
selecting an existing RES IT Service or by creating a new service.
RES IT Store Integration Guide: RES Suite
12
Existing service
1. Select an existing RES IT Service from the list to restrict access to the application to users to whom
that specific RES IT Store Service has been delivered.
New Service
1. Click the button New Service to start the RES IT Store Service Wizard. RES Workspace Manager
will create new IT Store Services based on Service Templates configured in the RES IT Store.
When creating the new RES IT Store Service, qualification for the Service is also defined. Access to
the application is then restricted to users to whom that specific RES IT Store Service has been
delivered.
RES IT Store Integration Guide: RES Suite
13



The RES IT Store Service Wizard guides you through creating, customizing and publishing
a new service that is then selected as Access Control rule for the managed application.
A default template is automatically available in RES IT Store 2014, and additional templates
can be created in the RES IT Store Console.
The RES IT Store Service Wizard can also be accessed from the Command Bar by clicking
(Publish in RES IT Store) and the Context menu option Quick Edit (Access Control >
Identity).
RES IT Store Integration Guide: RES Suite
14
RES IT Store Integration Guide: RES Suite
15

If other rules were already defined for Access Control on a managed application, you can
choose whether users' existing access should be maintained by subscribing them to the new
service automatically.
The procedure below will focus on creating a service for an object (printers, settings):
Configuration
1. In the RES Workspace Manager Console, opent the object that you want to edit.
2. On the Access Control tab, click Add in the Identity area.
3. Select RES IT Store Service.
4. Select an RES IT Service from the list to restrict access to the object to users to whom that
specific RES IT Store Service has been delivered. You now have two options: restricting
access by selecting an existing RES IT Service or by creating a new service.
RES IT Store Integration Guide: RES Suite
16
Existing service:
1. Select an existing RES IT Service from the list to restrict access to the object to users to
whom that specific RES IT Store Service has been delivered.
2. Also choose whether the newly created RES IT Store Service overrules these other rules
(select Replace current access control) or is added to the list of rules defined for
users/groups (clear Replace current access control).
New service:
1. Click the button New service to start the RES IT Store Service Wizard. RES Workspace
Manager will create new IT Store Services based on Service Templates configured in the
RES IT Store. When creating the new RES IT Store Service, qualification for the Service is
also defined. Access to the object is then restricted to users to whom that specific RES IT
Store Service has been delivered.
2. The RES IT Store Service Wizard guides you through creating, customizing and publishing
a new service that is then selected as Access Control rule for the object.
3. A default template is automatically available in RES IT Store 2014, and additional templates
can be created in the RES IT Store Console.
4. The RES IT Store Service Wizard can also be accessed from the Command Bar by clicking
(Publish in RES IT Store) and the Context menu option Quick Edit (Access Control >
Identity).
RES IT Store Integration Guide: RES Suite
17
Integration with RES Automation Manager
In an RES Automation Manager site with enabled RES IT Store Integration, you can create new RES IT
Store services based on Run Books.
The first thing you need to do is to configure RES Automation Manager Integration in the RES IT Store
Console. By configuring RES Automation Manager Integration, you can use RES Automation Manager
Run Books in the services in your RES IT Store environment. The settings that you specify will be used by
the Transaction Engine to connect to RES Automation Manager Dispatchers and invoke Run Books when
necessary.
Configuration
1. In the RES IT Store Console, click Setup > RES Automation Manager. This opens the RES
Automation Manager window.
2. Select Enable RES Automation Manager Integration.
3. In the Environment field, select the RES Automation Manager environment that you want to
integrate with.
4. In the Dispatcher detection area specify the detection method of RES IT Store to detect RES
Automation Manager Dispatchers.
 Select Autodetect to let the Transaction Engine search for available Dispatchers in its own LAN
by sending a multicast signal.
 Select Use Dispatcher address list to set up a list of Dispatchers that can be used by the
Transaction Engine.
5. In the Authentication area, specify the authentication method of the selected RES Automation
Manager environment.
6. You can test the connection settings by clicking Test.
RES IT Store Integration Guide: RES Suite
18
The next thing you need to do is to configure RES IT Store Integration in the RES Automation Manager
Console.
Configuration
1. In the RES Automation Manager Console, click Infrastructure > Datastore > Setup > RES IT
Store.
2. Select the option Enable RES IT Store integration.
3. Enter the Catalog host name and Port. The Catalog host is the machine on which the Catalog
Services run. The Catalog Services are used by RES Automation Manager to query which RES IT
Store templates are available. The default port of the Catalog host is 8080.
4. Enter the Publication name and password of the service publication that contains the RES IT
Store templates
5. When configuring RES IT Store Integration, use the Test now button to test whether you can
actually connect to the specified Catalog host. If communication is possible, a message “Connection
succesful” will be shown.
When RES IT Store Integration has been configured, you can create new RES IT Store services when
configuring Run Books. You do this by using the RES IT Store Service Wizard. Please note that this
wizard is only available if you have configured and enabled RES IT Store Integration AND your security
role has Modify access to the Run Books node.
Configuration
1. In the RES Automation Manager Console, go to Repository > Run Books.
2. Right-click the Run Book that you want to use in a new RES IT Store service and click Publish in
RES IT Store from the context menu. This opens the RES IT Store Service Wizard. Follow the
steps to configure a new service.
Service properties step:


Select the RES IT Store service template on which the new service will be based. You can configure
new service templates in the RES IT Store Console.
The name of the new service must be unique in the RES IT Store environment.
Service Category step:

Select the category in the service catalog in RES IT Store in which the new service will be placed.
RES IT Store Integration Guide: RES Suite
19
Service Qualification step:

Select the qualification criteria of the new service:
o Use from template: The qualification criteria of the service template will be applied to the
new service.
o Everyone qualifies: Every person in the RES IT Store environment will qualify for the new
service.
o Base on organizational context: Select an Organizational Context item as qualification
criterion. People must be classified in this Organizational Context item to qualify for the
service.
Summary step:


Review all configured settings for the new service.
When you click Publish, all configured settings will be validated and a new service will be created.
When the new service is created in RES IT Store:





Its delivery workflow contains as first action a Provide Information action, to ask for input for the
Run Book parameters.
It contains an action Invoke Run Book with the selected Run Book.
Service attributes will be automatically created and linked to the Run Book parameters (if any).
An exception handler will be added with an End Workflow action "Delivery failed".
The service will be disabled by default, which allows for fine-tuning of the service before making it
available in the RES IT Store environment.
Note
All communication of the RES IT Store Wizard to the Catalog Services of RES IT Store is SSL-encrypted, using port 8081.
RES IT Store Integration Guide: RES Suite
20
More information
You can find more documentation at http://support.ressoftware.com at the Library section and at the
Downloads section. Useful reading includes:


RES Automation Manager 2014 Administration Guide: this document provides detailed
information about the installation and configuration of RES Automation Manager 2014 features and
components. The online version of this document can be accessed from the Help menu in the
Console, and is available at http://support.ressoftware.com/automationmanageradminguide2014.
RES IT Store 2014 Administration Guide: this document provides detailed information about the
installation and configuration of RES IT Store 2014 features and components. The online version of
this document is available at http://support.ressoftware.com/itstoreadminguide2014/.
RES Software
Support
Europe and Asia
Monday - Friday 08:00
18:00 CET
Belgium
0800-753-12 (Toll Free)
Denmark
8088-6779 (Toll Free)
France
0800-911178 (Toll Free)
Germany
0800-182-7475 (Toll Free)
Netherlands
+31 (0)73 622 8900
Norway
800-10-731 (Toll Free)
Sweden
020-791-079 (Toll Free)
UK
0-800-520-0427 (Toll Free)
+44 (0) 845 838 5550
All other countries
US and Canada
Monday - Friday 08:00
18:00 EST
+31 (0)73 622 8900
+1 800-580-0786 (Toll Free)
E-mail:
support@ressoftware.com
Support Portal:
http://support.ressoftware.com
Support can also be reached on
Twitter: @ressoftware
About RES Software
RES Software manages and secures the key elements of a user’s computing experience, independent of
work styles and devices. By automating how IT services are delivered to virtual workspaces and providing a
user-friendly “IT Store,” RES Software helps IT professionals master the impacts of IT consumerization,
increasingly sophisticated corporate users, bring-your-own-device initiatives and cloud technologies. RES
Software patented technologies are used by a global customer base, and include superior customer
support. For more information, follow updates on Twitter @ressoftware or visit http://www.ressoftware.com.
RES IT Store Integration Guide: RES Suite
21