Service Desk Installation

This tutorial explains how to install the Service Desk App into a newly installed UM 7.45 through 7.51.

Starting with release 7.52, the Service Desk App is shipped with the regular UM installer and does not need to be installed separately. See https://pinutswiki.atlassian.net/wiki/spaces/UMDOC/pages/4074635265 for information on how to active the Service Desk App in an existing UM installation.

Install Service Desk App

You can either

A) download App package from the download page and install it manually
B) or – if you are a developer – use UM Kickstarter

Either way you’ll need a license that covers de.pinuts.servicedesk to successfully install and use the Login App. Please contact support@pinuts.de when in doubt.

Install using UM Kickstarter

Start a new Kickstarter project

See Install Kickstarter

umkickstarter um
cd um

Add Service Desk as a dependency

Edit build.gradle to add ServiceDesk:

dependencies {
    runtime('de.pinuts.cmsbs:UM:7.51.4')
    runtime('de.pinuts.cmsbs:ServiceDesk2:4.1.3')
}

Configure REST Proxy

Create a file named rest-proxy/cmsbs-restproxy.properties that configures the REST Proxy:

cmsbs.resturl=http://localhost:8080/cmsbs/rest

cmsbs.restproxy.limit.controller.whitelist.sd1 = "de.pinuts.servicedesk.widget"
cmsbs.restproxy.limit.controller.whitelist.sd2 = "de.pinuts.servicedeskform.Widget"

Insert the following cp lines to your build.gradle file:

Create configuration files

Create a new file cmsbs-conf/conf.d/sd.attributes:

Create a new file cmsbs-conf/conf.d/sd.properties:

Create a new file cmsbs-conf/conf.d/sd.config.js:

Setup UM

Let gradle install all dependencies:

Create backoffice “admin” user

Use the User Tool to create your very first backoffice user account:

Startup UM

Startup your UM instance:

Login to http://localhost:8080/cmsbs as admin / admin

Create Service Desk “Groups”

Goto Entries / New: ServiceDesk Group and create a handful of groups with at least a Group ID and a Group name.

Create Service Desk backoffice user

Goto Entries / New: Backoffice User and create a new User with Login, Password, Administrator? and at least one Service Desk group membership.

Login as Service Desk user

Now, re-login to http://localhost:8080/cmsbs as the newly created Service Desk backoffice user.