PA OXaaS APSv2 User Guide

User Guide for the OX as a Service APSv2 package into Odin Service Automation

This APS 2.0 package is only for the Open-Xchange own OXaaS platform or similar respective compatible deployments or copies of this platform. The package is designed for syndication and on-premise customers with Odin Service Automation 6.0.4 and higher.

This guide describes the integration for the OX as a Service APSv2 package into Odin Service Automation. This guide describes all the tasks administrators can carry out from the Customer Control Panel.

This guide is intended for administrators who intend to manage the services provided by Open-Xchange.

Terms and Abbreviations

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

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, which includes both POA and PBA.
OBA	Odin Business Automation.
POA	Parallels Operations Automation.
SaaS	Software as a Service.

Customer Control Panel

In the Customer Control Panel (CCP) you can manage all the Open-Xchange settings.

User’s Tab

From this tab you can add, manage and delete service users registered within the current subscription.

1. To add a user click on Add New Service User.
   
   
2. Fill in all the fields and click on Next.
   • User photo: you can upload a photo to add to your profile.
   • Display name: enter the display name you wish to have.
   • Login: choose a login name and select your domain from the dropdown list.
   • Password: choose your password. (You may also click Generate Password to create one automatically and you will see it under the Password field).
   • Confirm password: reenter your password.
   • Tick the Open-Xchange service checkbox.
     
     
3. A summary of the user information will appear. Click Finish for confirmation.
   
   
4. You can then see that the status of the user will be
   
   

OX Service Tab

From the Open-Xchange tab you can purchase requests and manage users, groups, resources, domains and purchase requests.

Users

On this tab you can add new users, manage profiles and edit, enable and disable them.

By default you will see the Active view, where you can see each user’s status. There are three different possibilities:

You may also wish to see the Classic view by clicking and selecting “Classic list”:

. From here you will be able to see the same information and perform the same actions that are allowed in the Active view mode.

Add New User

To add a new user:

1. Click Add New User.
2. Fill in the following fields:
   
   
3. Click Next.
4. The status will appear as . If an error occurs during creation, the status will be .

Manage Profiles

To manage profiles, follow these steps:

1. Select the user whose profile you want to manage and then click Manage Profiles.
   
   
2. Select the new profile you want to assign to a user from the drop-down list.
   
   
3. Click OK to save the changes.

Edit

1. Select the user whose profile you want to edit and then click Edit.
   
   
2. Enter the alias and select the appropriate domain from the drop-down list.
   
   
3. Click Save.

Enable

To populate the service user information to Open-Xchange:

1. Select the user whose profile you want to enable and then click Enable OX App Suite2.
   
   
2. Enter the email and choose the domain, then select the profile you want to assign to the user. You can also add one or more aliases to the user by clicking on Additional Settings.
   
   
3. Click Next to save the changes. The user’s status will now be Enabled.

Disable

To delete an Open-Xchange user:

1. Select the user whose profile you want to disable by ticking the appropriate box, then click Disable.
   
   
2. A message will ask you to confirm that you want to disable the user. Click Accept for confirmation.

Groups

On this tab you can create, delete and edit groups of users.

Add new group

To add a new group:

1. Click on the Add new group button.
   
   
2. Enter a name for the group.
3. Select the users that you want to add to the group and click to add them. Then click Save.
4. You will then see the group you have created and the users that belong to it.
   
   

Delete group

In order to delete a group, select it by ticking the appropriate box and then click Delete selected groups.

Edit group

You can also edit the name of the group or add/remove members. To do that, click on the group’s name. You will then see the group’s details and you can edit its name and add or remove users by selecting them and clicking or accordingly.

Resources

On this tab you can add, delete and edit any resources you may need.

Add resource

To add a resource:

1. Click on Add new resource.
2. Enter the resource’s details:
   • Resource name: name that you want to call the resource.
   • Resource manager: select the person that will manage the resource from the drop-down list.
   • Display name: resource name that will be displayed.
   • Description: description of the resource. This field is not mandatory.
   • Resource email: enter the email and choose the domain from the drop-down list.
     
     
3. Click Save resource.

Delete resource

In order to delete a resource, select it by ticking the appropriate box and then click Delete resources.

Edit resource

You can also edit resources to change their details. In order to do so, click on the resource’s display name. All the details will be shown so that you can change any information. Click Save resource to save the details.

Domains

On this tab you can add and delete domains and subdomains.

Add domain

To add a domain:

1. Click on Add domain.
2. Select the catch all address from the dropdown list to avoid losing email due to misspellings.
   
   
3. Click Save.

Add subdomain

1. Click on Add subdomain.
2. Enter the following details:
   • Subdomain: enter the subdomain’s name and select the domain from the dropdown list.
   • Catch all: select, if appropriate, the catch-all email address from the drop-down list.
     
     
3. Click Save.

Remove domains

To remove a domain, you just have to tick the appropriate one from the list of existing domains and click on Remove domains.

Edit domains

To edit a domain, click on the pencil button under the Actions column. The details will be displayed for you to change, if necessary. Then click Save to save the changes.

Purchase Requests

The purchase requests tab shows all purchases that users have requested. These are made from the OX App Suite application as an upgrade request. After that, they will be listed on this tab and from here the customer will be able to proceed with the profile upgrade or cancel it using the “Proceed” or “Reject” buttons, accordingly.