
Citrix CPSM V11 Integration Manual
1.6 Last updated: 26 August 2014
BackupAgent Service Manager
Installation Guide
1.1 Prerequisites
Citrix CPSM v11 (formerly known as Cortex) integrates with BackupAgent using the
BackupAgent Active Directory Synchronisation feature. This feature needs to be working for
BackupAgent before the Cortex Integration will succeed.
1.2 Create the initial set of Service Access Levels
BackupAgent’s Active Directory Synchronisation relies on users being made member of Active
Directory Security groups with specially crafted names. These groups have to be in the format:
BackupAgent_<Plan>_<Quota>_<Storage Group ID>
Where:
<Plan> is either Home or Professional where Home is for desktop backups and
Professional is for Server backups including Microsoft Exchange and Microsoft SQL
server.
<Quota> is the maximum storage space in gigabytes or megabytes e.g 500MB or 10GB
<Storage Group ID> is the internal BackupAgent ID for the particular storage group.
CloudPortal puts users in and out of these groups as part of the actions when a user is put in a
specific Service Access Level. For this to occur, each Service Access Level needs to have the
following properties set
1

Therefore we would expect an access level to have the following properties analogous to the
group name format:
1. Plan (either Home or Professional)
2. Quota (Integer number)
3. Quota unit(either MB or GB)
4. Storage Group ID
The location of the Security groups that the Service Provider has created when testing the
BackupAgent service is set out in the Preparation Form. As a courtesy, it is usual to create a
Service Access Level for the groups that they are managing.
CloudPortal creates these groups automatically and are put under the CortexSystem OU in
Active Directory
1.3 Configure the customer’s Organizational Structure
BackupAgent designed their Active Directory integration around Microsoft’s HMC solution
which always has the user at the root of the customer’s Organizational Unit. Cortex allows for
much more flexibility in terms of where the users can go in the Active Directory structure
however if the customer wants to use BackupAgent service then they must have their users at
the root of their Organizational Unit.
There are two options to meet this prerequisite. They are:
1. Set the User Structure Configuration property of cortex to be blanked out so that by
default all users for all customers are created at the root of the customer’s OU. This
configuration will be enforced for all customers.
2. The customers who are given the BackupAgent service must be in the User Specified
Organization Structure option and users given the BackupAgent service must be
provisioned (or moved) to the Root of the Customer’s OU. This can be done on a
customer by customer basis and Cortex does not enforce the user’s OU when
provisioning the service to a user so it is a procedure that the customer must follow for it
to work.
2