Zum Ende der Metadaten springen
Zum Anfang der Metadaten

Sie zeigen eine alte Version dieser Seite an. Zeigen Sie die aktuelle Version an.

Unterschiede anzeigen Seitenhistorie anzeigen

Version 1 Nächste Version anzeigen »

This tutorial explains how to install the Service Desk App.

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.

A) Install manually

If you need to install into an already existing UM you probably need to perform a manual installation as described in this section.

Go to https://www.universal-messenger.de/knowledge-base/intern/02_downloads/addons/index.html and download the Service Desk 2 App package (ZIP file).

Unzip the file right into your UM folder (where subfolders like cmsbs-conf/ and cmsbs-work/ live):

(cd UM && unzip $DOWNLOAD_DIR/ServiceDesk2-x.y.z.zip)

Restart your UM instance.

Configure and install REST Proxy

Follow https://www.universal-messenger.de/knowledge-base/intern/doc-en/Administration/REST-proxy.html to install and configure your REST-Proxy.

Add the following endpoints to your REST-Proxy’s controller whitelist:

  • de.pinuts.servicedesk.widget

  • de.pinuts.servicedeskform.Widget

B) 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:ServiceDesk2:1.9.19')
}

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 um/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 um/cmsbs-conf/conf.d/sd.attributes:

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

additional.attributes[] = entrytype
grp.std_intern.members[] = entrytype

entrytype.isPrimary = true
entrytype.title = "EntryType"
entrytype.dbSize = 32
entrytype.display.height = 1
entrytype.values[] = admin
entrytype.value.admin = Backoffice User
entrytype.default = admin

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

cmsbs.entrytypes.attribute = "entrytype"
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',
};

Create a new Entry-Type definition file cmsbs-conf/entryTypes/type_admin.properties:

attribute.groups = *std_personal

attr.uid.title.de = "Login"
attr.uid.title.en = "Login"

grp.std_personal.title = "Admin User"
grp.std_personal.show = true
grp.std_personal.members = uid firstname lastname email password cmsbs.isadmin admin_role lang sd_memberof

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

Let gradle install the new dependency and start your UM instance:

gradle setup 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.

  • Keine Stichwörter