Service Desk 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:

setup.doLast {
    ...
    
    // Entry-Types:
    def entryTypesDir = new File(pinuts.um.cmsbsConfDir, 'entryTypes')
    fileTree('cmsbs-conf/entryTypes').each {target ->
        ln(target, entryTypesDir)
    }
    
    // UM REST Proxy
    cp('UM/web-integration/cmsbs-restproxy.war', new File(pinuts.um.webappsDir, 'p.war'))
    cp('rest-proxy/cmsbs-restproxy.properties', new File(pinuts.um.serverHome, 'cmsbs-restproxy.properties'))
}

Create configuration files

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

include: cmsbs-conf/cse/plugins/de.pinuts.servicedesk/servicedesk.attributes

# Disable Composite Unique Key
isUnique = ""

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

cmsbs.gui.login = internal

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

// Pinuts File Encoding: UTF-8

var SERVICEDESK2_CONFIG = {
    baseUrl: 'http://localhost:8080/cmsbs',
};

Setup UM

Let gradle install all dependencies:

gradle setup

Create backoffice “admin” user

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

(cd UM/scripts/ && ./userTool.sh cmsbs.properties -admin)

Startup UM

Startup your UM instance:

gradle run

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.