Info |
---|
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
...
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
...
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):
Codeblock | ||
---|---|---|
| ||
(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
...
using UM Kickstarter
Start a new Kickstarter project
...
Codeblock | ||
---|---|---|
| ||
dependencies { // ...runtime('de.pinuts.cmsbs:UM:7.51.4') runtime('de.pinuts.cmsbs:ServiceDesk2:4.1.9.193') } |
Configure REST Proxy
Create a file named rest-proxy/cmsbs-restproxy.properties
that configures the REST Proxy:
...
Insert the following cp lines to your um/build.gradle
file:
Codeblock | ||
---|---|---|
| ||
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
:
Codeblock |
---|
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# Disable Composite Unique Key isUnique = "" |
Create a new file cmsbs-conf/conf.d/sd.properties
:
Codeblock |
---|
cmsbs.entrytypes.attribute = "entrytype"
cmsbs.gui.login = internal |
Create a new file cmsbs-conf/conf.d/sd.config.js
:
Codeblock | ||
---|---|---|
| ||
// Pinuts File Encoding: UTF-8 var SERVICEDESK2_CONFIG = { baseUrl: 'http://localhost:8080/cmsbs', }; |
...
Setup UM
Let gradle install all dependencies:
Codeblock |
---|
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_memberofgradle setup |
Create backoffice “admin” user
...
Codeblock | ||
---|---|---|
| ||
(cd UM/scripts/ && ./userTool.sh cmsbs.properties -admin) |
Startup UM
Let gradle install the new dependency and start Startup your UM instance:
Codeblock |
---|
gradle setup run |
Login to http://localhost:8080/cmsbs as admin
/ admin
...