Professional Documents
Culture Documents
Copyright1994-2012QlikTechInternationalAB,Sweden.
Underinternationalcopyrightlaws,neitherthedocumentationnorthesoftwaremaybecopied,photocopied,
reproduced,translatedorreducedtoanyelectronicmediumormachine-readableform,inwholeorinpart,
withoutthepriorwrittenpermissionofQlikTechInternationalAB,exceptinthemannerdescribedinthe
softwareagreement.
QlikTechandQlikViewareregisteredtrademarksofQlikTechInternationalAB.
ActiveDirectory,Excel,InternetExplorer,Microsoft,.NET,SharePoint,SQLServer,Visual
Studio,Windows,Windows7,Windows2000,WindowsNT,WindowsServer,WindowsVista,
andWindowsXParetrademarksofMicrosoftCorporationintheUnitedStates,othercountries,orboth.
CASiteMinderisaregisteredtrademarkofComputerAssociates.
FirefoxandMozillaareregisteredtrademarksoftheMozillaFoundation.
IBMisatrademarkofInternationalBusinessMachinesCorporation,registeredinmanyjurisdictions
worldwide.
IntelandCoreDuoaretrademarksofIntelCorporationintheU.S.and/orothercountries.
NetWeaverandSAParetrademarksorregisteredtrademarksofSAPAGinGermanyandinseveralother
countries.
NovellisaregisteredtrademarkofNovell,Inc.,intheUnitedStatesandothercountries.
OracleisaregisteredtrademarkofOracleand/oritsaffiliates.
Salesforce.comisatrademarkorregisteredtrademarkofSalesforce.com,Inc.
WikipediaisaregisteredtrademarkoftheWikimediaFoundation.
Othertrademarksarethepropertyoftheirrespectiveownersandareherebyacknowledged.
2 QlikView Server/Publisher
Contents
Contents
Part 1 Introduction 7
1 Overview 9
1.1QlikView 9
1.2QlikTechSupportServices 9
1.3Conventions 9
1.4AboutthisDocument 10
2 Whats New in QlikView 11 Server? 11
3 System Requirements 15
3.1QlikViewServer 15
3.2QlikViewPublisher 16
Part 2 Installation 17
4 Upgrading QlikView 19
4.1UpgradeConsiderations 19
4.2UpgradeProcedure 19
4.3Multi-machinePreparation 20
5 Installing QlikView Server 23
5.1InstallationProfiles 23
5.2LoggingtheInstallation 24
5.3CompletingtheInstallation 24
6 Building a Farm 27
6.1Planning 27
6.2Root/FirstInstall 28
6.3AddingServicesonOtherMachines 28
6.4Clustering 28
Part 3 Architecture 31
7 Roles 33
7.1QlikViewwithPublisher 33
7.2QlikViewwithoutPublisher 34
7.3QlikViewServer 35
7.4WebServer 36
7.5DirectoryServiceConnector 37
7.6ManagementService 38
7.7DistributionService 39
7.8ReloadEngine 39
8 Logging 41
8.1LoggingfromQlikViewServer 41
8.2SessionLog 41
8.3PerformanceLog 42
8.4EventLog 44
8.5End-userAuditLog 45
8.6ManagerAuditLog 45
9 Documents, Data, and Tasks 47
9.1UserDocuments 47
QlikView Server/Publisher 3
Contents
9.2SourceData 48
9.3SourceDocuments 48
9.4Tasks 48
10 Service by Service 51
10.1QlikViewServer 51
10.2QlikViewDistributionService 54
10.3QlikViewPublisherRepository 56
10.4ConfigurationFiles 57
10.5WebServer 59
10.6DirectoryServiceConnector 62
10.7QlikViewManagementService 63
Part 4 Security 65
11 Security Overview 67
12 Protection of the Platform 69
12.1Functionality 69
12.2SpecialAccounts 69
12.3Communication 69
13 Authentication 71
13.1AuthenticationwhenUsingQlikViewServerinaWindowsUserEnvironment 71
13.2AuthenticationwithaQlikViewServerUsinganExistingSingleSign-onSoftwarePackage 72
13.3AuthenticationUsingneitherIWAnorSingleSign-onSoftware 73
13.4QlikViewServerAuthenticationUsingCustomUsers 74
14 Authorization 77
14.1DocumentLevelAuthorization 77
14.2DataLevelAuthorization 77
Part 5 Licensing 79
15 Client Access Licenses 81
15.1CALTypes 81
15.2Identification 82
15.3DocumentCALRestrictions 82
15.4CombiningDifferentCALs 82
15.5LicenseLease 83
15.6ClusterLicensing 83
15.7ColdStandbyServers 83
16 Editions of QlikView Server 85
16.1Editions 85
16.2FeaturesandLimitations 87
Part 6 Appendix 89
17 Silent Installation 91
17.1Settings 92
17.2Dialogs 92
17.3AdditionalDialogs 96
17.4MST 97
17.5AdditionalInformation 97
18 OEM 99
18.1General 99
4 QlikView Server/Publisher
Contents
18.2DetailedFunctionDescription 99
19 DSP Interface 101
19.1DirectoryServiceProvider 101
20 SNMP 103
20.1MIBFile 104
21 Deploying MSI Packages with Group Policies 107
21.1General 107
21.2DeployingtheMSIPackage 107
21.3Step-by-stepGuide 108
22 QlikView Server Extensions 113
22.1AddingExtensionstoQlikViewServer 113
23 Configuring Microsoft IIS for Custom Users 115
24 Triggering EDX Enabled Tasks 119
QlikView Server/Publisher 5
Contents
6 QlikView Server/Publisher
Part 1 Introduction
Part1Introduction
QlikView Server/Publisher 7
8 QlikView Server/Publisher
1 Overview
1 Overview
ThisdocumentdescribesQlikViewServerandcontainsinformationoninstallation,architecture,security,
andlicensing.Thedocumentalsoincludesanumberofappendixesthatprovideadditionalin-depth
information.
1.1 QlikView
QlikView Server
QlikViewServerisaplatformforhostingandsharingQlikViewinformationoveranintranetortheInternet.
QlikViewServerconnectsusers,clienttypes,documents,andobjectswithinasecureenvironment.
QlikView Publisher
QlikViewPublishermanagescontent,access,anddistribution.Byreducingdata,eachusercanbepresented
withtailoredinformation.TheQlikViewPublisherserviceanduserinterfacearefullyintegratedinto
QlikViewServerandQlikViewManagementConsole(QMC).
QlikTech International
150 N. Radnor Chester Road
Suite E220
Radnor, PA 19087
USA
Phone: +1 (888)-828-9768
Fax: 610-975-5987
Forotherlocations,visittheQlikTechhomepage(seeabove).
1.3 Conventions
Style Coding
Menucommandsanddialogoptionsarewrittenin bold.Filenames,paths,andsamplecodearewrittenin
Courier.
QlikView Server/Publisher 9
1 Overview
Environment Variables
Thepathsdescribedinthisdocumentuseenvironmentvariables.Thevariablesandtheequivalentpathsin
WindowsVista,Windows7,andWindowsXParepresentedbelow.
Environment Windows Vista/
Windows XP
Variable Windows 7
%ProgramData% C:\ProgramData C:\Documents and Settings\All
Users\Application Data
10 QlikView Server/Publisher
2 Whats New in QlikView 11 Server?
LDAPs
ConfigurableLDAPDSPforLDAPs(LDAPviaSSL)supporthasbeenadded.
License Tracking
TheuseoflicenseshasbeenaddedtotheQlikViewEventServerlogs.Thefollowingeventsarenowlogged
(whenusinglowverbositylogging):
l PGO,Recreating[filename]frombackup
l PGO,Recreatingcorruptfile[filename]
QlikView Server/Publisher 11
2 Whats New in QlikView 11 Server?
l PGO,Creatingfile[filename]
l License,Licenseleasedtouser[username]onmachine[machinename]
l CALusage,UsingCALoftype[CALtype]foruser[username]onmachine[machinename].
Sessionsonthiscaltype:X
l CALusage,ReleasingsessionCALforuser[username]onmachine[machinename]
l CALusage,UsageCALsessionforuser[username]onmachine[machinename]stopped
l CALusage,NamedUserCALsessionforuser[username]onmachine[machinename]stopped
l CALusage,DocumentCALsessionforuser[username]onmachine[machinename]stopped
l CALallocation,Unused(Document)NamedUserCAL[username]deletedok
l CALallocation,(Document)NamedUserCAL(notusedfor24hours)[username]deletedok
l CALallocation,Unused(Document)NamedUserCAL[username]markedfordeletionok
l CALallocation,(Document)NamedUserCAL[username]addedok
l CALallocation,NamedUserCAL(notusedfor24hours)[username]deletedok
l CALdeallocation,(Document)NamedUserCAL[username]nolongermarkedfordeletionok
l CALdeallocation,(Document)NamedUserCAL[username]notmarkedfordeletiondenied
l CALdeallocation,(Document)NamedUserCAL[username]notfounddenied
Reloads
PriortoQlikView11Server,areloadisperformedinthefollowingwaywithPublisher:
1. Theentiredocument(.qvw)isloadedtomemoryfromdisk.
2. Areloadiscompleted.
InQlikView11Server,areloadisperformedinthefollowingway:
1. Thedocument(.qvw)withoutthedataisloadedtomemoryfromdisk.
2. Areloadiscompleted.
Theperformanceenhancementisthereductionintimetoloadthedocumenttomemoryfromdisk,since
thereisnodata.QlikView11Publishercanopensourcedocumentswithoutdatapriortoexecutingareload
task.Thereisnoneedtoloadthedocumentdatatomemoryandthenperformareloadofthedocument.
12 QlikView Server/Publisher
2 Whats New in QlikView 11 Server?
l Allofataskchaincanbeexpandedbyright-clicking.
l Ausercanberemovedfromalldistributionswheretheuserisexplicitlytargeted.
l SearchandfiltershavebeenaddedtoSourceDocuments,UserDocuments,andTasks.
l AlertswithinQMChavebeenaddedforservicestatus.
l Clusteringandusertypeshavebeenmademoreconsistentamongtheservices.
Improved Logging
ChangestothesettingsinQlikViewServerandQlikViewWebServerarestoredintheauditlog.
ThelogginganderrorhandlinghavebeenimprovedforQlikViewDistributionService.
AccessPoint Remake
AccessPointhasbeengivenanewlookandfeel:
l Newsearchcapabilitieshavebeenadded.
l Thedocumentattributeshavebeenleveragedtoimprovethecategorizationofdocuments.
l Documentdescriptionscanbeadded.
l GlobalmessagescanbeshownontheAccessPointbyaddingmessagesinQMC.
EDX Enhancements
StartinganEDXreturnsasessionIDtoallowinterrogationofthestatusofthesessionratherthanonthe
task.Whenthesessionisdone,thestatuscontainsalistofallthetasks(andsessionIDs)thathavebeen
triggered,allowingforcontinuoustrackingofthestatus.ThisfunctionalityisavailablethroughtheAPI.
Retries
Ifataskthatcontainsaloopfails,itrestartsfromthepointoffailure,ratherthanfromthebeginningofthe
loop.
QlikView Server/Publisher 13
14 QlikView Server/Publisher
3 System Requirements
3 System Requirements
TosuccessfullyinstallandrunQlikViewServer/Publisher,therequirementslistedinthischaptermustbe
fulfilledbythetargetsystem.
*Recommendedfordevelopmentandtestingpurposesonly.
**QlikViewisanin-memoryanalysistechnology;memoryrequirementsforQlikViewproductsaredirectly
relatedtothequantityofdatabeinganalyzed.
***Third-partysecurityrequiresQlikViewEnterpriseEditionServer(see Editions of QlikView Server (page
85)).
QlikView Server/Publisher 15
3 System Requirements
16 QlikView Server/Publisher
Part 2 Installation
Part2Installation
QlikView Server/Publisher 17
18 QlikView Server/Publisher
4 Upgrading QlikView
4 Upgrading QlikView
4.1 Upgrade Considerations
Migrating from 32-bit (x86) to 64-bit (x64) Version
Whenmigratingfrom32-bit(x86)to64-bit(x64)orfrom64-bit(x64)to32-bit(x86),therunningversion
mustbemanuallyremovedpriortoinstallingthenewversion.
QlikView Server/Publisher 19
4 Upgrading QlikView
ToinstallQlikViewServer,proceedasfollows:
1. VerifythatbackupmediaexistsforthecurrentreleaseofQlikViewServerandbackupallcurrent
filesassociatedwithQlikViewServer(HTMLpages,QlikViewdocuments,licensingfile,QlikView
Server .sharedfiles,andsoon).
2. WhenrunningQlikViewServerversion8,usethe UserstabinQMCtodetermineifthereareany
activeuserslinkedtoQlikViewServer.Itmaybeagoodideatosendoutabroadcastmessageto
notifytheusersthattheservicewillbestopped.
3. UninstallQlikViewServerfrom Start Menu>Control Panel.
4. InstallQlikView11Server.
Note!WhenupgradingfromapreviousversionandusingMicrosoftIIS,thevirtualfoldersinIISmustbe
updated(seethetablebelow).
Microsoft IIS
Update Required
Virtual Folder
QVAJAXZfc Updateto %ProgramFiles%\QlikView\Server\QlikViewClients\
QlikViewAjax.
QvAnalyzer Removed
QvJava Removed
QvPrint Removed
Simple Upgrade
Thisprocedurerequiresnospecialplanningandinvolvesthesmallestrisk,butcausesthesystemtobedown
forsometime.
Proceedasfollowstoperformastraight-forwardupgrade:
1. Performabackupasdescribedin Upgrade Procedure (page 19).
2. Stopallservicesrunningonallmachines.
3. Upgradetheservicesoneachmachine(inanyorder).
4. Startallservicesonallmachines.
Maximize Uptime
Thisprocedurerequiresmoreplanning,butthesystemuptime(fromanenduserpointofview)ismaximized.
Proceedasfollowstoperformtheupgrade:
1. Performabackupasdescribedin Upgrade Procedure (page 19).
2. StopQMS(whichmeansQMCbecomesunavailable).
3. Upgradeinthefollowingorder(lettheinstallerrestarttheservices):
a)Webservers
b)DirectoryServiceConnector(DSC)
c)QlikViewServer(QVS)
20 QlikView Server/Publisher
4 Upgrading QlikView
d)QlikViewDistributionService(QDS)
e)QMS
4. StartQMS(whichmeansQMCbecomesavailableagain).
QlikView Server/Publisher 21
22 QlikView Server/Publisher
5 Installing QlikView Server
Fullinstallation,single UsedtorunallcomponentsonasinglemachinewithMicrosoftIISasweb
machinewithMicrosoft server.
IIS InstallsQlikViewServer(andexamples),QlikViewDistributionService,
DirectoryServiceConnector,QlikViewManagementService,andQlikView
SettingsService.
Note!ThisprofileisonlyavailablewhenMicrosoftIISisinstalledonthemachine.
QlikView Server/Publisher 23
5 Installing QlikView Server
Profile Description
QlikViewServer InstallsQlikViewServer,DirectoryServiceConnector,andtheQlikView
Serverexampledocuments.
Reload/Distribution InstallstheReloadEngineandtheQlikViewDistributionService.
Engine
ManagementConsole InstallstheQlikViewManagementServicetogetherwiththeQlikView
ManagementConsole(QMC).
WebServer InstallstheQlikViewWebServer.
Note!Runningreal-timeanti-virusprotectionontheserverdegradestheperformanceofQlikViewServer.It
isrecommendedthattheuserdocuments,sourcedocuments,logdirectories,and .pgofilesareexcluded
fromtheanti-virusscanning.
24 QlikView Server/Publisher
5 Installing QlikView Server
Note!TooptimizetheperformancewhenrunningMicrosoftIISandAJAX,turnoncompressionintheweb
server.
ForinformationonhowtoconfigureIIS6,see
http://technet.microsoft.com/en-us/library/cc730629%28WS.10%29.aspx.
ForinformationonhowtoconfigureIIS7,see
http://technet.microsoft.com/en-us/library/cc782942%28WS.10%29.aspx.
Licensing
ThelicensingisusedtoauthenticateQlikViewServerandallowittorunonaspecificmachine.
Goto System>LicensesinQMC,selectaQlikViewServerorPublisher,andfillinthe Serial numberand
Controlfieldsonthe QlikView Server Licenseor QlikView Publisher Licensetab(dependingonwhether
QlikViewServerorPublisherwaschosen).
QlikView Server/Publisher 25
26 QlikView Server/Publisher
6 Building a Farm
6 Building a Farm
Serverfarmscanbeusedtoprovideadditionalperformance,redundancy,andsecurityinplaceofasingle
serversolution.
6.1 Planning
Beforestartingtheactualinstallation,planningisneeded.Thefollowingitemshavetobeconsidered:
l Trustmechanism
l Webserver(QlikViewWebServerorMicrosoftIIS)
l Redundancylevel
l Accounttoruntheservicesunder
l QVPRformat(XMLorSQL)
l Userdirectory
l Userauthentication
l Firewalls
Trust Mechanism
TrustmechanismsareprovidedwithWindowsgroupsorcertificates.
Windowsgroupscaneasilybedeployed,ifallservicesresideinasingleActiveDirectory(AD).Ifencrypted
communicationisneeded,itcanbeaddedmanually.
Certificatesprovidefortrustmechanismsincross-domainenvironmentsandcanalsoprovideSSLencryption.
Web Server
QlikViewWebServerisintendedforusewhenthewebserverisnotneededforotherpurposes.Itis
lightweightandeasytomanage,butatthesametimelimitedtosupportthetasksneededbyaQlikView
installation.
AMicrosoftIIS-hostedwebserverisrecommended,if:
l Moreflexibilityormoreadvancedtuningisrequired
l ThewebserveristobeusedforothertasksthanQlikView
l Anauthorizationschemenotavailableout-of-the-boxisrequired
Redundancy Level
Theredundancylevelismainlyaquestionofclusteringand/orhavingmultiplemachinesrunningthesame
service.AllservicesexceptQlikViewManagementService(QMS)canbeinstalledonmultiplemachines.In
addition,QlikViewServer(QVS),QlikViewDistributionService(QDS),andDirectoryServiceConnector
(DSC)canbeclustered.
QVPR Format
ThechoiceofQVPRformatisbasedonreasonsoutsidetheQlikViewproduct(forexample,backupand
availability).TheinstallationalwaysstartsinXMLmode.
QlikView Server/Publisher 27
6 Building a Farm
User Directory
QlikViewdefaultstoWindowsusers(thatis,NTFSmode).Ifnon-Windowsusersaretobegivenaccess
(otherthananonymously),QlikViewServermustruninDocumentMetadataService(DMS)mode.
DMSmodemayalsobepreferableforotherreasons,see Document Level Authorization (page 77).
User Authentication
QlikViewsupportsmultipleauthenticationschemes.AdditionalschemesmayrequireASPXdevelopment
andthepossibleuseofMicrosoftIISforwebservices.
Forinformationontheavailableauthenticationschemes,see Authentication (page 71).
Firewalls
Makesurethattheservicesareabletocommunicate(forexample,byopeningtheappropriateportsinthe
firewalls).Forinformationontheports,see Service by Service (page 51).
6.4 Clustering
Note!Do notmixarchitecturesthatis,32-bit(x86)and64-bit(x64)withinacluster.
QlikView Server
FortheQlikViewServerclustertoworkproperly,itisimportanttoset System>Setup>QVS
resource>Folders>Root Foldertoacommonsharedfolder.Inaddition, Alternate Temporary Files Folder
Pathmustbesettoacommonsharedfolder(separatefromtherootfolder).
Ifextensionsareused,itsimplifiesmanagementif Alternate Extension Pathissettoacommonshared
folder.
Itisalsocommonpracticetoset System>Setup>QVS resource>Logging>Log Foldertoacommonplace,
butthisisnotstrictlynecessary.
Note!Therootfoldermust notbeusedforanythingelsethanclusterfiles(thatis, .pgofiles)anduser
documents.
28 QlikView Server/Publisher
6 Building a Farm
QlikView Server/Publisher 29
30 QlikView Server/Publisher
Part 3 Architecture
Part3Architecture
QlikView Server/Publisher 31
32 QlikView Server/Publisher
7 Roles
7 Roles
TheoverallarchitectureofaQlikViewinstallationreflectstheseparationofroles.
QlikView deployment with Publisher containing the location of the QlikView components
Front End
Thefrontendiswhereendusersinteractwiththedocumentsanddatathattheyareauthorizedtoseevia
QlikViewServer.ThefrontendcontainstheQlikViewuserdocumentsthattypicallyhavebeencreatedvia
QlikViewPublisheratthebackend.Allcommunicationbetweentheclientandservertakesplacehereand
QlikViewServerisfullyresponsiblefortheclientauthorization.
Thefrontendreliesoninfrastructureresources(forexample,Windows-basedFileShareforclustering).
Note!QlikViewServercurrentlyonlyconformswithWindowsFileShareoraWindows-basedNAS.This
meansthatstoragemustbeowned,governed,andsharedbyaWindowsoperatingsysteminstance(typically
accessedusingapathlike \\<servername>\<share>).
Authenticationofendusersis(withexceptionofthebuilt-inCustomUsers)handledoutsideQlikView.
QlikView Server/Publisher 33
7 Roles
Back End
ThebackendiswheretheQlikViewsourcedocuments,createdusingQlikViewDeveloper,reside.These
sourcefilescontainscriptstoextractdatafromvariousdatasources(forexample,datawarehouses,Microsoft
Excelfiles,SAP,andSalesforce.com).Thisextractionsometimesinvolvesintermediatefiles(QVD
files).ThemainQlikViewcomponentthatperformstheloadinganddistributionatthebackendisthe
DistributionService.Withinthebackend,theWindowsfilesystemisalwaysinchargeofauthorization(that
is,QlikViewisnotresponsibleforanyaccessprivileges).
Thebackendusestheinfrastructureresourcesforclustering(forexample,Windows-basedFileShare)and
mayalsouseresourceslikeSMTPserversanddirectorycatalogs.
Note!QlikViewServercurrentlyonlyconformswithWindowsFileShareoraWindows-basedNAS.This
meansthatstoragemustbeowned,governed,andsharedbyaWindowsoperatingsysteminstance(typically
accessedusingapathlike \\<servername>\<share>).
Asdepictedhere,boththebackendandfrontendaresuitablefordevelopment,testing,anddeployment.
34 QlikView Server/Publisher
7 Roles
Client Runsinawebbrowseroranapplicationshellthatprovidesacontainerfortheclientcode.The
clientcommunicateswithQVSeitherdirectlyorthroughthewebservertoprovidethe
QlikViewinterfaceandfunctionalitytotheenduser.
Web Runsanhttpserver,whichcanbeusedtoservehtmlwebpagestotheclient,assistswith
server authenticationoftheuser,andenablescommunicationbetweentheclientandQVS.
WiththeexceptionofCustomUsers,theauthenticationofclientusersisdoneoutsideQlikViewusing,for
example,Windowsauthentication.See QlikView Server Authentication Using Custom Users (page 74)for
informationonauthenticationofCustomUsers.
TheprotocolsdefinedforclientcommunicationwithQVSarelistedbelow.
QlikView Server/Publisher 35
7 Roles
Protocol Description
QlikViewProtocol Encrypted,binary,andTCP-based;communicatesdirectlywithQVSonport
(QVP) 4747.
QVPX XML-based;communicateswiththeQVSusinghttp/httpsthroughaweb
server.
Windowsclients(.exe/.ocx)communicatedirectlywithQVSusingQVPonport4747.Theseclientsdo
notrequireawebservertoestablishandmaintainaconnectionwithQVS.
TheAJAXclientandmobileclientsdonotcommunicatedirectlywithQVS.Theyestablishandmaintaina
connectionusingtheQVPXprotocolthroughawebserver,QlikViewWebServer(QVWS)orMicrosoftIIS.
Thisisnormallyaccomplishedusingport80(http).
ThedefaultinstallationsettingsforQVSuseQVWS,notIIS.QVWSsharesport80withIISonWindows
Vista,Windows2003Server,andWindows2008Server.OnWindowsXP,onlyoneofthetwowebservers
canuseport80.Ifbothareconfiguredtorun,theymustbeassigneddifferentports.
36 QlikView Server/Publisher
7 Roles
QlikView Server/Publisher 37
7 Roles
Management Service
TheQlikViewManagementService(QMS)keepssettingsinadatabaseofitsown,theQVPR.TheQVPRis
bydefaultstoredasXMLfilesanalternativeisstoringthesettingsinanSQLdatabase.Aninstallation
canonlyhaveasingleinstanceofQMSactive.Active/passivefailovershouldbeusedforredundancy.Note
thatnootherserviceneedsQMStoberunning.
38 QlikView Server/Publisher
7 Roles
Distribution Service
TheDistributionServiceworkswiththesourcedocumentstoproduce:
l Userdocuments
l .qvwfilesfordistributiontoafolderorviae-mail
l .pdfdocumentsfordistributiontoafolderorviae-mail
Thechainofeventsuptothefinaldistributioninvolvesoneormanyofthefollowingtasks:
1. Dataisloadedfromoneormoredatasources(includingQVD)intooneormore .qvwor .qvdfiles.
2. Adocumentisreducedintooneormoresmallerdocuments.
3. Attributesandusagerulesareadded(applicableonlywhendistributedtoaQVS).
TheDistributionServiceperformsthetasksaccordingtodefinedschedulesand/orasresponsestoevents.
QlikView Server/Publisher 39
40 QlikView Server/Publisher
8 Logging
8 Logging
AllalertsfromtheQlikViewservicesappearintheWindowseventlog.
ExeVersion FullversionnumberofQVS.
Example:11.00.11076.0409.10
Timestamp Dateandtimewhenthelogentrywascreated.
Document QlikViewdocumentthatwasaccessed.
Document Filetimestampofthedocumentthatwasaccessed.
Timestamp
QlikViewUser QlikViewsectionaccessuserID(ifused).
ExitReason Reasonforsessiontermination:
l Socketclosed=Client-inducedtermination
l LRU=TerminatedasLeastRecentlyUsedinfavorofnewuser
l Shutdown=Server-inducedterminationforotherreasons
Note!Thisisnotacompletelist,astheexitvalueinsomecasescomesfromtheoperating
system.
SessionStart Timewhenthesessionwasstarted.
SessionDuration Durationofsessioninhours:minutes:seconds.
QlikView Server/Publisher 41
8 Logging
Field Description
CPUSpent(s) CPUsecondsspentbythesession.
BytesReceived Bytesreceivedbytheserverduringthesession.
BytesSent Bytessentbytheserverduringthesession.
Calls NumberofQlikViewcallsduringthesession(bidirectional).
Selections NumberofQlikViewselectionsmadeduringthesession.
AuthenticatedUser AuthenticatedWindowsNTuserID(ifany).
IdentifyingUser Clientuseridentification.
ClientMachine Clientmachineidentification.
Identification
SerialNumber SerialnumberoftheQlikViewclient(installedclientsonly,thatis,QlikView
DesktopandInternetExplorerplugin).
ClientType Clienttypeused:
l WindowsExe=QlikViewDesktopandInternetExplorerplugin
l Ajax=allclientsthatusetheQVPXprotocol
l Unknown
SecureProtocol Secureprotocolused:
l Onwhenencryptedcommunicationisused(typicallyWindowsclients).
l Offwhennon-encryptedcommunicationisused.
TunnelProtocol TunnelwhenQVStunnelcommunicationisused.
ServerPort Portusedbytheserver.
ClientAddress ClientIPnumber.
ClientPort Clientport.
CALType ClientAccessLicense(CAL)type:
l User=NamedUserCAL
l Session=SessionCAL
l Usage=UsageCAL
l Document=DocumentCAL
CALUsageCount NumberofUsageCALs.
42 QlikView Server/Publisher
8 Logging
Eachentryofthelogcontainsthefieldslistedbelow.
Field Description
ExeType TypeofQVSbuild.
Example:RLS32=32-bitreleasebuild
ExeVersion FullversionnumberofQVS.
Example:11.00.11076.0409.10
Timestamp Dateandtimewhenthelogentrywascreated.
EntryType Entrytype:
l Serverstarting=Startup
l Normal=Normalintervallogentry
l Servershuttingdown=Shutdown
ActiveDocSessions Numberofdocumentsessions*thathasshownactivityduringtheinterval
andstillexistsattheendoftheinterval.
DocSessions Totalnumberofdocumentsessions*thatexistsattheendoftheinterval.
ActiveAnonymousDocSessions Numberofdocumentsessions*withanonymoususerthathasshown
activityduringtheintervalandstillexistsattheendoftheinterval.
AnonymousDocSessions Totalnumberofdocumentsessions*withanonymoususerthatexistsat
theendoftheinterval.
ActiveTunneledDocSessions Numberofdocumentsessions*withtunneledconnectionthathasshown
activityduringtheintervalandstillexistsattheendoftheinterval.
TunneledDocSessions Totalnumberofdocumentsessions*withtunneledconnectionthatexists
attheendoftheinterval.
DocSessionStarts Numberofdocumentsessions*thathasbeeninitiatedduringtheinterval.
ActiveDocs Numberofdocumentsloadedattheendoftheintervalinwhichtherehas
beenuseractivityduringtheinterval.
RefDocs Numberofdocumentsloadedattheendoftheintervalforwhichthereis
asessionattheendoftheinterval.
LoadedDocs Totalnumberofdocumentsloadedattheendoftheinterval.
DocLoads Numberofnewdocumentsloadedduringtheinterval.
DocLoadFails Numberofdocumentsthathasfailedtoloadduringtheinterval.
Calls TotalnumberofcallstoQVSduringtheinterval.
Selections Numberofselectioncallsduringtheinterval.
QlikView Server/Publisher 43
8 Logging
Field Description
ActiveIpAddrs NumberofdistinctIPaddressesthathasbeenactiveduringtheinterval
andstillexistsattheendoftheinterval.
Note!TunneledsessionsandmultipleusersoriginatingfromthesameIPcannotbe
distinguished.
IpAddrs TotalnumberofdistinctIPaddressesconnectedattheendoftheinterval.
Note!TunneledsessionsandmultipleusersoriginatingfromthesameIPcannotbe
distinguished.
ActiveUsers NumberofdistinctNTusersthathasbeenactiveduringtheintervaland
stillexistsattheendoftheinterval.
Note!Anonymoususerscannotbedistinguished.
Users TotalnumberofdistinctNTusersconnectedattheendoftheinterval.
Note!Anonymoususerscannotbedistinguished.
CPULoad AverageCPUloadfromQVSduringtheinterval.
VMAllocated(MB) SizeinMBofthevirtualmemoryallocatedbyQVSattheendofthe
interval**.
VMCommitted(MB) SizeinMBofthevirtualmemoryactuallyusedbyQVSattheendofthe
interval.ThisnumberispartofVMAllocated(MB)andshouldnotexceed
thesizeofthephysicalmemoryinordertoavoidunacceptableresponse
times.
VMFree(MB) SizeinMBoftheunallocatedvirtualmemoryavailabletoQVS**.
VMLargestFreeBlock(MB) SizeinMBofthelargestcontiguousblockofunallocatedvirtualmemory
availabletoQVS.ThisnumberispartofVMFree(MB).
UsageCalBalance -1.00=TherearenoUsageCALs.
*Oneuser+onedocument=Onedocumentsession.
**VMAllocated(MB)+VMFree(MB)=TotalmaximumvirtualmemoryspaceavailabletotheQVSprocess.
44 QlikView Server/Publisher
8 Logging
Eachentryofthelogcontainsthefieldslistedbelow.
Field Description
Timestamp Dateandtimewhenthelogentrywascreated.
SeverityID IDfortheseveritylevel:
1=Error
2=Warning
4=Informationornotice
EventID UniqueIDfortheeventtype.
Severity Eventseveritylevel:
l Error
l Information
l Warning
Message Eventdescription.
Field Description
Server DateandtimewhenQVSwasstarted.
started
Timestamp Dateandtimewhenthelogentrywascreated.
Document Pathandnameofthedocumentthatwasaccessed.
Type Typeofselectionmade(forexample,SelectionandBookmark).
User Username.
Message Informationonthetypeofselectionorapplicationofbookmarkthatwasmadeinthe
document.
Example:ApplyServer\BM15.
QlikView Server/Publisher 45
8 Logging
Theentriesfoundinthelogsarelistedbelow.
Entry Description
TransactionID TransactionID,whichisusefulforkeepingtrackofchangesmadesimultaneously.
ModifiedTime Timeanddate(inUTC)whenthechangesweremade.
ID IDoftherow(thatwasupdatedordeleted)inthetablethatwaschanged.
Thefollowingexamplecomesfromthe AlertEmailtable.Theloghasbeenputinatableforbetter
overview.
TransactionID 455a241d-8428-4dc7-ba67-4ae7cb21cf3d
ChangeType Update
ModifiedTime 2010-02-0215:12:54
ModifiedByUser MyDomain\mjn
ID b3745325-cee7-4fe7-b681-9c9efe22fc5c
DistributionServiceID 8846d7dd-bb3f-4289-9c9b-b0ca71b7c3b2
EmailAddress mjn
TransactionID 455a241d-8428-4dc7-ba67-4ae7cb21cf3d
ChangeType Update
ModifiedTime 2010-02-0215:12:54
ModifiedByUser MyDomain\mjn
ID a37f242c-6d80-42da-a10c-1742d2ec927f
DistributionServiceID 8846d7dd-bb3f-4289-9c9b-b0ca71b7c3b2
QDSWebAdress http://computer-mjn:4720/qtxs.asmx
CurrentWorkorderID 96bff2dc-f1ea-84d2-b6c4-ea58bf5c98e5
46 QlikView Server/Publisher
9 Documents, Data, and Tasks
Shared Files
TherearemultipleobjectsavailableforusercollaborationandsharingthroughQlikViewServer:
l Bookmarks
l Sheetobjects,includingcharts
l Reports
l Annotations
Eachoftheseobjectsmaybedefinedasauserobject,availabletoauthenticatedusers,regardlessofaccess
methodorlocation,orasharedobject,availabletoallusersofthedocumentthroughQVS.
TheobjectsareconfiguredandmanagedusingQlikViewManagementConsole(QMC).
OnceQVSisenabledforserverobjects,anyoftheQVSobjectsettingsarechecked,andthedocumentis
openedinQVS,aspecialdatabasefileiscreatedandmaintainedinthesamelocationastheQlikView
document.ThefilehasthesamenameastheQlikViewdocument,buta .Sharedfileextension.
Example:
l QlikViewdocument: Presidents.qvw
l QVSsharefile: Presidents.qvw.Shared
IfthenameoftheQlikViewdocumentischanged,the .Sharedfilehastobemanuallyrenamedtomatch
beforeopeningtherenamedQlikViewdocumentinQVS.Thispreservesthesharedobjectsattachedtothe
document.
WhenupdatingaServerobject,report,bookmark,orinputfielddata,thefileisexclusivelylocked.Making
aselectionorsimplyactivatingtheobjectdoesnotlockthefileandanynumberofserverscanreadthefile
atthesametime.Apartiallockisimplementedsothatdifferentsectionsofthefilemaybeupdated
simultaneouslybydifferentserversinacluster.
Thefileisreadoncewhentheserveropensthedocument,butitisnotreadagainunlesstherearechanges.
Allsessionssharethesameinternalcopyofthe .Sharedfile(thatis,openingasessiongenerallydoesnot
requirethefiletobereadfromdisk).
Theserverobjectscanbemanaged(forexample,changeofownershipordelete)onthe Documents>User
Documents>Server>Server ObjectstabinQMC.
QlikView Server/Publisher 47
9 Documents, Data, and Tasks
9.4 Tasks
Taskscanbeusedtoperformawidevarietyofoperationsandbechainedtogetherinanyarbitrarypattern.
Thestartingpointwhendescribingtasksisthetransformationofasourcedocumentintoauserdocument.
Source
Ataskisalwaystiedtoasourcedocument,sothesourceisgiven.
Layout
Thesourcedocumentcontainsthelayout,whichiscopiedunchangedallthewaytotheuserdocuments.
Theserversidelayoutisassociatedwiththeuserdocumentandisalsounchanged.
Reload
Thedatacanbe:
l Usedasstoredinthedocument(thatis,noreload)
l Partlyreloadedfromthesource(thatis,requirescriptpreparation)
l Fullyreloadedfromthesource,discardinganyolddata
l ReloadedinpartsbyuseofScriptParameters(whichrequirescriptpreparation)
Reduce
Thedocumentcanbereducedafterreload.Thereductioncaneitherreducetheinputintoasmallerdocument
(simplereduce)orsplititupintoseveralsmallerdocuments(loopandreduce).
Thereductionisbasedonaselection,eitherdonedirectlyinQMCorusingbookmarks.
Distribution
DistributionrequiresaQlikViewPublisherlicense.
48 QlikView Server/Publisher
9 Documents, Data, and Tasks
Thedestinationisdefinedas:
l AlistofusersandafolderonaQlikViewServer
l Alistofusersandafolderinthefilesystem
l Alistofusers(assumingtheire-mailaddressesareknown)
Note!Loopanddistributemustbeused,ifdifferentcontentistobedistributedtodifferentusers.Ifnot,
thesamedocument(ordocuments)isdistributedtoall.
Information
Informationcanbeassociatedwiththedocumentaspartofthedistributiontoaserver.Theinformationis
notmovedwiththedocument,ifitisdistributedtoanotherlocation.TheinformationisusedinQlikView
AccessPoint.
Thefollowinginformationcanbeassociatedwiththedocument:
l Description
l Category
l Arbitrarynamevaluepairs
Server Settings
Thesettingsforthedocumentaredistributedtoaserver.Thesettingsarenotmovedwiththedocument,ifit
isdistributedtoanotherlocation.ThesettingsareenforcedbyQlikViewServer.
Authorizationenforcedbytheserver(equaltoallservers):
l Theusersauthorizedtocreateserverobjects
l Theusersauthorizedtodownloadthedocument
l TheusersauthorizedtoprintandexportthedocumenttoMicrosoftExcel
PreferencesappliedbyQlikViewAccessPoint(equaltoallservers):
l InternetExplorerpluginisrecommended
l Mobileclientisrecommended
l AJAXclientisrecommended
Performanceenforcedbytheserver(equaltoallservers):
l Auditlogging
l Maximumopensessions
l Documenttimeout
l Sessiontimeout
Availability(perserver):
l Never
l On-demand
l Pre-loaded
QlikView Server/Publisher 49
50 QlikView Server/Publisher
10 Service by Service
10 Service by Service
ThischapterdescribestheQlikViewServer/Publishercomponentsindetail.
Data %ProgramData%\QlikTech\QlikViewServer
Listens to QVP:4747;QVP(tunneling):4774;Broadcast:14747;SNMP:161
Uses/Controls -
Used by QDS,QMS,QVWS,QlikViewDesktop/InternetExplorerplugin/OCX
Files
Settings and Configuration
File Description
Settings.ini StorestheQlikViewServer(QVS)settings.Manualchangesinthisfilerequirerestart
ofQVS.ThisfileisalwaysstoredintheDatafolder(see Overview (page 51)).
Cluster
QVSuses .pgofilestocoordinateacluster.ThefilesarestoredintheDatafolder(see Overview (page
51)).
File Description
BorrowedCalData.pgo KeepstrackofborrowedClientAccessLicenses(CALs).
CalData.pgo KeepstrackofCALs.
ServerCounters.pgo Keepstrackofstatistics.
TicketData.pgo Keepstrackoftickets.
Logs
Thelogsarekeptonepernodeinthecluster.ThelogfilesarestoredintheDatafolderbydefault(see
Overview (page 51)forthedefaultpath).
File Description
Events_<computer_name>.log Eventlog.
QlikView Server/Publisher 51
10 Service by Service
File Description
Performance_<computer_name>.log Performancelog.
Sessions_<computer_name>.log Sessionlog.
Special Folders
ThespecialfoldersarestoredintheDatafolder(see Overview (page 51)forthepath).
Folder Description
Extensions Note!TheExtensionsfolderhastobecreatedmanually.
Bydefault,QVSlooksforextensionsinthisfolder.Extensionobjectsarelocated
in Extensions\Objectsanddocumentextensionsarelocatedin
Extensions\Document.U seQlikViewManagementConsole(QMC)to
manageallextensionsinoneplaceincaseofacluster.
Temp Bydefault,QVSputstemporaryfilesinthisfolder(forexample,whenexporting
usingtheAJAXclient,atemporaryfileiscreatedinthefolder).
52 QlikView Server/Publisher
10 Service by Service
QlikView Server/Publisher 53
10 Service by Service
Data %ProgramData%\QlikTech\DistributionService
Listens to HTTP:4720;SNMP:4721
Uses/Controls DSC,QVS,QVB
Used by QMS
Note!Afterrestartingthemachine,theWindowseventlogmaycontainamessagethattheQlikView
DistributionService(QDS)failedtostartinatimelymanner,eventhoughitstartedsuccessfully.Thisis
becausetheQDSinitializationphaseislongerthantheWindowstimeoutperiod(30secondsbydefault).
Toavoidtheeventlogmessage,eitherchangetheWindowstimeoutperiodorconfigureQDStodependon
anotherlatestartingservicetomakeQDSstartupduringalessbusyperiod.
Files
TheQlikViewDistributionService(QDS)filescanbedividedintothreegroupsbasedonmainpurpose.All
filesarestoredintheQDSDatafolder(see Overview (page 54)).Inaclusteredsetup,allQDSsmustshare
thesameprogramfolder.Thisissolvedbythefile config_<computer_name>.xml,whichcontainsthe
programdatapathtouse.
Tasks\Task_ Theactualtasks.Notethatdeletedtasksarenotautomaticallyremoved(due
<GUID>.xml tosupportissueanalysis).
Triggers\Triggers_ Theactualtriggers.Notethatdeletedtriggersarenotautomaticallyremoved
<GUID>.xml (duetosupportissueanalysis).
54 QlikView Server/Publisher
10 Service by Service
Cluster
File Description
LoadBalancer.xml UsedtoselectwhichQDS(inacluster)todothejob.
Logs
File Description
TaskResults\TaskResult_ LatestresultofthetaskidentifiedbytheGUID.
<GUID>.xml
TaskLogIndex\TaskLogIndex_ Thisisjustforlookup(onefilepertask),pointingtotheactual
<GUID>.xml log.
EdxResults\EdxResult_ Untilthetaskiscompleted,thisfilecontainsthecurrentstatus
<GUID>.xml oftheEDXtask.Whentheexecutionisfinished,itcontainsthe
result(success/fail)andthetaskstartedasaresult(ifany).
<node-nr>\Log\<Date>.txt GeneralQDSeventanderrorlog.
<node-nr>\Log\Cluster_ Synchronizationlog.
<Date>.txt
<node-nr>\Log\LoadBalancer_ Loadbalancinglog.
<Date>.txt
<node-nr>\Log\Root_ QDSeventlog.
<Date>.txt
<node-nr>\Log\WebService_ QDSeventlog.
<Date>.txt
<node-nr>\Log\Workorder_ QDSeventlog.
<Date>.txt
<node-nr>\Log\<date>\<time> QDStaskeventlog.
- <task name>\Tasklog.txt
<node-nr>\Log\<date>\<time> Thedistributionrelatedtothetask(onlyexistsfordistribution
- <task tasks).
name>\DistributionReport.xml
QlikView Server/Publisher 55
10 Service by Service
QlikView Batch
Overview
Data -
Listens to COM
Uses/Controls -
Used by QDS
Files
Settings and Configuration
File Description
Settings.ini Usedtostoresettings.
Logs
File Description
<document_name>.log Reloadlogthatisplacedtogetherwiththereloadeddocument.
Data %ProgramData%\QlikTech\ManagementService\QVPR
Listens to -
Uses/Controls -
Used by QMS
Files
Bydefault,QlikViewPublisherRepository(QVPR)isasetofXMLfiles.Thesefilesarebackedupas .zip
filesin %ProgramData%\QlikTech\ManagementService\QVPR\Backups.
Security Groups
WheninstallingQlikViewServer/Publisher,acoupleofsecuritygroupsarecreated.
TheQlikViewServer/Publisherservicesmustrununderanaccountthatismemberofthesecuritygroup
QlikViewAdministrators.UsersconnectingtoQMCmustbepartofthisgroup.Anyoneconnectingtoa
remoteservicemustalsobememberofQlikViewAdministrators.
TheusersconnectingthroughtheAPImustbemembersoftheQlikViewManagementAPIsecuritygroup.
Thegroupisnotcreatedduringtheinstallationandhastobeadded(andpopulated,forexample,withthe
56 QlikView Server/Publisher
10 Service by Service
membersoftheQlikViewAdministratorsgroup)manually.Amembershipinthisgroupisrequiredtoimport
tasksfromanotherQlikViewServer/Publisher.
TheQlikViewEDXsecuritygroupisnotcreatedduringtheinstallationandhastobeadded(and
populated)manuallyinorderforuserstorunEDXtasks.
Document Administrators
TodelegatetheresponsibilityofcreatingtaskstopeoplenotpartoftheQlikViewAdministratorsgroup,
userscanbeappointeddocumentadministrators.Thedocumentadministratorsareonlyallowedtoaccessthe
tabsinQMCthatarerelatedtoeitheruserdocumentsorsourcedocuments.
Note!TheuseofdocumentadministratorsrequiresaQlikViewPublisherlicense.
Formoreinformationonhowtoappointdocumentadministrators,seetheQMConlinehelp.
UseHTTPS True=Communicationrunsoverhttps.Acertificateforthewebsiteis
neededtoenablethissetting.
Trace Usedfordebuglogging.
QMSBackendWebServicePort Portthatthebackendmanagementservicelistensto.Thedefaultvalueis
4799.
QMSFrontendWebServicePort Portthatthefrontendmanagementservicelistensto.Thedefaultvalueis
4780.
MaxLogRecords Maximumnumberoflogrecordsthatshouldberetrievedforatask.
EnableAuditLogging True=Tracka)changesontasksandsettingsmadeinthesystem,b)who
madethechanges,andc)whenthechangesweremade.
AuditLogFolder Pathtothefolderwheretheauditlogsaresaved.
AuditLogKeepMaxDays Maximumnumberofdayseachlogissaved.
QlikView Server/Publisher 57
10 Service by Service
WebservicePort PortthattheQlikViewDistributionServiceusestocommunicate
with.Thedefaultvalueis4720.
UseHTTPS True=Communicationrunsoverhttps.
DSCAddress PortthattheDirectoryServiceConnectorserviceusesto
communicatewith.Thedefaultvalueis4730.Ifthevalueis
modified,thetagDSCAddressinthe
QVDirectoryServiceConnector.exe.configfilehastobe
modifiedtoo.
DSCTimeoutSeconds TimeoutforcallstotheDirectoryServiceConnector.
DSCCacheSeconds HowlongtheservicecachestheresponsesfromtheDirectory
ServiceConnector.
QlikViewEngineQuarantineTimeInms HowoftenaQlikViewengineisallowedtostart(inmilliseconds).
OpenDocumentAttempts Howmanytriesthatcanbemadetoopenadocumentbeforeitis
loggedasanerrorduringdistribution.
DebugLog True=EnableloggingofmemoryusageandstacktraceonError
logging.
Trace True=Enabledebuglogging.
EnableBatchMode EnablethissettingtomakebatchcallstotheQlikViewDistribution
Service(see QlikView Distribution Service (page 54)formore
information).
58 QlikView Server/Publisher
10 Service by Service
WebservicePort PortthattheDirectoryServiceConnectorserviceusestocommunicatewith.The
defaultvalueis4730.Ifthevalueismodified,thetagDSCAddressinthe
QVDistributionService.exe.configfilehastobemodifiedtoo.
UseHTTPS True=CommunicationrunsoverSSLinsteadofhttp.Acertificatefortheweb
siteisneededtoenablethissetting.
PluginPath PathwheretheDirectoryServiceConnectorlooksforavailableDSPplugins.The
defaultvalueis %ProgramFiles%\QlikView\Directory Service
Connector\DSPlugins.
Trace True=Enabledebuglogging.
DisableCompress Enablethissettingtodisablecompressionofthehttpcommunication.
Overview
QlikView Web Server
Data %ProgramData%\QlikTech\WebServer
Listens to HTTP:80;HTTP:4750;SNMP:4751
Uses/Controls DSC
Used by Webbrowserclientsandmobileclients
QlikView Server/Publisher 59
10 Service by Service
Data %ProgramData%\QlikTech\WebServer
Listens to HTTP:4750
Used by QMS
Files
Settings and Configuration
File Description
Config.xml Configurationfilefortheservice.
Logs
File Description
Log\<date>.txt Eventanderrorlog.
Load Balancing
QVWShostswebpages,preparesthefilelistforAccessPoint,andmanagestheloadbalancingofQlikView
Servers(QVSs).
AccessPointisawebportalfordocumentshostedonQVWS.ThepagesforAccessPointarebydefault
locatedinthefolder %ProgramFiles%\QlikView\Web.QVWSalsoactsaswebserverforanyAJAX
pagesaccessedbytheendusers.
TheloadbalancingperformedbyQVWSisdifferentfromloadbalancingawebserver,sincetheadditional
workandresourceconsumptionisalmostsimilarforeachuser,soitdoesnotmatteronwhichservertheuser
endsup.
Theloadbalancingschemesarelistedbelow.
Scheme Description
Random Thedefaultloadbalancingscheme.Theuserissenttoarandomserver,nomatterifthe
documenttheuserislookingforisloadedornot.
Loaded IfonlyoneQVShastheparticulardocumentloaded,theuserissenttothatQVS.Ifmore
Document thanoneQVSornoneoftheQVSshasthedocumentloaded,theuserissenttotheQVS
withthelargestamountoffreeRAM.
CPUwith TheuserissenttotheleastbusyQVS.
RAM
Overload
ThesettingsforloadbalancingareconfiguredinQMC.
60 QlikView Server/Publisher
10 Service by Service
QlikView AccessPoint
QlikViewAccessPointisawebportalthatliststhedocumentseachuserhasaccessto.AccessPointonly
linkstoeachdocumentitdoesnothostthedocuments.ThehostingisdonebyQlikViewServer.
Thedocumentscanbedisplayedasthumbnailsorinadetailedlist.
ThesettingsavailableinAccessPointarelistedbelow.
Setting Description
Category Categorygroupingforthedocument.CategoriesaremanagedinQMCunder
Documents>User Documents>Document Information.
QlikView Server/Publisher 61
10 Service by Service
Setting Description
Attribute Attributegroupingforthedocument.AttributesaremanagedinQMCunder
Documents>User Documents>Document Information.
NextUpdate Whenthedocumentwillbeupdatednexttime.
Note!Thisisonlydisplayedifthedocumentispartofataskthathasa
schema.
FileSize Sizeofthedocument.
AvailableClients Clickaclienttoopenthedocumentwiththatclient.
Removelastdocumentstate Clickthisbuttontoremovethelastdocumentstate.
ClickastariconnexttoadocumentnameintheThumbnailsorDetailedviewtosetthepreferencesforthe
document.
Setting Description
Openwith Selectaclienttomakeitthedefaultclienttoopenthedocumentwith.
Overview
Executable %ProgramFiles%\QlikView\Directory Service
Connector\QVDirectoryServiceConnector.exe
Data %ProgramData%\QlikTech\DirectoryServiceConnector
Listens to HTTP:4730;SNMP:4731
Uses/Controls -
Used by QDS,QMS,QVWS
62 QlikView Server/Publisher
10 Service by Service
Files
Settings and Configuration
ThesesettingsoriginatefromQVPR.
File Description
Config.xml Configurationfilefortheservice.
Resources/<id>.xml DSPconfigurations.
Logs
File Description
Log\<date>.txt Eventanderrorlog.
Data %ProgramData%\QlikTech\ManagementService
Listens to HTTP:4780(Web);HTTP:4799(API);SNMP:4781
Uses/Controls DSC,QDS,QVS,QVWS
Used by Webbrowser/APIclient
Files
Settings and Configuration
QlikViewManagementService(QMS)keepsaglobalviewofthesettingsinQVPR.
File Description
Config.xml Configurationfilefortheservice.
Logs
File Description
Log\<date>.txt Eventanderrorlog.
QlikView Server/Publisher 63
64 QlikView Server/Publisher
Part 4 Security
Part4Security
QlikView Server/Publisher 65
66 QlikView Server/Publisher
11 Security Overview
11 Security Overview
ThesecurityofQlikViewServer/Publisherconsistsofthefollowingparts:
l Protectionoftheplatform:Howtheplatformitselfisprotectedandhowitneedstocommunicateand
operate.
l Authentication:Whoistheuserandhowcantheuserproveit?QlikViewusesstandard
authenticationprotocols,suchasIntegratedWindowsAuthentication(IWA),HTTPheaders,and
ticketing,toauthenticateeveryuserrequestingaccesstodata.
l Documentlevelauthorization:Istheuserallowedtoaccessthedocumentornot?QlikViewuses
server-sidecapabilitiessuchasDocumentMetadataService(DMS)orWindowsNTFStodetermine
accessprivilegesatfilelevel.
l Datalevelauthorization:Istheuserallowedtoseeallofthedataorjustpartsofit?QlikView
implementsrowandfieldleveldatasecurity,usingacombinationofdocument-levelcapabilities
(SectionAccess)andserver-sidedatareductioncapabilities(QlikViewPublisher).
QlikView Server/Publisher 67
68 QlikView Server/Publisher
12 Protection of the Platform
QlikView Administrators
TheQlikViewAdministratorsgroupisusedforgrantingaccesstotheQlikViewManagementConsole
(QMC)aswellasauthorizationofcommunicationbetweenservices,ifWindowsAuthenticationisused.
12.3 Communication
Protection of AJAX Client
TheAJAXclientusesHTTPorHTTPSastheprotocolforcommunicationbetweentheclientbrowserand
theQlikViewWebServer(QVWS)orMicrosoftIIS.Thecommunicationbetweenthebrowserandtheweb
servercanbeprotectedusingSSL/TSLencryptionovertheHTTPprotocol(thatis,HTTPS).
ThecommunicationbetweenthewebserverandQVSusesQVPasdescribedbelow.
Protection of Plugin
TheQlikViewplugincancommunicatewithQVSintwoways.Ifthepluginhastheabilitytocommunicate
withQVSusingQVP(port4747),thesecuritydescribedin Server Communication (page 70)isapplied.
IfthecommunicationcannotuseQVPoriftheclientchoosesitintheplugin,thecommunicationis
tunneledusingHTTPtothewebserver.
IfHTTPSisenabledonthewebserver,thetunnelisencryptedusingSSL/TLS.
QlikView Server/Publisher 69
12 Protection of the Platform
Server Communication
TheQVScommunicationusestheQVPprotocol,whichisencryptedbydefault.TheQVPprotocolcanbe
protectedusing1024-bitRSAforkeyexchangeand128-bitRC4fordataencryption,providedtheMicrosoft
EnhancedCryptographicProviderisinstalled.IftheMicrosoftBaseCryptographicProviderisused,the
protectionofthecommunicationis512-bitRSAforkeyexchangeand40-bitRC4fordataencryption.
Services Communication
TheservicesthatarepartoftheQlikViewplatform(thatis,QVS,DSC,QMC,QDS,andQVWS)all
communicateusingwebservices.ThewebservicesauthenticateusingIntegratedWindowsAuthentication
(IWA).
70 QlikView Server/Publisher
13 Authentication
13 Authentication
AlthoughQlikViewcanbeconfiguredtoallowanonymousaccess,themajorityofimplementationsrequire
userstobeauthenticated.Insuchenvironments,QlikViewalwaysrequiresthattheuserisauthenticated
whenestablishingasessionviaQlikViewServer(eitherthroughabrowserorwhendownloadingand
openingadocumentviatheQlikViewDesktopclient).
IntheQlikViewcontext,theauthenticationofauserisalmostalwaysdoneagainstanexternalentitythatis
thenusedtopasstheexternallyauthenticateduseridentitytoQlikViewServer.Insuchascenario,
QlikViewreliesontheauthenticationtobeperformedpriortoaccessingQlikView,andthatsometokenof
identityistransmittedto,andtrustedby,QlikView.
QlikView Server/Publisher 71
13 Authentication
72 QlikView Server/Publisher
13 Authentication
SSOinfrastructure.Thismeanssinglesign-onisprovidedrightoutofthebox.TheSSOinfrastructure
softwarepackagescanbeconfiguredasfollows:
l Repeatusergetaccess:Thesoftwarepackagescanbeconfiguredtoprotectaresource.Whenauser
requestsaccesstoQlikView,theSSOpackagegrantsaccess,iftheuserhaspreviouslysignedinto
theSSOauthenticationpage.
l Newuserlogin:IftheuserdoesnothaveanexistingsessionwiththeSSOpackage,theuseris
redirectedtotheSSOpackageloginpage.Afterloggingin,theuserisredirectedtotheoriginalURL
thattheuserrequested.
Inbothcases,iftheuserhasproperlyauthenticatedtotheSSOsoftware,theusernameisinjectedintoan
HTTPheaderandthevalueinthatheaderiswhattheQlikViewserveracceptsastheauthenticatedidentity
oftheuser.
Note!UnlessSSOsoftwareisinplace,theHTTPheadermethodofauthenticatingtoaQlikViewServer
mustnotbeused.HTTPheaderscaneasilybespoofed.AlloftheSSOsoftwarepackagesmentionedabove
provideprotectionagainstthistypeofspoofingattacks,ifthesoftwarepackageistheonlypathforusersto
accessthecontent.
QlikViewdoesnotrecommendorendorseanyspecifictoolorproductforprovidingidentityinHTTP
headers.Theapproachishighlysuitedtoextranetdeploymentswhereintheusersmaynotexistinthe
internalActiveDirectory.TheactofauthenticationisperformedbythereverseproxyorISAPIfilterthat
interceptstheattemptoftheendusertointeractwithQlikViewcontent.
QlikView Server/Publisher 73
13 Authentication
74 QlikView Server/Publisher
13 Authentication
QlikView Server/Publisher 75
76 QlikView Server/Publisher
14 Authorization
14 Authorization
Onceauserhasbeenauthenticated(thatis,thesystemknowswhotheuseris),thefirststepinassigningthe
securityprivilegeshasbeencompleted.Thesecondstepistounderstandtheauthorityoraccessrightsthat
theuserhastoapplications,data,orboth.ThisstepisreferredtoasAuthorization.Atafundamentallevel,
anadministratorpopulatesanAccessControlList(ACL)withalistofusersand/orgroupsandwhattheyare
tohaveaccessto.Whenthetimecomesforausertorequestaccess,thesystemlooksuptheauthenticated
identityoftheuserintheACLandverifiesiftheadministratorhasgrantedtheuserenoughprivilegestodo
so.
DirectaccesstoaQlikViewdocumentusingQlikViewDesktopisalwaysgovernedbytheWindowsNTFS
filesecurity.Accesstotheweb-basedQlikViewManagementConsole(QMC)isrestrictedtoWindowsusers
thataremembersofaparticularlocalWindowsgroup.
QlikView Server/Publisher 77
14 Authorization
Therearetwotypesofdatalevelauthorizations:
l Dynamicdatareduction:Determinesiftheuserisallowedtoviewthedatawhentheusertriesto
accessit.
l Staticdatareduction:PerformedbyQlikViewPublisher,determinesiftheuserisallowedtoviewthe
datawhenitispreparedfortheuser.
Staticanddynamicreductionofdatacanbeusedonitsown,butcanalsobecombinedtodeliverdatalevel
authorization.
78 QlikView Server/Publisher
Part 5 Licensing
Part5Licensing
QlikView Server/Publisher 79
80 QlikView Server/Publisher
15 Client Access Licenses
Session ASessionCALallowsanyuser,identifiedoranonymous/unidentified,ononeQlikView
CAL clienttoaccessasmanyQlikViewdocumentsasmayresideontheserverorserverclusterto
whichtheSessionCALisassignedforaminimumperiodof15minutes.ForSessionCALs,
theQlikViewclientreferstoeachuniqueinstanceoftheQlikViewclient(forexample,the
AJAXclient,QlikViewDesktop,ortheInternetExplorerplugin)ontheusersmachine.The
minimumsessiontimeforaSessionCALis15minutes,whichmeansthatsessionsthatend
inlessthan15minuteswillstillconsumethesessionuntilthe15minutemarkispassed;
thosewhichterminateafter15minuteswillconsumetheiractualsessionlength.Bydefault,
thereisnomaximumsessionlength,butthiscanbeconfigured.
QlikView Server/Publisher 81
15 Client Access Licenses
15.2 Identification
TouseaNamedUserCALoraDocumentCAL,theclientusermustbeidentifiedviaanauthenticateduser
name(WindowsActiveDirectoryorthroughaticketexchangebetweenthewebserverandQlikView
Server).AnIPaddressisnotavalidformofidentificationforaNamedUserCAL.Thetwomethodsof
identificationcannotbemixedonthesameinstanceofQlikViewServer.Notethattheusername
identificationrequiresWindowsauthenticationonAJAXclients,sincemachinenameidentificationcannot
beusedfortheseclients.
AnyCALusedbyanidentifiedusermaynotbetransferredtoanotheruser,unlessthetransferisduetoa
changeintheemploymentstatusorworkdutiesoftheprioruser,inwhichcasethereisa24-hourquarantine
beforetheCALbetransferredtoanotheruser.
82 QlikView Server/Publisher
15 Client Access Licenses
4. IfanewDocumentCALcanbeassignedtotheconnectingclient,itisused.
5. IfthereisanavailableSessionCAL,itisused.
6. IfthereisanavailableUsageCAL,itisused.
7. Ifnoneoftheabove,accessisdenied.
QlikView Server/Publisher 83
84 QlikView Server/Publisher
16 Editions of QlikView Server
16.1 Editions
ThevariouseditionsofQlikViewServerarelistedbelow.
Edition Description
QlikView QlikViewEEServerisdesignedtobeusedinlargeandcomplexdeploymentsand
Enterprise providesfeaturessuchasunlimiteddocuments,server-basedcollaboration,integrationwith
Edition third-partysecuritysystems,serverclustering,andclusterlicensing.Theminimum
(EE)Server configurationofaQlikViewEEServeristenNamedUserClientAccessLicenses(CALs).
QlikView QlikViewSBEServerisdesignedtobeusedinsmallerdeployments.Theminimum
Small configurationofaQlikViewSBEServerisfiveNamedUserCALs.
Business
Edition
(SBE)
Server
QlikView QlikViewIASisaQlikViewServerthatislicensedforanuncappednumberofusers,but
Information limitedtoasingleQlikViewdocument.QlikViewIASrunsinanonymousmodeandmust
Access bepublicallyaccessiblewithoutauthentication(onthepublicInternet),thatis,itmustnot
Server beplacedbehindafirewall.N oQlikViewclientcanaccessQlikViewIAStheuser
(IAS) interfacemustbebuiltbytheendusereithermanuallyorbyusingQlikViewWorkBench.
Note!ThereisnolicenseleasefromQlikViewIAS.
QlikView QESallowsenduserstodeployQlikViewsolutionstotheirextranet.QESisbasedon
Extranet QlikViewEEServer,butonlysupportsuptothreeQlikViewdocuments.Theservercanbe
Server deployedwithacombinationofSessionandUsageCALs.QESsupportsmobileclientsand
(QES) canbedeployedinclusteredenvironments.TheAJAXclientoracustomizedAJAXclient
canbeusedviaQlikViewWorkBench,whichisincludedinQES.
InadditiontotheeditionsofQlikViewServerdescribedabove,thereisalsoanumberofadditional,server-
relatedproducts,allofwhicharelistedbelow.
Product Description
QlikView QlikViewTestServerisalicensethatprovidesanenvironmentseparatefromproduction
TestServer tousefordatavalidation,applicationtesting,andpreparation/migrationofQlikView
documentstonewversionsand/orreleasesofQlikView.
QlikViewTestServercomesintwoeditions,QlikViewEETestServerandQlikViewSBE
TestServer,bothofwhichhavethesamefeaturesandlimitationsasthecorresponding
productionservers.Inaddition,thewatermarkTestissuperimposedonallchartsand
addedtoallobjectcaptions.
Note!ThereisnolicenseleasefromQlikViewTestServer.
QlikView Server/Publisher 85
16 Editions of QlikView Server
Product Description
QlikView QlikViewPublisherisalicensethataddssignificantfunctionalitytothestandardreload
Publisher capabilityofQlikViewServer.QlikViewPublisherincludesfunctionalitytohandlefield
levelsecurityandaccesscontrolfromcentraladministrationsoftwarelikeWindowActive
DirectoryorNovellLDAP.QlikViewPublisherisalsoneededtosupportcomplex
distributionmodelsforQlikViewdocuments.Inaddition,eachlicenseofQlikView
Publisherallowsanadditionalnode/serverforreload,distribution,orsecuritymanagement
inamulti-node/serverdeployment.
WiththeadditionalcomponentQlikViewPublisherReportDistribution,anyQlikView
documentreportcanbedistributedasa .pdffiletoafolderorviaemailorSMTP.
QlikView QlikViewWorkBench(anadd-ontoQlikViewEEServer)isadevelopmenttoolfor
WorkBench creatingwebmash-upswithQlikView.Itfeaturesdraganddropeditingcapabilities
withintheMicrosoftVisualStudiodevelopmentenvironmentandallowsforcustom
webinterfacesandintegrationwiththird-partyservices.
Note!QlikViewWorkBenchisnotavailableforusewithQlikViewSBEServer.
QlikView QlikViewWebParts(anadd-ontoQlikViewEEServer)forMicrosoftSharePointallows
WebParts forrapiddeploymentofQlikViewobjectswithinMicrosoftSharePointportal
for environments.
Microsoft
Note!QlikViewWebPartsarenotavailableforusewithQlikViewSBEServer.
SharePoint
QlikView QlikViewLocalClientisaclientwithallfunctionalityusedtodevelopQlikView
LocalClient documents.QlikViewLocalClientisdeployed,iftheenduserdeployslocalclientsonly.
QlikView AnybodyregisteredonQlikView.comisallowedtodownloadQlikViewanddevelop
Personal QlikViewdocumentsforpersonaluse.TherearenorestrictionstoQlikViewPersonal
Edition EditionexceptthatitcannotopenQlikViewdocumentscreatedbyotherusersorperform
animportofanentirelayoutfromanXMLfile.
86 QlikView Server/Publisher
16 Editions of QlikView Server
Licensing
Clients
Scalability
Integration
Features
QlikView Server/Publisher 87
16 Editions of QlikView Server
Security
88 QlikView Server/Publisher
Part 6 Appendix
Part6Appendix
QlikView Server/Publisher 89
90 QlikView Server/Publisher
17 Silent Installation
17 Silent Installation
Whenrunningasilentinstallation,QlikViewisinstalledwithalimitedsetofornodialogsatall.This
meansallfeatures,properties,anduserselectionshavetobeknownwhencreatingthesilentinstallation
package.TherearealsosomestandardpropertiesinWindowsInstallerServicethatmayberequired.
Toprepareasilentinstallation,theMSIfilehastobeextractedfromtheQlikView Setup.exefile.
Asilentinstallationcanberunwithdifferentinterfacelevels:
/qn Completelysilent.
/qb Basicuserinterface.
Adda +signatendoftheinterfacelevelscommandtogetamodaldialogattheendoftheinstallation
sayingFinishedandifitwassuccessfulornot.
ThefollowingsilentinstallationcommandlinesarerecommendedforQlikView:
msiexec /i QlikViewServerx64.msi Addlocal="all" IS_NET_API_LOGON_
USERNAME="Domain\username" IS_NET_API_LOGON_PASSWORD="password /qn+
Alternatively:
QlikViewServer_x64Setup.exe /s /v"/qn+ Addlocal="all" IS_NET_API_LOGON_
USERNAME="Domain\username" IS_NET_API_LOGON_PASSWORD="password"
Thecommandlineaboveinstallsallfeaturescompletelysilentlywithamodaldialogattheendofthe
installation.
Ifjustalimitedsetofthefeaturesaretobeinstalled,change alltothenameofthefeatureinstead.If
severalfeaturesaretobeinstalled,separatethemwithcommas.
Thefollowingfeaturescanbeinstalled:
l DirectoryServiceConnector
l ManagementService
l QVS
l QvsDocs
l WebServer
l DistributionService
l SupportTools
l QvsClientswiththesub-featuresPluginandAjaxZfc
l MsIISwiththesub-featuresQvTunnelandQlikViewSettingsService
Note!Forthesub-featurestobeincludedintheinstallation,theyhavetobeincludedinthelistoffeatures
tobeinstalled.
msiexec /i QlikViewServerx86.msi ADDLOCAL="all" DEFAULTWEBSITE="2" /qn+
Thiscommandlineinstallsallfeatures,includingthevirtualdirectoriestoanotherwebsitethanthedefault
one.ThisrequiresamachinewithMicrosoftInternetInformationServices(IIS)installedandmorethanone
websiteonit.Thesitenumberalsohastobeknown.Set DEFAULTWEBSITEtothesitenumberwherethe
virtualdirectoriesaretobeinstalled.Tofindthenumberofthewebsite,checkIIS.
Theinstallationprocedurecanbelogged,usingthefollowingcommand:
msiexec /i QlikViewServerx86.msi ADDLOCAL="all" DEFAULTWEBSITE="2"/L*v
log.txt /qn+
QlikView Server/Publisher 91
17 Silent Installation
17.1 Settings
Thefollowingsettingsaregoodtoknowwhendesigningasilentinstallationpackage:
Prerequisites .NETFramework4.0
INSTALLEVEL 100,allfeaturesissetto101bydefault
IIS FourvirtualdirectoriesandanApplicationpoolareinstalled
Services Fiveservicesareinstalled
17.2 Dialogs
TheQlikViewinstallationhaseightdialogs,oneofwhichisaCustomSetupdialogandoneofwhichisa
Websitedialog.Alldialogssetimportantproperties.Tofindthevalueofaproperty,doatestinstallation
withverboselogging.Notethatthepropertyvaluesmaydifferdependingonthelanguageandoperating
systemused.
Region
Thisdialogisusedforspecifyingtheregion.
Property: REGION_LIST
Region dialog
92 QlikView Server/Publisher
17 Silent Installation
License Agreement
Thisdialogdisplaysthelicenseagreementfortheselectedregion.
Radiobutton: AgreeToLicense = "Yes"
License dialog
Customer Information
Thisdialogisusedforenteringthecustomerinformation.
Properties: USERNAME, COMPANYNAME
Destination Folder
Thisdialogisusedtosetthedefaultfolderfortheinstallation.
Property: INSTALLDIR
QlikView Server/Publisher 93
17 Silent Installation
Profiles
Thisdialoghasseveralpropertiesconnectedtoit,sincetherearemultipleprofilestochoosefrom.
Select Full Installation, Single machine with QlikView Webservertoinstalleverything,including
QlikViewWebServer,neededtorunQlikViewonasinglemachine.TouseIISinstead,select Full
Installation, Single machine with IIS(thisoptionisonlyavailableifIISisinstalledonthetargetmachine).
Toperformacustominstallation,select Custom installation, select profilesandthenselecttheprofilesto
install.The WebserverprofileallowstheusertochoosebetweenQlikViewWebServerandIIS(ifIISis
installedonthetargetmachine).
Properties:
l PROPQVS:QlikViewServer
l PROPDS:Publisher
l PROPQMC:ManagementConsole
l PROPWEB, PROPIIS=1or2:Webserver
l PROPIIS(ifIISisinstalled)or PROPSTATE:SingleMachineInstall
Profiles dialog
94 QlikView Server/Publisher
17 Silent Installation
Logon Information
Thisdialog,whichisoptionaltouse,isusedtospecifytheuserthatistoruntheservicesthatareinstalled.
Whenclicking Next,aCustomActionchecksthattheentereduserisvalid.TheCustomAction,whichis
implementedbyInstallShield,requiresthemachinetobepartofaDomaintoworkproperly.
Properties:
l LOCALSERVICE
l IS_NET_API_LOGON_USERNAME
l IS_NET_API_LOGON_PASSWORD
Ready to Install
Thisisthelastdialog.Click Installtostarttheinstallation.
QlikView Server/Publisher 95
17 Silent Installation
Website
ThisdialogisdisplayedwhenselectingIISaswebserverintheProfilesdialog,see Profiles (page 94).
Property: DEFAULTWEBSITE
Website dialog
96 QlikView Server/Publisher
17 Silent Installation
17.4 MST
WhencreatinganMSTfile,theMSIfileiscustomizedwithoutanychangesbeingmadedirectlyintheMSI.
TheMSTfileworksasafilterontopoftheMSIandallowschangestobemadetotheinstallation.For
example,thedefaultinstallationfolderforQlikViewServeris %ProgramFiles%\QlikView,butifthat
ischangedto C:\QlikViewintheMSTfile,thedefaultfolderischanged.Thesamethingcanbedone
withthedialogs,whichmeanspropertiescanbepreset,sothattheinstallationcanberunwithalimitedset
ofdialogs.
TocreateanMSTfile,anMSIrepackagingstudio(forexample,InstallShieldAdminStudio)isneeded.
Note!QlikTechdoesnotsupplyanyMSTfilesanddoesnottakeanyresponsibilityforMSTfilescreated
bycustomersorpartners.
QlikView Server/Publisher 97
98 QlikView Server/Publisher
18 OEM
18 OEM
18.1 General
TheOEMfeaturepreventsabuseofQlikViewServerssoldunderanOriginalEquipmentManufacturer
(OEM)licenseandprotectstherevenuestreamsofboththeOEMproductsandthefullQlikViewproduct.In
addition,thefeaturehelpsavoidchannelconflictsbetweenQlikViewOEMpartners,QlikViewreseller
partners,andQlikViewdirectaccountmanagers.
TheOEMfeatureincludesthefollowingrestrictions:
l AQlikViewServerdeliveredtoacustomerbyanOEMpartnercannotrunotherQlikView
applicationsthantheonesdeliveredbytheOEMpartner.
l AQlikViewapplicationdeliveredtoacustomerbyanOEMpartnercannotrunonanotherQlikView
ServerthantheonedeliveredbytheOEMpartner.
QlikView Server/Publisher 99
100 QlikView Server/Publisher
19 DSP Interface
19 DSP Interface
ThereasonfordevelopingaproprietaryDirectoryServiceProvider(DSP)istohaveQlikViewdistribute
documentstousersinadirectoryservicenotsupportedbydefault,andtoprovidegroupresolutiontothe
webserver.
19.1 DirectoryServiceProvider
DirectoryServiceProvideristheinterfaceoftheclassthatplugsintotheframework.Themembersofthe
interfacearelistedbelow.
Member Description
LogMessage LogMessageEvent { Directlyafterconstruction,thisfieldisinstantiatedwitha
set; get; } delegatethatprovidescrudeloggingfacilities.
IList<string>GetKnownRootPaths Thereturnedlistshouldcontainoneormoreviablepathsfor
(); themethodslistedhere.
Member Description
void Dispose (); Calledwheneveraproviderobjectisreleased.
IDSObject Asimpleinterfaceforanytypeofnodewithinthedirectory
service.
20 SNMP
QlikViewprovidesSNMPagentsforallservices.However,thesettingisoffbydefault,sincethe
implementationisinitsinitialstagesandsubjecttochange.Atthetimeofwriting,readingoperationsfrom
theagentsareenabled.Thefollowingmessagesaresupported:
l GetRequest
l GetResponse
l GetNextRequest
AllservicesanswerthestandardSNMPqueries(seebelow).
Identifier Query Description
1.3.6.1.2.1.1.1 sysDescr Descriptionofservice/product.
Example:
sysDescr.0:Qlikview Publisher
Commandcenterservice version 8.50.600
SNMPPort SetstheporttousefortheparticularPublisherservice.Seethedefaultsettingsfor
eachservicebelow.
SNMPsysContact Contactinformationforthepersonresponsibleforthemanagednode.Thedefault
valueis Unspecified System contact.
SNMPsysName Anadministrativelyassignednameforthemanagednode.Byconvention,thisisthe
fullyqualifieddomainnameofthenode.Ifthenameisunknown,thevalueisazero-
lengthstring.Ifleftempty,itdefaultstothecurrentmachinename.Thedefaultvalue
is Unspecified name.
SNMPsysLocation Physicallocationofthenode(forexample,telephonecloset,thirdfloor).The
defaultvalueis Unspecified location.
Thedefaultportsettingsfortheservicesarelistedbelow.
Service Default Port Setting
ManagementService 4781
DirectoryServiceConnector 4731
DistributionService 4721(defaultSNMPport)
QlikViewServer 4748
Allportscanbeconfigured.Iftheservicesareinstalledondifferentmachines,theycanallrunonthesame
port.TheportschangeastheimplementationmovesawayfromtheexperimentalSNMPrangeandintothe
rangeallottedbyQlikTech.
1.3.6.1.4.1.30764.1.2.2.1.1 QDSTaskExecuteStatusEntry
1.3.6.1.4.1.30764.1.2.2.1.1.1 QDSTaskID(taskIDnumber)
1.3.6.1.4.1.30764.1.2.2.1.1.2 QDSTaskName(taskname)
Identifier Query
1.3.6.1.4.1.30764.1.2.2.1.1.3 QDSTaskExecuteStatus(taskstatus):
l Waiting
l Running
l Aborting
l Failed
l Warning
1.3.6.1.4.1.30764.1.2.2.1.1.4 QDSTaskNextExecutionAt(whenthetaskwillbeexecutednext)
1.3.6.1.4.1.30764.1.2.2.1.1.5 QDSTaskLastExecutedAt(whenthetaskwasexecutedlast)
1.3.6.1.4.1.30764.1.2.2.1.1.6 QDSTaskCurrentWork(whatthetaskiscurrentlydoing)
1.3.6.1.4.1.30764.1.2.2.1.1.7
ForadditionalinformationonSNMP,see:
l RFCforSNMP: http://www.ietf.org/rfc/rfc1157.txt
l Wikipedia: http://en.wikipedia.org/wiki/Simple_Network_Management_Protocol
21.1 General
Acommonproblemtodayishowtodeployapplicationsinanetworkenvironmentwheretheusershave
limitedrights,andhowtodeployapplicationsforaspecificgroupofusers.Thissectionbrieflydescribes
howtodeployMicrosoftWindowsInstaller(.msi)packageswithgrouppoliciesinanActiveDirectory
environment.
Note!DeploymentofsoftwarewithgrouppoliciesisonlysupportedbyworkstationsrunningWindowsXP
Professional,WindowsVista,orWindows2003or2008Server.
TheQlikView .msipackagesrequireversion2.0orhigheroftheWindowsInstallerservicetobeinstalled
onthedestinationworkstations.
Advertising
Toadvertisemeansthattheadministratorgivestheinstallationpackagepermissiontoexecuteonanaccount
withlockeddownpermissions.
Whenthepackageisadvertised,therearesocalledentrypointsloadedontothedestinationsystem.Entry
pointsaretypicallyshortcuts,fileassociations,listingintheAdd/RemoveProgramsdialog,andsoon.
Selecting Properties
Providing a name
5. Highlightthenewgrouppolicyobjectandclick Edit.
Type CustomUser
Parameters CUSTOM\
Authentication tab
Selecting Authentication
3. Disable Windows Authenticationandenable Anonymous Authentication.
Parameter Purpose
guid IDoftheQlikViewDistributionService(QDS)wherethetaskisdefined.
taskNameOrId TasknameorIDofthetaskinstringformat.
password Password(ifrequiredbythetask).
variableName Variablename(ifrequiredbythetask).
variableValues Listofvaluesforthevariable.
Thereturnedresultcontainsinformationonwhetherthetaskwassuccessfullystartedornot.
Theexamplebelowshowshowtotriggerataskandwaituntilithasfinishedoruntilacertainamountof
timehaspassed.
TheexamplecomesfromtheQMSAPIdocumentation,whichisinstalledaspartoftheQlikView
ManagementConsole(QMC).Itcontainsdetailedinformationontheavailablemethodsandhowtoget
startedwiththeQMSAPI.