Troubleshoot Qlik Sense using logs

QlikSense
3.0
Copyright1993-2016QlikTechInternationalAB.Allrightsreserved.

Copyright 1993-2016 QlikTech International AB. All rights reserved.

Qlik, QlikTech, Qlik Sense, QlikView, Sense and the Qlik logo are trademarks which have been
registered in multiple countries or otherwise used as trademarks by QlikTech International AB. Other
trademarks referenced herein are the trademarks of their respective owners.

Contents
1 Introduction

13

1.1Conventions

13

Stylecoding
Environmentvariables
1.2Additionaldocumentation

13
14
14

2 Qlik Sense Repository Service

15

2.1Updateuser

15

Procedure
Success
2.2Deleteuser

15
15
15

Procedure
Success
2.3Openapp

15
15
16

Procedure
Success
Errors
Youraccountisinactive
2.4Createapp

16
16
16
16
16

Procedure
Success
Errors
Forbidden
2.5Deleteapp

16
16
17
17
17

Procedure
Success
Errors
TheDeleteoperationfailed
2.6Publishapp

17
17
17
17
17

Procedure
Success
2.7Exportapp

17
18
18

Procedure
Success
Errors
Resourcenotfound
2.8Importapp

18
18
18
18
18

Procedure
Success
Errors
Corruptdata
Writefailed
Resourcenotfound
2.9Reloadapp

18
19
19
19
19
19
20

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

Contents
Procedure
Success
2.10Duplicateapp

20
20
20

Procedure
Success
Errors
Resourcenotfound
2.11Addappobject

20
20
21
21
21

Procedure
Success
2.12Updateappobject

21
21
21

Procedure
Success
2.13Deleteappobject

21
21
22

Procedure
Success
2.14Publishappobject

22
22
22

Procedure
Success
2.15Unpublishappobject

22
22
22

Procedure
Success
2.16Addextension

22
22
23

Procedure
Success
2.17Createextension

23
23
23

Procedure
Success
2.18Uploadextension

23
23
23

Procedure
Success
Errors
Theprocesscannotaccessthefile
2.19Deleteextension

23
23
24
24
24

Procedure
Success
2.20Addextensioncontent

24
24
24

Procedure
Success
2.21Deleteextensioncontent

24
24
25

Procedure
Success
2.22Addcontentlibrary

25
25
25

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

Contents
Procedure
Success
2.23Deletecontentlibrary

25
25
25

Procedure
Success
2.24Uploadcontentlibrarycontent

25
25
26

Procedure
Success
Errors
Exceptionoftype'Qlik.Sense.Common.Exceptions.ConflictException'wasthrown
2.25Deletecontentlibrarycontent

26
26
26
26
26

Procedure
Success
2.26Adduseraccess

26
26
26

Procedure
Success
Errors
Validationfailed
2.27Updateuseraccess

26
27
27
27
27

Procedure
Success
2.28Deleteuseraccess

27
27
27

Procedure
Success
2.29Licenseuseraccessrequest

27
28
28

Procedure
Success
2.30Licenseuseraccess

28
28
28

Procedure
Success
Errors
Loginaccessdenied
2.31Adduseraccessfromlicense

28
28
28
28
29

Procedure
Success
Errors
Cannotadduseraccess
2.32Addappprivilege

29
29
29
29
29

Procedure
Success
2.33Exportcertificates

29
29
30

Procedure
Success

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

30
30

Contents
2.34Downloadlicense

30

Procedure
Success
Errors
License:Invalidserialnumberorcontrolnumber
2.35Addlicense

30
30
30
30
30

Procedure
Success
Errors
License:Invalidserialnumberorcontrolnumber
2.36Updatelicense

30
30
31
31
31

Procedure
Success
Errors
License:Invalidserialnumberorcontrolnumber
2.37Deletelicense

31
31
31
31
31

Procedure
Success
2.38Addrule

31
31
32

Procedure
Success
2.39Updaterule

32
32
32

Procedure
Success
2.40Deleterule

32
32
32

Procedure
Success
2.41Addstream

32
32
33

Procedure
Success
2.42Deletestream

33
33
33

Procedure
Success
2.43Servernoderegistration

33
33
33

Procedure
Success
Errors
Cannotreachthefollowingremotehostwhendistributingcertificates
2.44Servernodeconfiguration

33
33
34
34
34

Procedure
Success
2.45Createtask

34
34
34

Procedure

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

34

Contents
Success
2.46Updatetask

34
34

Procedure
Success
2.47Deletetask

34
35
35

Procedure
Success
2.48Starttask

35
35
35

Procedure
Success
Errors
Resourcenotfound
2.49Stoptask

35
35
36
36
36

Procedure
Success
2.50Synchronizeuserdirectory

36
36
37

Procedure
Success
2.51Startrepository

37
37
37

Procedure
Success
Errors
Certificatesarenotcorrectlyinstalled
2.52Stoprepository

37
37
37
37
38

Procedure
Success
2.53Checkservicestatus

38
38
38

Procedure
Success
Errors
Thefollowingserviceaccountdoesnotexist
2.54Loadplugin

38
38
38
38
38

Procedure
Success
2.55Auditrules

38
39
39

Procedure
Success
2.56Auditsecurity

39
39
39

Procedure
Success
2.57Auditlicense

39
39
39

Procedure
Success

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

39
39

Contents
2.58Auditlicenserule

40

Procedure
Success
2.59Licensemaintenance

40
40
40

Procedure
Success
2.60Distributecertificate

40
40
40

Procedure
Success
Errors
Certificatedistributionfailed
3 Qlik Sense Proxy Service

40
40
41
41
42

3.1Startproxy

42

Procedure
Success
Errors
Erroroccurredwhileretrievinghardwareinformation
Proxywillnotbelisteningtoport'443'
3.2Stopproxy

42
42
42
42
42
43

Procedure
Success
3.3Openconnection

43
43
43

Procedure
Success
Errors
Websocketconnectioncouldnotbeopened
Webexception:Protocolerror:Responsestreamexists
Webexception:Protocolerror:Noresponsestreamexists
Webexceptionwhencontactingserviceuri
Connectionhasbeentransferredtoastreamingstatetosendasingleerrormessage
Websocketconnectioncouldnotbeopened
3.4Closeconnection

43
43
43
43
44
44
44
44
45
45

Procedure
Success
Errors
Websocketconnectioncouldnotbeopened
Command=Openconnection;Result=<differentfromzero>
3.5Startsession

45
45
45
45
46
46

Procedure
Success
Errors
Cannotstartsession
3.6Stopsession

46
46
46
46
47

Procedure

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

47

Contents
Success
Errors
Cannotstopsession
3.7Logout

47
47
47
47

Procedure
Success
Errors
Command=Logout;Result=<returncodenotzero>
3.8Login

47
47
48
48
48

Procedure
Success
Errors
Logonfailed
3.9Installcertificate

48
48
48
48
49

Procedure
Success
4 Qlik Sense Scheduler Service

49
49
50

4.1Starttask

50

Procedure
Success
Errors
Tasknotfound
Schedulerisnotlicensed
SchedulerisnotMaster
FoundactivesessionforTask
Taskdisabled
TaskExecutionSessionalreadyexists
Appisnotenabled
NoslavenodesfoundtoexecuteTask
UnabletocreateTaskExecutionSession
Unexpectedexceptionwhenstartingtask
Unexpectedexceptionwhentryingtostarttask
Maxnumberofretriesreachedfortask
Notpossibletoinitiateretry
4.2Finishtask

50
50
50
50
50
51
51
51
51
51
52
52
52
52
52
52
53

Procedure
Success
Errors
FailedinTaskCompletedFail
Taskfinishedwithstate<State>
Failedtoremovesession
UnexpectedexceptioninTaskCompletedSuccess
UnexpectedexceptioninTaskCompletedFail
Taskfailed

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

53
53
53
53
53
53
53
54
54

Contents
4.3Executetask

54

Procedure
Success
Errors
Tryingtosettaskidtostate
TaskExecutionSessioncannotbenull
Suppressedstatechange
Unabletoget<Task.Name>
4.4Startmaster

54
54
54
54
55
55
55
55

Procedure
Success
4.5Startslave

55
55
56

Procedure
Success
4.6Resumemaster

56
56
56

Procedure
Success
4.7Resumeslave

56
56
56

Procedure
Success
4.8Readinitialsettings

56
56
56

Procedure
Success
4.9Loghardwareinformationatthestartupoftheservice

56
57
57

Procedure
Success
Errors
Failedwhenlogginghardwareinformation
4.10Stopmaster

57
57
57
57
57

Procedure
Success
4.11Stopslave

57
57
58

Procedure
Success
4.12Pausemaster

58
58
58

Procedure
Success
4.13Pauseslave

58
58
58

Procedure
Success
4.14Settingschangeforslave

58
58
58

Procedure
Success

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

58
59

10

Contents
5 Qlik Sense Engine Service

60

5.1Openapp

60

Procedure
Success
Errors
Alreadyopenedindifferentmode
Alreadyopened
Invalidpath
Resourcenotfound
5.2Createapp

60
60
60
60
60
61
61
61

Procedure
Success
Errors
Invalidname
5.3Deleteapp

61
61
61
61
62

Procedure
Success
Errors
Deletefailed
5.4Exportapp

62
62
62
62
62

Procedure
Success
Errors
Diskisfull
Filecorrupt
5.5Importapp

62
62
63
63
63
63

Procedure
Success
Errors
Filecorrupt
Internalerror
5.6Reloadapp

63
63
63
63
64
64

Procedure
Success
5.7Duplicateapp

64
64
64

Procedure
Success
Errors
Deletefailed
5.8Publishapp

64
64
64
64
65

Procedure
Success
Errors
Accessdenied

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

65
65
65
65

11

Contents
RESTconnectionfailure
5.9Unpublishapp

65
65

Procedure
Success
Errors
Accessdenied
RESTconnectionfailure
5.10Replaceapp

65
66
66
66
66
66

Success
5.11Startengine

66
66

Procedure
Success
Errors
Registrationfailure
5.12Stopengine

66
67
67
67
67

Procedure
Success
Errors
Cachetrimmerneverstopped

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

67
67
68
68

12

1 Introduction

Introduction

TroubleshootingmaybeneededwhenQlikSensedoesnotbehaveasexpected(forexample,ifthesystem
respondswithanerrormessagethatneedsfurtherinvestigationordoesnotrespondatallwhenanerror
occurs).
ThelogmessagesproducedbyQlikSenseprovideimportantinformationthatcanbeusedtodetectsecurity
incidents,operationalproblems,andpolicyviolations.
ThedescriptionofhowtotroubleshootQlikSenseusinglogsisbasedon"usecases",eachofwhich
correspondstoatypicaluserorsystemaction,suchasopeninganapporstoppingatask.
Eachusecaseisdescribedusingthesectionslistedinthefollowingtable.

Section

Description

Procedure

Thissectionliststheactionsthatareperformed(andlogged)byQlikSensewhentheuse
caseiscarriedout.

Success

ThissectionliststhelogfilestowhichQlikSensewriteslogentriesincaseofsuccess.

Errors

Thissectionlistserrorsthatmayoccurwhentheusecaseisperformed.
Itisrecommendedtocheckthe<MachineName>_Service_<Service>.txtfileincaseofan
errorasallerrorsareloggedinthisfile.Eacherrorsectionalsoincludesadescriptionofthe
actionstoperformincaseofanerror.

For some use cases, there is no Error section. Information on errors will be
added in future releases of the Qlik Sense documentation.

ThisdocumentisderivedfromtheonlinehelpforQlikSense.Itisintendedforthosewhowanttoreadparts
ofthehelpofflineorprintpageseasily,anddoesnotincludeanyadditionalinformationcomparedwiththe
onlinehelp.

1.1 Conventions
ThefollowingconventionsareusedinthedocumentationforQlikSense.

Stylecoding
l Menucommandsanddialogoptionsarewritteninbold.
l FilenamesandpathsarewritteninItalics.
l SamplecodeiswritteninLucida Console.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

13

1 Introduction
Environmentvariables
ThepathsusedinthedocumentationforQlikSensemayuseenvironmentvariables.Thevariablesandthe
equivalentpathsintheMicrosoftWindowsoperatingsystemarelistedbelow.

Environment variable

Microsoft Windows

%LocalAppData%

C:\Users\<username>\AppData\Local

%ProgramData%

C:\ProgramData

%ProgramFiles%

C:\Program Files

%UserProfile%

C:\Users\<username>

1.2 Additionaldocumentation
Besidesthisdocument,thefollowingrelateddocumentationisavailableforQlikSense:
l ManageQlikSensesites:DescribeshowtomanageaQlikSensesite.
l PlanQlikSensedeployments:DescribesQlikSenseandprovidesreferenceinformationonthe
architecture,security,logging,andlicensing.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

14

2 Qlik Sense Repository Service

QlikSenseRepositoryService

ThissectiondescribeshowtousetheQlikSenselogstotroubleshootproblemsrelatedtotheQlikSense
RepositoryService(QRS).

See also:
p

Introduction (page 13)

2.1 Updateuser
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSverifiesthattheupdatedoesnotdisableanyserviceaccountthattheuserisallowedto
update.
3. TheQRSupdatestheuser.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Repository.txt

2.2 Deleteuser
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSverifiesthattheusertobedeletedisnotaserviceaccountorthelastuserwithrootadmin
access.
3. TheQRSremovestheuser.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Repository.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

15

2 Qlik Sense Repository Service

2.3 Openapp
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSchecksthattheappexists.
3. TheQRSchecksthattheuserisallowedtoopentheapp.
4. TheQRSsendsarequesttotheQlikSenseEngineService(QES).
5. TheQEScheckstheaccesstothedatasetintheapp.
6. TheQESloadstheappandreturnsit.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt
l <MachineName>_AuditActivity_Engine.txt

Errors
Youraccountisinactive
Description

Command=Openapp;Result=403;ResultText=Error:Security

Message

Youraccountisinactive.Contactyouradministratortoactivateit.(HTTPcode:403)

Action

ContacttheQlikSensesystemadministratortoobtainthecorrectaccessrights.

2.4 Createapp
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSchecksthattheuserisallowedtocreateanapp.
3. TheQRSsendsarequesttotheQlikSenseEngineService(QES).
4. TheQEScreatestheapp.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

16

2 Qlik Sense Repository Service

Errors
Forbidden
Description

Command=Createapp;Result=403;ResultText=Error:Security

Message

Forbidden(HTTPcode:403)

Action

Theuserisnotallowedtocreateanapp.

2.5 Deleteapp
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSmarkstheappasdeletedintherepositorydatabase.
3. TheQRSrequeststheQlikSenseEngineService(QES)todeletetheappfromdisk.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt
l <MachineName>_AuditActivity_Engine.txt

Errors
TheDeleteoperationfailed
Description

Command=Deleteapp;Result=400;ResultText=Error:PersistenceFailed

Message

TheDeleteoperationfailed(HTTPcode:400)

Action

Probablecauseoferror:Theappdoesnotexist.

2.6 Publishapp
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSlinkstheapptoastream.
3. TheQRSchecksifthepublishedappisrenamed.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

17

2 Qlik Sense Repository Service

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.7 Exportapp
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSprovidestheQlikSenseEngineService(QES)withtheinformationneededtofindtheapp.
3. TheappIDisdownloadedfromtheQEStotheclient.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt
l <MachineName>_AuditActivity_Engine.txt

Errors
Resourcenotfound
Description

Command=Exportapp;Result=9003;ResultText=Error:EngineQix

Message

ResourcenotfoundParameters:QVFheadererror(read)(HTTPcode:400)

Actions

Proceedasfollows:
1. CheckthattheresourceexistsintheQlikManagementConsole(QMC).
2. VerifythatyoucanopentheappintheQlikSensehub.
3. CheckiftheQVFfileexistsonthecentralnodeoronarimnodeintheQlikSense
site.

2.8 Importapp
Procedure
QlikSenseperformsthefollowingprocedure:

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

18

2 Qlik Sense Repository Service

1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. IfyouhaveaccesstotheQlikSensesystemwheretheappwascreated,thefollowinghappens:
a. TheQRSstoresmetadataintherepositorydatabase.
b. TheQRScontactstheQlikSenseEngineService(QES).
c. Theappismigrated(ifnecessary).
3. TheQESimportstheapp(includingobjects)andpersistsit.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt
l <MachineName>_AuditActivity_Engine.txt

Errors
Corruptdata
Description

Command=Importapp;Result=11;ResultText=Error:EngineQix

Message

CorruptdataParameters:QVFFilecorrupt(HTTPcode:500)

Action

Theformatoftheappisinvalidanditcannotbeimported.

Writefailed
Description

Command=Importapp;Result=9000;ResultText=Error:EngineQix

Message

WriteFailedParameters:RESTclientresponseerror(HTTPcode:500)

Action

Proceedasfollows:
1. CheckthattheQlikSenseEngineService(QES)isupandrunningastherequest
mayhavetimedout.
2. VerifythatyoucanopentheappwhereitwascreatedinQlikSense.
3. Verifythatyoucanloadappdatainthedataloadeditorandthatyoucanreloadthe
appintheQlikManagementConsole(QMC).
4. Checkthereloadhistoryoftheapp.

Resourcenotfound
Description

Command=Importapp;Result=2;ResultText=Error:EngineQix

Message

ResourcenotfoundParameters:QVFobjecterror(HTTPcode:500)

Action

ProvideaworkingQVFfileforimport.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

19

2 Qlik Sense Repository Service

2.9 Reloadapp
Thedatainanappcanbereloadedindifferentways:
l TheusermanuallyreloadstheappdataintheQlikManagementConsole(QMC).
l Theappdataisreloadedbyascheduledtaskintherepositorydatabase.
l Theusermanuallyloadsdatainthedataloadeditor.Informationonsuchreloadsisloggedin
<MachineName>_AuditActivity_Engine.txt.
See:Reload app (page 64)

Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRScontactstheQlikSenseSchedulerService(QSS).
3. TheQSSstartsthereloadtask.
4. TheQSScontactstheQlikSenseEngineService(QES)andinitiatesareloadoftheapp.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt
l <MachineName>_AuditActivity_Engine.txt
l <MachineName>_AuditActivity_Scheduler.txt

2.10 Duplicateapp
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSchecksthattheappexists.
3. TheQRSchecksthattheuserisallowedtoduplicatetheapp.
4. TheQRSsendsarequesttotheQlikSenseEngineService(QES).
5. TheQESmakesacopyoftheapp.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt
l <MachineName>_AuditActivity_Engine.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

20

2 Qlik Sense Repository Service

Errors
Resourcenotfound
Description

Command=Duplicateapp;Result=-2146233074;ResultText=Error:Resourcenotfound
[LOCERR_PERSISTENCE_NOT_FOUND]:Resourcenotfound(QVFheadererror(read))

Message

Duplicatefailed.App'Test'duplicatedto'Test(1)'.Additionalinfo:'Resourcenotfound
[LOCERR_PERSISTENCE_NOT_FOUND]:Resourcenotfound(QVFheadererror
(read))'

Action

Probablecauseoferror:Theapphasbeendeletedfromdisk.Trytoimporttheappagain.

2.11 Addappobject
Procedure
QlikSenseperformsthefollowingprocedure:
1. TheQlikSenseEngineService(QES)contactstheQlikSenseRepositoryService(QRS).
2. Theappobjectisaddedtotherepositorydatabaseinabulkoperation.
3. TheQESpersiststheappobject.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.12 Updateappobject
Procedure
QlikSenseperformsthefollowingprocedure:
1. TheQlikSenseEngineService(QES)contactstheQlikSenseRepositoryService(QRS).
2. Theappobjectisupdatedintherepositorydatabaseinabulkoperation.
3. TheQESupdatesthepersistedappobject.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

21

2 Qlik Sense Repository Service

2.13 Deleteappobject
Procedure
QlikSenseperformsthefollowingprocedure:
1. TheQlikSenseEngineService(QES)contactstheQlikSenseRepositoryService(QRS).
2. Theappobjectissettobedeletedintherepositorydatabaseinabulkoperation.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.14 Publishappobject
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSsetstheappobjectaspublishedintherepositorydatabase.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.15 Unpublishappobject
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSsetstheappobjectasunpublishedintherepositorydatabase.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

22

2 Qlik Sense Repository Service

2.16 Addextension
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSaddstheextension.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.17 Createextension
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRScreatestheextension.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.18 Uploadextension
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSuploadstheextension.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

23

2 Qlik Sense Repository Service

Errors
Theprocesscannotaccessthefile
Description

Command=Uploadextension;Result=500;ResultText=Error:IO

Message

Theprocesscannotaccessthefile'<Filename>'becauseitisbeingusedbyanother
process.(HTTPcode:500)

Action

Trythefollowingmeasures:
l WaitforanyongoingprocessintheQlikManagementConsole(QMC)tofinishand
thenuploadtheextensionagain.
l RestarttheQRS.

2.19 Deleteextension
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSdeletestheextension.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.20 Addextensioncontent
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSaddstheextensioncontent.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

24

2 Qlik Sense Repository Service

2.21 Deleteextensioncontent
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSdeletestheextensioncontent.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.22 Addcontentlibrary
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSaddsthecontentlibrary.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.23 Deletecontentlibrary
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSdeletesthecontentlibrary.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

25

2 Qlik Sense Repository Service

2.24 Uploadcontentlibrarycontent
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSuploadsthecontentlibrarycontent.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

Errors
Exceptionoftype'Qlik.Sense.Common.Exceptions.ConflictException'was
thrown
Description

Command=Uploadcontentlibrarycontent;Result=409;ResultText=Error:Conflict

Message

Exceptionoftype'Qlik.Sense.Common.Exceptions.ConflictException'wasthrown.(HTTP
code:409)

Action

Thelibrarycontentalreadyexists.Renameorreplacethelibrarycontent.

2.25 Deletecontentlibrarycontent
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSdeletesthecontentlibrarycontent.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.26 Adduseraccess
Procedure
QlikSenseperformsthefollowingprocedure:

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

26

2 Qlik Sense Repository Service

1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSverifiesthattheaccesscanbeadded.
3. TheQRSaddstheaccess.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Repository.txt

Errors
Validationfailed
Description

Command=AddUserAccess;Result=400;ResultText=Error:BadRequest

Message

<BrokenRules>

Action

Makesurethatyouareallowedtoaddtheaccess.

2.27 Updateuseraccess
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSverifiesthattheaccesscanbeupdated.
3. TheQRSupdatestheaccess.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Repository.txt

2.28 Deleteuseraccess
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSverifiesthattheaccesscanbedeleted.
3. TheQRSdeletestheaccess.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

27

2 Qlik Sense Repository Service

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Repository.txt

2.29 Licenseuseraccessrequest
Procedure
QlikSenseperformsthefollowingprocedure:
l QlikSensechecksthattheuserhasavalidaccesspass.Thisisdoneeverytimeauserrequests
accesstoaresource(suchasanapp).

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Repository.txt

2.30 Licenseuseraccess
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseRepositoryService(QRS)checkstheQlikSenselicensetodetermineiftheusercan
begivenanaccesspass.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Repository.txt

Errors
Loginaccessdenied
Description

Command=Licenseuseraccess;Result=403;ResultText=Error:Accessdenied

Message

LoginaccessdeniedforSessionID:'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',Hostname:
"xx.xx.xx.xx",OperationType:'UsageDenied'

Action

ContacttheQlikSensesystemadministratortoobtainthecorrectaccessrights.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

28

2 Qlik Sense Repository Service

2.31 Adduseraccessfromlicense
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSverifiesthattheuseraccesscanbeadded.
3. TheQRSidentifiestheuseraccess.
4. TheQRSaddstheuseraccess.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Repository.txt

Errors
Cannotadduseraccess
Description

Command=Adduseraccessfromlicense;Result=400;ResultText=Error:BadRequest

Message

<BrokenRules>

Action

Checkthefollowing:
l Thatthelicensehasnotexpired
l Thatthelicenseisnotblacklisted
l ThatthereareenoughtokensavailableintheQlikSenselicense

2.32 Addappprivilege
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseRepositoryService(QRS)addsappprivilegestotheappropriateusergroups.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Repository.txt.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

29

2 Qlik Sense Repository Service

2.33 Exportcertificates
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseRepositoryService(QRS)exportsthecertificates.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Repository.txt

2.34 Downloadlicense
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseRepositoryService(QRS)validatesthelicenseanddownloadsit.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Repository.txt

Errors
License:Invalidserialnumberorcontrolnumber
Description

Command=Downloadlicense;Result=400;ResultText=Error:ValidationFailed

Message

License:Invalidserialnumberorcontrolnumber(HTTPcode:400)

Action

ProvideavalidQlikSenselicense.

2.35 Addlicense
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseRepositoryService(QRS)addsthelicenseprovidedbytheuser.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

30

2 Qlik Sense Repository Service

l <MachineName>_AuditSecurity_Repository.txt

Errors
License:Invalidserialnumberorcontrolnumber
Description

Command=Updatelicense;Result=400;ResultText=Error:ValidationFailed

Message

License:Invalidserialnumberorcontrolnumber(HTTPcode:400)

Action

ProvideavalidQlikSenselicense.

2.36 Updatelicense
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseRepositoryService(QRS)addsthelicenseprovidedbytheuser.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Repository.txt

Errors
License:Invalidserialnumberorcontrolnumber
Description

Command=Updatelicense;Result=400;ResultText=Error:ValidationFailed

Message

License:Invalidserialnumberorcontrolnumber(HTTPcode:400)

Action

ProvideavalidQlikSenselicense.

2.37 Deletelicense
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseRepositoryService(QRS)deletesthelicense.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

31

2 Qlik Sense Repository Service

2.38 Addrule
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSaddstherule.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.39 Updaterule
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSupdatestherule.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.40 Deleterule
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSdeletestherule.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

32

2 Qlik Sense Repository Service

2.41 Addstream
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSaddsthestream.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.42 Deletestream
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSdeletesthestream.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.43 Servernoderegistration
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseRepositoryService(QRS)establishesaconnectiontothespecifiedserveraddress.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

33

2 Qlik Sense Repository Service

Errors
Cannotreachthefollowingremotehostwhendistributingcertificates
Description

Command=Servernoderegistration;Result=400;ResultText=Error:REST

Message

Cannotreachthefollowingremotehostwhendistributingcertificates:
http://<ServerAddress>:4444/setup/certificateDistribution(HTTPcode:400)

Action

Provideavalidserveraddress.

2.44 Servernodeconfiguration
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseRepositoryService(QRS)updatestheconfigurationforaservernode.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.45 Createtask
Procedure
QlikSenseperformsthefollowingprocedure:
1. TheQlikSenseRepositoryService(QRS)createsataskandstoresitintherepositorydatabase.
2. ThetaskinformationissynchronizedbytheQRStotherimnodes.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.46 Updatetask
Procedure
QlikSenseperformsthefollowingprocedure:

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

34

2 Qlik Sense Repository Service

1. TheQlikSenseRepositoryService(QRS)updatesthetaskandstoresitintherepositorydatabase.
2. TheupdatedtaskinformationissynchronizedbytheQRStotherimnodes.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.47 Deletetask
Procedure
QlikSenseperformsthefollowingprocedure:
1. TheQlikSenseRepositoryService(QRS)deletesthetaskandremovesitfromtherepository
database.
2. ThedeletionofthetaskissynchronizedbytheQRStotherimnodes.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.48 Starttask
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseRepositoryService(QRS)requeststheQlikSenseSchedulerService(QSS)to
executethetask.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

35

2 Qlik Sense Repository Service

Errors
Resourcenotfound

Description

Command=Starttask;Result=-1;ResultText=Error:-----System.Net.WebException:
Unabletoconnecttotheremoteserver--->System.Net.Sockets.SocketException:No
connectioncouldbemadebecausethetargetmachineactivelyrefusedit127.0.0.1:5050
atSystem.Net.Sockets.Socket.EndConnect(IAsyncResultasyncResult)at
System.Net.ServicePoint.ConnectSocketInternal(BooleanconnectFailure,Sockets4,
Sockets6,Socket&socket,IPAddress&address,ConnectSocketStatestate,
IAsyncResultasyncResult,Exception&exception)---Endofinnerexceptionstacktrace---
atSystem.Net.HttpWebRequest.EndGetRequestStream(IAsyncResultasyncResult,
TransportContext&context)atSystem.Net.HttpWebRequest.EndGetRequestStream
(IAsyncResultasyncResult)atSystem.Net.WebClient.UploadBitsRequestCallback
(IAsyncResultresult)-----

Message

TrailingtaskexceptioninSchedulerClient.StartTask('1xx1111x-111x-111x-1xx1111xxx1x1x11'):'-----System.Net.WebException:Unabletoconnecttotheremoteserver
--->System.Net.Sockets.SocketException:Noconnectioncouldbemadebecausethe
targetmachineactivelyrefusedit127.0.0.1:5050 at
System.Net.Sockets.Socket.EndConnect(IAsyncResultasyncResult) at
System.Net.ServicePoint.ConnectSocketInternal(BooleanconnectFailure,Sockets4,
Sockets6,Socket&socket,IPAddress&address,ConnectSocketStatestate,
IAsyncResultasyncResult,Exception&exception) ---Endofinnerexceptionstacktrace
--- atSystem.Net.HttpWebRequest.EndGetRequestStream(IAsyncResultasyncResult,
TransportContext&context) atSystem.Net.HttpWebRequest.EndGetRequestStream
(IAsyncResultasyncResult) atSystem.Net.WebClient.UploadBitsRequestCallback
(IAsyncResultresult)-----'

Action

CheckthattheQlikSenseSchedulerService(QSS)isupandrunning.

2.49 Stoptask
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseRepositoryService(QRS)requeststheQlikSenseSchedulerService(QSS)tostop
theexecutionofthetask.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

36

2 Qlik Sense Repository Service

2.50 Synchronizeuserdirectory
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseRepositoryService(QRS)synchronizestheuserdirectory.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt

2.51 Startrepository
Procedure
QlikSenseperformsthefollowingprocedure:
1. ValidatethecommandlineparametersfortheQRS.
2. TheQRSloadstheloggingframework.
3. TheQRSvalidatesorinitializesthecertificates.
4. TheQRSestablishesaconnectiontotheQlikSenseRepositoryDatabase(QRD).
5. Ifneeded,theQRSperformsthemigrationstepsoftherepositorydatabaseschema.
6. Hardwareinformationiscollected.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_Service_Repository.txt

Errors
Certificatesarenotcorrectlyinstalled
Description

Command=StartRepository;Result=-1;ResultText=Certificatesarenotcorrectlyinstalled

Message

Initializingcertificates.

Action

Theerrorisrelatedtoaninvalidcertificate.Contactyoursystemadministratorforsupport
regardingthecertificates.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

37

2 Qlik Sense Repository Service

2.52 Stoprepository
Procedure
QlikSenseperformsthefollowingprocedure:
1. Theinternalservicesarestopped.
2. Thebackgroundthreadsarestopped.
3. AllQlikSenseservices,exceptfortheQlikSenseRepositoryDatabase(QRD),arestopped.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_Service_Repository.txt

2.53 Checkservicestatus
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseRepositoryService(QRS)checksthatthecommunicationwiththespecifiedQlik
Senseserviceisworking.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_Service_Repository.txt

Errors
Thefollowingserviceaccountdoesnotexist
Description

Command=Checkservicestatus;Result=403;ResultText=Error:Security

Message

Thefollowingserviceaccountdoesnotexist:<Service.Name>(HTTPcode:403)

Action

RestartthespecifiedQlikSenseservice.

2.54 Loadplugin
Procedure
QlikSenseperformsthefollowingprocedure:

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

38

2 Qlik Sense Repository Service

l TheQlikSenseRepositoryService(QRS)loadsthespecifiedpluginsduringtheinstallationprocess.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_Service_Repository.txt

2.55 Auditrules
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseRepositoryService(QRS)fetchesthespecifiedrulesfromtherepositorydatabase.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Repository.txt

2.56 Auditsecurity
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseRepositoryService(QRS)fetchesthespecifiedsecurityrulesfromtherepository
database.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Repository.txt

2.57 Auditlicense
Procedure
QlikSenseperformsthefollowingprocedure:
l AQlikSenseRepositoryService(QRS)threadrunsinthebackground.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

39

2 Qlik Sense Repository Service

l <MachineName>_AuditSecurity_Repository.txt

2.58 Auditlicenserule
Procedure
QlikSenseperformsthefollowingprocedure:
l AQlikSenseRepositoryService(QRS)threadrunsinthebackgroundandmonitorsthelicense
usage.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Repository.txt

2.59 Licensemaintenance
Procedure
QlikSenseperformsthefollowingprocedure:
l AQlikSenseRepositoryService(QRS)threadrunsinthebackground.
Thethreadcontinuouslycheckstheproxysessionslinkedtothelicenseinorderto:
l Preventusersfromover-consuminglicensetokens
l Checkifanychangeslinkedtothelicensepreventtheuserfromconsuminganaccesspass
l Checkiftheproxysessionhastimedoutfortheaccesspass

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Repository.txt

2.60 Distributecertificate
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseRepositoryService(QRS)distributesacertificatetotherimnode.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

40

2 Qlik Sense Repository Service

l <MachineName>_Service_Repository.txt

Errors
Certificatedistributionfailed
Description

Command=Distributecertificate;Result=-2146233088;ResultText=Error:Cannotreach
thefollowingremotehostwhendistributingcertificates:
http://<ServerAddress>:4444/setup/certificateDistribution

Message

Certificatedistributionfailed

Action

Provideavalidserveraddress.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

41

3 Qlik Sense Proxy Service

QlikSenseProxyService

ThissectiondescribeshowtousetheQlikSenselogstotroubleshootproblemsrelatedtotheQlikSense
ProxyService(QPS).

See also:
p

Introduction (page 13)

3.1 Startproxy
Procedure
QlikSenseperformsthefollowingprocedure:
1. TheQlikSenseProxyService(QPS)createsaproxy.
2. TheQPSstartstheproxy.
3. Hardwareinformationiscollected.
4. TheQPSwritesthehardwareinformationinthelogs.
5. TheQPSinstallsthecertificates.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Proxy.txt
l <MachineName>_Service_Proxy.txt

Errors
Erroroccurredwhileretrievinghardwareinformation
Description

Command=Startproxy;Result=-1;ResultText=Erroroccurredwhileretrievinghardware
information

Message

Themessagemayvary.

Action

Checktheregistrysettings.

Proxywillnotbelisteningtoport'443'
PortcollisionsmayoccurwheninternalservicesarestartedduringthestartupoftheQPS:

Description

Command=Startinternalservice;Result=-2147467259;ResultText=Error:Onlyoneusage
ofeachsocketaddress

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

42

3 Qlik Sense Proxy Service

Message

Proxywillnotbelisteningtoport'443'(mostlikelyboundbyanotherprocess)

Action

Proceedasfollows:
1. Makesurethatport443isavailableforQlikSensetouse.
2. RestarttheQlikSenseservices.

3.2 Stopproxy
Procedure
QlikSenseperformsthefollowingprocedure:
1. TheQlikSenseProxyService(QPS)notifiestheQlikSenseRepositoryService(QRS).
2. TheQPSsettingsandnotificationpollerthreadsarestopped.
3. TheQPSchecksthattheQRShasinstalledthecertificate.
4. Theinternalservicesarestopped.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_Service_Proxy.txt

3.3 Openconnection
Procedure
QlikSenseperformsthefollowingprocedure:
l OpenasockettotheQlikSenseEngineService(QES).Thishappenseverytimeauseropensanapp
inQlikSense.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Proxy.txt
l <MachineName>_Service_Proxy.txt

Errors
Websocketconnectioncouldnotbeopened
Description

Command=Openconnection;Result=400;ResultText=Error:Websocketconnectioncould
notbeopened

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

43

3 Qlik Sense Proxy Service

Message

Connection'<IDofconnection>'hasbeentransferredtoastreamingstatetosendasingle
errormessage

Action

Proceedasfollows:
1. CheckiftheQESisupandrunning.Ifnot,starttheQES.
2. CheckthatitispossibletoconnecttotheQES.

Webexception:Protocolerror:Responsestreamexists
Description

Command=Openconnection;Result=400;ResultText=<differentfrom
zero>;ResultText=Error:<errormessage>

Message

Webexception:Protocolerror:Responsestreamexists.Remoteendpoint'{0}'+various
exceptionmessage

Action

Checkthefollowing:
l ThattheQESisupandrunning.
l ThatyoucanconnecttotheQESonport4747locallyontheserver.

Webexception:Protocolerror:Noresponsestreamexists
Description

Command=Openconnection;Result=400;ResultText=<differentfrom
zero>;ResultText=Error:<errormessage>

Message

Webexception:Protocolerror:Noresponsestreamexistswhencontacting'{0}''+various
exceptionmessage

Action

Checkthefollowing:
l ThattheQESisupandrunning.
l ThatyoucanconnecttotheQESonport4747locallyontheserver.

Webexceptionwhencontactingserviceuri
Description

Command=Openconnection;Result=400;ResultText=<differentfrom
zero>;ResultText=Error:<errormessage>

Message

Webexceptionwhencontactingserviceuri{0}'+variousexceptionmessage

Action

CheckthatserviceatURIisavailable.

Connectionhasbeentransferredtoastreamingstatetosendasingleerror
message
Description

Command=Openconnection;Result=400;ResultText=<differentfrom
zero>;ResultText=Error:<errormessage>

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

44

3 Qlik Sense Proxy Service

Message

Connection'{0}'hasbeentransferredtoastreamingstatetosendasingleerrormessage+
variousexceptionmessage

Action

Checkthefollowing:
l ThattheQESisupandrunning.
l ThatyoucanconnecttotheQESonport4747locallyontheserver.

Websocketconnectioncouldnotbeopened
Description

Command=Openconnection;Result=400;ResultText=<differentfrom
zero>;ResultText=Error:<errormessage>

Message

Websocketconnectioncouldnotbeopened

Action

Checkthefollowing:
l ThattheQESisupandrunning.
l ThatyoucanconnecttotheQESonport4747locallyontheserver.

3.4 Closeconnection
Procedure
QlikSenseperformsthefollowingprocedure:
l ClosethesockettotheQlikSenseEngineService(QES).Thishappenseverytimeauserclosesan
app(forexample,byclosingatabinabrowser).

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Proxy.txt

Errors
Websocketconnectioncouldnotbeopened
Description

Command=Openconnection;Result=400;ResultText=Error:Websocketconnectioncould
notbeopened

Message

Connection'<IDofconnection>'hasbeentransferredtoastreamingstatetosendasingle
errormessage

Action

Proceedasfollows:
1. CheckiftheQESisupandrunning.Ifnot,starttheQES.
2. CheckthatitispossibletoconnecttotheQES.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

45

3 Qlik Sense Proxy Service

Command=Openconnection;Result=<differentfromzero>
Description

Command=Openconnection;Result=<differentfromzero>;ResultText=Error:<error
message>

Message

SearchforanylogmessagerelatedtoCloseconnection.
Ifyoufindalogentrysimilartotheonedescribedabove,evaluatetheinformationinthe
Messagefield.

Action

Proceedasfollows:
1. Analyzethememoryconsumptionandrunnetstat(TCPsocketsinillegalstate).If
youencounteranyissues,restarttheQPSasconnections(thatis,websocketsto
theQES)aredisposedbytheQlikSenseProxyService(QPS).
2. Iftheproblempersists,checkthattheQESisupandrunning.
3. ContactQliksupport.

3.5 Startsession
Procedure
QlikSenseperformsthefollowingprocedure:
l AnewproxysessionstartswhenauseraccessesQlikSense.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Proxy.txt

Errors
Cannotstartsession
Ifausercannotstartanewproxysession,itismostlikelyrelatedto:
l TheconfigurationoftheQlikSenseProxyService(QPS)
l Installation-specificissues

Description
Searchforanylogmessagewiththefollowinginformation:
Command=Startsession;Result=<differentfromzero>;ResultText=Error:<error
message>

Message

Ifyoufindalogentrysimilartotheonedescribedabove,evaluatetheinformationinthe
Messagefield.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

46

3 Qlik Sense Proxy Service

Action

IftherearenologentriesforStartsession,checktheconfigurationoftheQPSby
examiningthelogentriesfortheStartproxycommand.

3.6 Stopsession
Procedure
QlikSenseperformsthefollowingprocedure:
l Aproxysessionstopswhenittimesoutorwhentheuserclosesthebrowsertabwherethesessionis
running.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Proxy.txt

Errors
Cannotstopsession
Searchforanylogmessagewiththefollowinginformation:

Description

Command=Stopsession;Result=<differentfromzero>;ResultText=Error:<error
message>

Message

Ifyoufindalogentrysimilartotheonedescribedabove,evaluatetheinformationinthe
Messagefield.

Action

IftherearenologentriesforStopsession,checktheconfigurationoftheQlikSenseProxy
Service(QPS)byexaminingthelogentriesfortheStartproxycommand.
Asalastresort,restarttheQPS.

3.7 Logout
Procedure
QlikSenseperformsthefollowingprocedure:
l Theuserisloggedoutwhentheproxysessiontimesoutorwhentheuseractivelylogsoutorthe
closesallbrowsertabsrelatedtoQlikSense.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Proxy.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

47

3 Qlik Sense Proxy Service

Errors
Command=Logout;Result=<returncodenotzero>
Description

Command=Logout;Result=<returncodenotzero>;ResultText=Error:<errormessage>

Message

Ifyoufindalogentrysimilartotheonedescribedabove,evaluatetheinformationinthe
Messagefield.

Action

Proceedasfollows,ifauserrepeatedlyexperiencesproblemwhenloggingout:
1. RestarttheQlikSenseProxyService(QPS).
2. Analyzethestatusofthesocketsbyrunningnetstatandsearchforsocketsin
CLOSE_WAIT,SYN_SENT,orFIN_WAIT_2state.

3.8 Login
Procedure
QlikSenseperformsthefollowingprocedure:
1. Checkiftheuserislinkedtoavaliduserdirectory.
2. Checkiftheuserexistsintherepositorydatabase.
3. CheckiftheuserhasaccesstoQlikSense.
4. Checkiftheuserhasaccesslinkedtothelicense.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Proxy.txt

Errors
Logonfailed
Description

Command=Login;ResultCode=403;ResultText=Error:AccessDenied

Message

Loginfailedforuser'<username>'wrongcredentials?

Action

Proceedasfollows:
l Checkthattheuserexistsintherepositorydatabase.
l CheckthattheuserhasaccessrightstoQlikSenselinkedtoalicense.
l Checkthattheuserisnotblocked.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

48

3 Qlik Sense Proxy Service

3.9 Installcertificate
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseProxyService(QPS)waitsforthecertificatestobeinstalledintherepository
database.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditSecurity_Proxy.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

49

4 Qlik Sense Scheduler Service

QlikSenseSchedulerService

ThissectiondescribeshowtousetheQlikSenselogstotroubleshootproblemsrelatedtotheQlikSense
SchedulerService(QSS).

See also:
p

Introduction (page 13)

4.1 Starttask
Procedure
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. ThemasterQlikSenseSchedulerService(QSS)onthecentralnodecommunicateswitheachslave
QSStoseewhichonesareavailabletoperformthetask.
3. ThetaskisgiventothecurrentlyavailableslaveQSSwiththeleastloadaccordingtotheloadbalance
rules.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Scheduler.txt
l <MachineName>_AuditActivity_Repository.txt

Errors
Tasknotfound
Description

Command=Starttask;Result=5;ResultText=Error:Failed

Message

Tasknotfound

Action

Trythefollowingmeasures:
l Iftherepositorydatabaseisaccessible,searchthedatabaseforthetask.
l Checkifthetaskhasbeensuccessfullysynchronizedtotherimnodes.
l Createanew,identicaltaskandseeifitworks.

Schedulerisnotlicensed
Description

Command=Starttask;Result=10;ResultText=Error:Failed

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

50

4 Qlik Sense Scheduler Service

Message

Schedulerisnotlicensed.NotallowedtorunTasks

Action

ProvideavalidQlikSenselicense.

SchedulerisnotMaster
Description

Command=Starttask;Result=15;ResultText=Error:Failed

Message

SchedulerisnotMaster.NotallowedtorunTasks

Action

MakesurethattheQSSonthecentralnodeisMasterorMasterandSlave.

FoundactivesessionforTask
Description

Command=Starttask;Result=20;ResultText=Error:Failed

Message

FoundactivesessionforTask.Tasknotstarted

Action

Trythefollowingmeasures:
l Waituntilthetaskhascompleted.
l Stopthetask.
l RestarttheQSS.

Taskdisabled
Description

Command=Starttask;Result=25;ResultText=Error:Failed

Message

Taskdisabled

Action

Enablethetask.

TaskExecutionSessionalreadyexists
Description

Command=Starttask;Result=30;ResultText=Error:Failed

Message

TaskExecutionSessionalreadyexistsforApp<App.Name>

Action

Trythefollowingmeasures:
l Waituntilthetaskthatisreloadingtheapphascompleted.
l Stopthetaskthatisreloadingtheapp.
l RestarttheQSS.

Appisnotenabled
Description

Command=Starttask;Result=35;ResultText=Error:Failed

Message

App<App.Name>isnotenabled

Action

TheappwasnotcorrectlyenabledbytheMigrationService.Trytore-migratetheapp.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

51

4 Qlik Sense Scheduler Service

NoslavenodesfoundtoexecuteTask
Description

Command=Starttask;Result=40;ResultText=Error:Failed

Message

Noslave-nodesfoundtoexecuteTask:<Task.Name>

Action

Proceedasfollows:
1. Checkthestatusoftheslavenodestodetermineiftheycanperformareload.
2. Checkthattheapptoreloadexistsontheslavenodes.

UnabletocreateTaskExecutionSession
Description

Command=Starttask;Result=45;ResultText=Error:Failed

Message

UnabletocreateTaskExecutionSession

Action

RestarttheQSS.

Unexpectedexceptionwhenstartingtask
Description

Command=Starttask;Result=50;ResultText=Error:Failed

Message

Unexpectedexceptionwhenstartingtask.Exceptionmessage:<Exception.Message>

Action

RestarttheQSS.

Unexpectedexceptionwhentryingtostarttask
Description

Command=Starttask;Result=55;ResultText=Error:Failed

Message

Unexpectedexceptionwhentryingtostarttask.Exceptionmessage:
<Exception.Message>

Action

RestarttheQSS.

Maxnumberofretriesreachedfortask
Description

Command=Starttask;Result=80;ResultText=Error:Failed

Message

Maxnumberofretries(<Amount>)reachedfortask(id/name)<Task.ID>/<Task.Name>

Action

RestarttheQSS.

Notpossibletoinitiateretry
Description

Command=Starttask;Result=90;ResultText=Error:Failed

Message

Notpossibletoinitiateretry.TaskExecutionSessionisnull

Action

RestarttheQSS.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

52

4 Qlik Sense Scheduler Service

4.2 Finishtask
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseSchedulerService(QSS)ontheslavenodethatperformedthetaskcommunicates
theresulttothemasterQSS.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Scheduler.txt
l <MachineName>_AuditActivity_Repository.txt

Errors
FailedinTaskCompletedFail
Description

Command=Finishedtask;Result=60;ResultText=Error:Failed

Message

FailedinTaskCompletedFail.ForcingtasktoError

Action

Checkifthetaskhasbeensuccessfullysynchronizedtotherimnodes.

Taskfinishedwithstate<State>
Description

Command=Finishedtask;Result=65;ResultText=Error:Failed

Message

Taskfinishedwithstate<State>

Action

Checkifthetaskhasbeensuccessfullysynchronizedtotherimnodes.

Failedtoremovesession
Description

Command=Finishedtask;Result=70;ResultText=Error:Failed

Message

FailedtoremovesessionwithId<Session.ID>forTaskId<Task.ID>

Action

RestarttheQSS.

UnexpectedexceptioninTaskCompletedSuccess
Description

Command=Finishedtask;Result=50;ResultText=Error:Failed

Message

UnexpectedexceptioninTaskCompletedSuccess.Exceptionmessage:<Message>

Action

RestarttheQSS.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

53

4 Qlik Sense Scheduler Service

UnexpectedexceptioninTaskCompletedFail
Description

Command=Finishedtask;Result=50;ResultText=Error:Failed

Message

UnexpectedexceptioninTaskCompletedFail.Exceptionmessage:<Message>

Action

RestarttheQSS.

Taskfailed
Description

Command=Finishedtask;Result=0;ResultText=Error:Failed

Message

Taskfailed

Action

Checkthetaskforindicationsofwhyitfailed.
Ifthetaskisareloadtask,checktheenginelogsandscriptlogsforindicationsofwhythe
reloadfailed.

4.3 Executetask
Procedure
QlikSenseperformsthefollowingprocedure:
l TheQlikSenseSchedulerService(QSS)logsdifferentstatesinthetaskexecutionchainduringthe
executionofatask.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Scheduler.txt

Errors
Tryingtosettaskidtostate
Description

Command=Taskexecution;Result=55;ResultText=Error:Failed

Message

Tryingtosettask(id)<Task.ID>tostate<State>.Notallowed.Nostatechangewilltake
place!

Action

Proceedasfollows:
1. Re-runthetask.
2. RestarttheQSS.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

54

4 Qlik Sense Scheduler Service

TaskExecutionSessioncannotbenull
Description

Command=Taskexecution;Result=90;ResultText=Error:Failed

Message

TaskExecutionSessioncannotbenull.Unabletoproceedwithstatechangeduetodeleted
taskwithproposedstate:<State>

Action

Proceedasfollows:
1. Re-runthetask.
2. RestarttheQSS.

Suppressedstatechange
Description

Command=Taskexecution;Result=85;ResultText=Error:Failed

Message

Suppressedstatechangeto<State>for<Task.Name>withId<Task.ID>

Action

Noactionisrequired.Thestatewassuppressedwhenthetaskwasstopped.

Unabletoget<Task.Name>
Description

Command=Taskexecution;Result=5,75;ResultText=Error:Failed

Message

Unabletoget<Task.Name>withId<Task.ID>forAuditActivityLog,onlyloggingIdand
NameforTasknotforApp.

Action

Proceedasfollows:
1. Re-runthetask.
2. RestarttheQSS.

4.4 Startmaster
Procedure
QlikSenseperformsthefollowingprocedure:
l ThemasterschedulerstartswhentheQlikSenseSchedulerService(QSS)startsonthecentralnode.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_Service_Scheduler.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

55

4 Qlik Sense Scheduler Service

4.5 Startslave
Procedure
QlikSenseperformsthefollowingprocedure:
l TheslaveschedulerstartswhentheQlikSenseSchedulerService(QSS)starts.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_Service_Scheduler.txt

4.6 Resumemaster
Procedure
QlikSenseperformsthefollowingprocedure:
l ResumeapausedmasterQlikSenseSchedulerService(QSS).

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_Service_Scheduler.txt

4.7 Resumeslave
Procedure
QlikSenseperformsthefollowingprocedure:
l ResumeapausedslaveQlikSenseSchedulerService(QSS).

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_Service_Scheduler.txt

4.8 Readinitialsettings
Procedure
QlikSenseperformsthefollowingprocedure:

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

56

4 Qlik Sense Scheduler Service

l LogtheinitialsettingswhentheQlikSenseSchedulerService(QSS)starts.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_Service_Scheduler.txt

4.9 Loghardwareinformationatthestartupoftheservice
Procedure
QlikSenseperformsthefollowingprocedure:
l LoghardwareinformationduringthestartupoftheQlikSenseSchedulerService(QSS).

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_Service_Scheduler.txt

Errors
Failedwhenlogginghardwareinformation
Description

Command=Startscheduler;Result=50;ResultText=Error:Failed

Message

Failedwhenlogginghardwareinformation

Action

RestarttheQSS.

4.10 Stopmaster
Procedure
QlikSenseperformsthefollowingprocedure:
l ThemasterschedulerstopswhentheQlikSenseSchedulerService(QSS)shutsdownonthecentral
node.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_Service_Scheduler.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

57

4 Qlik Sense Scheduler Service

4.11 Stopslave
Procedure
QlikSenseperformsthefollowingprocedure:
l TheslaveschedulerstopswhentheQlikSenseSchedulerService(QSS)shutsdown.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_Service_Scheduler.txt

4.12 Pausemaster
Procedure
QlikSenseperformsthefollowingprocedure:
l PausearunningmasterQlikSenseSchedulerService(QSS).

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_Service_Scheduler.txt

4.13 Pauseslave
Procedure
QlikSenseperformsthefollowingprocedure:
l PausearunningslaveQlikSenseSchedulerService(QSS).

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_Service_Scheduler.txt

4.14 Settingschangeforslave
Procedure
QlikSenseperformsthefollowingprocedure:

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

58

4 Qlik Sense Scheduler Service

l LogthechangeofsettingsforaslaveQlikSenseSchedulerService(QSS).

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Scheduler.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

59

5 Qlik Sense Engine Service

QlikSenseEngineService

ThissectiondescribeshowtousetheQlikSenselogstotroubleshootproblemsrelatedtotheQlikSense
EngineService(QES).

See also:
p

Introduction (page 13)

5.1 Openapp
Procedure
QlikSenseperformsthefollowingprocedure:
1. Checkiftheappisalreadyopen.
2. Ifnot,loadtheQVFfile.
3. Readtheapppropertiesfromthefile.
4. Readthescriptfromthefile.
5. Opentheapp.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Engine.txt

Errors
Alreadyopenedindifferentmode
Description

Command=Openapp;Result=1009;ResultText=Error:Appalreadyopenindifferentmode

Message

<AppId>

Action

Makesurethattheappisnotopenedwithoutdatawhenyoutrytoopenitwithdataorvice
versa.

Alreadyopened
Description

Command=Openapp;Result=1002;ResultText=Error:Appalreadyopened

Message

<AppId>

Action

Makesurethattheappisnotalreadyopen.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

60

5 Qlik Sense Engine Service

Invalidpath
Description

Command=Openapp;Result=4;ResultText=Error:InvalidPath

Message

Malformedparameters

Action

Makesurethattheappname,password,username,andserialnumberareUTF-8
encodedstrings.

Resourcenotfound
Description

Command=Openapp;Result=9003;ResultText=Error:Resourcenotfound

Message

QVFheadererror(read)

Action

Probablecauseoferror:Theapphasbeendeletedfromdisk.Trytoimporttheappagain.

5.2 Createapp
Procedure
QlikSenseperformsthefollowingprocedure:
1. Checkiftheappnameisvalid.
2. Createtheapp.
3. SavetheQVFfile.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Engine.txt

Errors
Invalidname
Description

Command=Createapp;Result=3001;ResultText=Error:Appsavefailed

Message

<AppName>

Action

Makesurethattheappnamedoesnotcontainanyofthefollowing:
l Specialcharacters:<>:\"/|?*
l DevicenamesthatarereservedinMicrosoftWindows(forexample,COM1and
LPT1)

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

61

5 Qlik Sense Engine Service

5.3 Deleteapp
Procedure
QlikSenseperformsthefollowingprocedure:
1. Unloadallappinstancesfortheapp.
2. DeletetheQVFfile.
3. RequesttheQlikSenseRepositoryService(QRS)todeletethefile.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Engine.txt

Errors
Deletefailed
Description

Command=Deleteapp;Result=9002;ResultText=Error:Deletefailed

Message

<RESTclientresponseerror>

Action

AsthereisnoresponsefromtheQRS,checkifithasstoppedrunningorifitcannot
processrequests.

5.4 Exportapp
Procedure
QlikSenseperformsthefollowingprocedure:
1. OpentheQVFfile.
2. CopytoanewQVFfile.
3. Exporttheappcontents.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Engine.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

62

5 Qlik Sense Engine Service

Errors
Diskisfull
Description

Command=Exportapp;Result=9009;ResultText=Error:Thediskitoutofspace

Message

CopyQvfFile

Action

Freeupsomespaceonthedisk.

Filecorrupt
Description

Command=Exportapp;Result=3002;ResultText=Error:Filecorrupted

Message

CopyQvfFile

Action

Makesurethatthefilethatisexportedtocanbewrittento.

5.5 Importapp
Procedure
QlikSenseperformsthefollowingprocedure:
1. CheckiftheappcanbemigratedtothecurrentversionofQlikSense(ifneeded).
2. Openacopyoftheapptoimport.
3. Removeunwantedobjects(suchasconnections)fromthecopy.
4. RequesttheQlikSenseRepositoryService(QRS)tosavetheapp.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Engine.txt

Errors
Filecorrupt
Description

Command=Importapp;Result=9008;ResultText=Error:Appwascreatedinanewer
productversion

Message

Migration

Action

MakesurethattheappwasnotcreatedinanewerversionofQlikSense.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

63

5 Qlik Sense Engine Service

Internalerror
Description

Command=Importapp;Result=10;ResultText=Error:Internalerror

Message

Couldnotimportfile(ImportApp)

Action

Duringimport,theQVFfileiscopiedtothelocal\Appfolderfirst.Ifthisfails,thefolderis
probablywrite-protected.Thereforecheckforanywrite-protectiononthefolder.

5.6 Reloadapp
Procedure
QlikSenseperformsthefollowingprocedure:
l Executethereloadscript.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Engine.txt

5.7 Duplicateapp
Procedure
QlikSenseperformsthefollowingprocedure:
1. ComparetheappIDsofthesourceandtargetapps.
2. RequesttheQlikSenseRepositoryService(QRS)toopentheapp.
3. CopytheQVFfile.
4. Importthecopyofthefile.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Engine.txt

Errors
Deletefailed
Description

Command=Duplicateapp;Result=8;ResultText=Error:Invalidparameters

Message

Couldnotcopyfile.SrcAppIdandTargetAppIdareidentical

Action

MakesurethatthesourceandtargetIDsarenotidentical.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

64

5 Qlik Sense Engine Service

5.8 Publishapp
Procedure
QlikSenseperformsthefollowingprocedure:
1. Checkiftheappisasessionapp.Ifso,publishingisnotsupported.Asessionapponlyexistsinthe
QlikSenseEngineService(QES)memoryandisnotlinkedtoanyfile.
2. Savetheobjectintherepositorydatabase.
3. RequesttheQlikSenseRepositoryService(QRS)topublishtheapp.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Engine.txt

Errors
Accessdenied
Description

Command=Publishapp;Result=8;ResultText=Error:AccessDenied

Message

Couldnotsaveobjects

Action

Checkifthediskiswrite-protectedasthepublishoperationcouldnotflushtheobjects
neededbeforepublishingtheapp.

RESTconnectionfailure
Description

Command=Publishapp;Result=18;ResultText=Error:Restconnectionfailed

Message

RESTclientresponseerror

Action

AsthereisnoresponsefromtheQRS,checkifithasstoppedrunningorifitcannot
processrequests.

5.9 Unpublishapp
Procedure
QlikSenseperformsthefollowingprocedure:
1. Checkiftheappisasessionapp.Ifso,publishingisnotsupported.Asessionapponlyexistsinthe
QlikSenseEngineService(QES)memoryandisnotlinkedtoanyfile.
2. Savetheobjectintherepositorydatabase.
3. RequesttheQlikSenseRepositoryService(QRS)tounpublishtheapp.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

65

5 Qlik Sense Engine Service

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Engine.txt

Errors
Accessdenied
Description

Command=Unpublishapp;Result=8;ResultText=Error:AccessDenied

Message

Couldnotsaveobjects

Action

Checkifthediskiswrite-protectedasthepublishoperationcouldnotflushtheobjects
neededbeforeunpublishingtheapp.

RESTconnectionfailure
Description

Command=Unpublishapp;Result=18;ResultText=Error:Restconnectionfailed

Message

RESTclientresponseerror

Action

AsthereisnoresponsefromtheQRS,checkifithasstoppedrunningorifitcannot
processrequests.

5.10 Replaceapp
QlikSenseperformsthefollowingprocedure:
1. ArequestissenttotheQlikSenseRepositoryService(QRS).
2. TheQRSupdatestherepositorydatabase.
3. TheQRScontactstheQlikSenseEngineService(QES).

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_AuditActivity_Repository.txt
l <MachineName>_AuditActivity_Engine.txt

5.11 Startengine
Procedure
QlikSenseperformsthefollowingprocedure:

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

66

5 Qlik Sense Engine Service

1. TheQlikSenseEngineService(QES)setsthecurrentexecutionmode(thatis,serverordesktop).
2. TheQESparsesthecommandlinearguments.
3. TheQESconfiguresthelogging.
4. TheQESdetectstheoperatingsystemandversion.
5. TheQESinitializesthecollateandmemorystructures.
6. TheQESsetstheterminationhandlers,startstheinternalthreads,andchecksthelicense.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_Service_Engine.txt

Errors
Registrationfailure
Description

Command=Startengine;Result=-1;ResultText=Error:Servercrash

Message

Servercrashedonregistration

Action

Proceedasfollows:
1. CheckthestatusoftheMigrationService.
2. Checkthatthedefault\Appfolderexists.
3. Checkthestatusofthenetworkcontroller.
4. Checkthestatusofthenetworkport.

5.12 Stopengine
Procedure
QlikSenseperformsthefollowingprocedure:
1. TheQlikSenseEngineService(QES)stopsthecachetrimmer.
2. TheQESclearsthecache.
3. TheQESterminatestheprocesshandlers.
4. TheQESexitsthethreads.

Success
Incaseofsuccess,logentriesarewritteninthefollowingfilesthroughouttheprocedure:
l <MachineName>_Service_Engine.txt

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

67

5 Qlik Sense Engine Service

Errors
Cachetrimmerneverstopped
Description

Command=Stopengine;Result=-1;ResultText=Warning

Message

CacheTrimmerneverstopped

Action

ContactQliksupport.

Troubleshoot Qlik Sense using logs - Qlik Sense, 3.0

68