Home
TIBCO Spotfire Web Player 7.0
Contents
1. TIBCO Spotfire Web Player 7 0 73 129 Advanced Procedures and Technical Reference fileName Header htm Specify the name of the file that contains the custom header For more information about creating or modifying this file see Customize the Header Banner on page 65 height 40 Specify the pixels for the height of the custom header lt closedAnalysis gt showOpenLibrary true Specify if the Open Library link is displayed on the Closed Analysis page showReopenAnalysis true Specify if the Reopen Analysis link is displayed on the Closed Analysis page redirectTohibrary true Specify if the Closed Analysis page is displayed after an analysis is closed lt errorPage gt showOpenhibrary true Specify if the Open Library link is displayed on an error page showReopenAnalysis true Specify if the Reopen Analysis link is displayed on an error page lt serverUnavaliable gt showOpenLibrary true Specify if the Open Library link is displayed on the Server Busy page showReopenAnalysis true 6 2 3 Performance Element Specify if the Reopen Analysis link is displayed on the Server Busy page The following table contains details about the tags and attributes along with the values that you can modify in the lt performance gt element of the configuration file This section corresponds to the part of the configuration file
2. 52 129 TIBCO Spotfire Web Player 7 0 Install Spotfire Web Player Google Chrome Client Requirements You must launch Google Chrome with the following parameters e auth server whitelist e auth negotiate delegate whitelist For example chrome ex auth server whitelist domain com auth negotiate delegate whitelist domain com Where domain com is the URL to the Spotfire Web Player server You can enter the URL with a preceding wildcard character to enable Google Chrome to connect to any URL that ends in domain com For more information see the Chromium Projects developer page at http www chromium org developers design documents http authentication Mozilla Firefox Client Requirements You must configure these settings on every end user computer 1 Inthe Firefox browser address box type about config 2 For the following parameters set the values to the Spotfire Web Player URL for which you want to activate Negotiate network automatic ntlm auth trusted uris Proceed to Deploy Web Packages to Spotfire Server on page 54 3 6 4 Single Sign On Using Impersonation with Basic Login System Create an Impersonation Account on the Domain Controller The dedicated user account you intend to use for Impersonation must be present on the Domain Controller You should log on to the Domain Controller and create or verify that the dedicated user account you intend to use is avai
3. ee MN ee Specify how often the preloading service will check the library for new content Ha Negrete The search string that specifies which SBDF files to cache The default search string specifies all geocoding tables in the library you might want to restrict this in order to reduce memory consumption As the preload service uses the library it needs to run in a service account like scheduled updates and it is configured in the same place as scheduled updates lt Sbdf cache preloading gt lt spotfire dxp web sbdfCache section must be filled in to use this gt lt This is the username and password or certificate serial number for the user that preloads the files gt lt setting name SbdfCachePreloadUsername serializeAs String gt lt value gt sbdfcache lt value gt lt setting gt lt setting name SbdfCachePreloadPassword serializeAs String gt lt value gt sbdfcache lt value gt lt setting gt lt serialNumber The serial number of the certificate to use gt lt setting name SbdfCachePreloadCertificateSerialNumber serializeAs String gt lt value gt lt setting gt The user sbdfcache also needs to be added to the user table using the TIBCO Spotfire Server command line interface The user requires no licenses but it must have access to the library items to be loaded by the cache TIBCO Spotfire Web Player 7 0 99 129 Advanced Procedures and Technical
4. e false the DoD panel is always hidden e true the DoD panel is always displayed showFilterPanel showPageNavigation true Specify the behavior of the Filter panel If the value is e empty the Filter panel is displayed if the author of the analysis file chooses to display the Filter panel e false the Filter panel is always hidden e true the Filter panel is always displayed Specify if the Page tabs or page links in analyses are displayed If you set this to false only the currently active Page as saved in the analysis will be displayed Note If you set both this value and the value for showPToolBar to false the entire grey top bar of the Spotfire Web Player will not appear showStatusBar true Specify if the status bar is displayed showPrint true Specify ifthe Print menu item is displayed If true the menu item is displayed in the top right menu of the Spotfire Web Player Specify if incomplete links in the Spotfire Web Player should be treated as relative to the library root directory If false incomplete links will be prepended with http showAuthor true Specify if the Edit button is displayed This enables authoring mode in the Spotfire Web Player The default value is true lt customHeader gt nabled false Specify if the custom header with logo is displayed Set this to true to enable the custom header file display
5. To modify this behavior you must create a new error message file and then modify the configuration file After you make these changes any error that occurs in the Spotfire Web Player will be redirected to this static error page Note If you make this change users will not receive any details or information about the error Adding a Custom Error web Page In web config update the section system web customErrors to lt customErrors mode 0n defaultRedirect ExampleError html gt Create a custom error web page For example lt DOCTYPE html gt lt html lang en xmlns http www w3 org 1999 xhtml gt lt head gt lt meta charset utf 8 gt lt title gt Error TIBCO Spotfire Web Player lt title gt lt head gt lt body gt lt h1 gt TIBCO Spotfire Web Player lt hl1 gt lt div gt An error occurred lt div gt lt div gt Contact the administrator at 123 456 7890 or lt a href mailto admin mycompany com gt admin mycompany com lt a gt lt div gt lt div style margin top 10px font size 125 gt lt a href Library aspx gt Back to start page lt a gt lt div gt lt body gt lt html gt Save the web page to lt web root gt App_ Data using a name that matches the name in the lt customErrors gt Setting for example ExampleError html Advanced Web Config Settings This section discusses how you can configure advanced settings such as those for the Spotfire Web Player user int
6. 84 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference 6 6 Scheduled Updates What are Scheduled Updates Scheduled updates are an approach that you can use to reduce the time it takes for a user to open certain analysis files This is done by preloading analysis files on the Spotfire Web Player server before a user attempts to open them Scheduled updates are most effective if you have certain analysis files with linked data from an information link or any other linkable data source that are updated regularly with large amounts of new data Often such updates occur during the night and the following morning users want to open the corresponding analysis files to view the latest data If that data has already been preloaded the analysis will open much faster The same goes for a large analysis with lots of data that users might open several times during the day to quickly check for figures or similar Instead of having to load this into memory every time a user opens the analysis you can make sure this analysis is always available in memory ensuring a rapid response for the users Scheduled updates let you configure e Which analysis files should be pre loaded e When these analysis files should be pre loaded and kept in memory on the Spotfire Web Player server Event Driven Updates It is possible for the Spotfire Web Player to update the pre loaded analysis in two ways One is to specify that e
7. aspnet_counters dil 4 0 30319 12408 aspnet_filter dl 4 0 20319 12408 aspnet_perf cll 4 0 20319 18408 ATL DLL 3 5 2284 0 suthsnon dil 7 5 7601 4 authbas dil 7 5 7601 17514 authcert dll 7 5 7600 16285 authsspi dll 7 5 7601 17514 berypt dil 6 1 7600 16285 beryptprimitives di 6 1 7601 17514 BROWCLI DLL 6 1 7601 17887 cschfile cil 7 5 7601 17514 cachhttp cil 7 5 7600 16285 cachtokn dll 7 5 7600 16285 cachuri dil 7 5 7600 16285 CFGMGR22 dl 6 1 7601 17514 CLBCstQ DLL 2001 12 8530 16385 cir dil 4 0 20319 18444 circompression dil 4 0 20219 18408 Oirjit dll 4 0 20319 18444 compstat dil 7 5 7601 17514 Corper monExt dil 4 0 30319 18408 credssp dil 6 1 7601 17514 CRYPT32 dll 6 1 7601 18277 CRYPTBASE dil 6 1 7600 162385 CRYPTSP dil 6 1 7600 16385 custerr dil 7 5 7600 16285 dbghelp dil 6 1 7601 17514 defdec dll 7 5 7600 16285 dhepesve DLL 6 1 7600 16285 dhepesve6 DLL 6 1 7601 17670 diasymreader dil 11 0 50938 18408 dirlist dit 7 5 7600 16285 DNSAPI dil 6 1 7601 17870 12 1 Culture neutral PublickeyToken f7 4D08d7acb21f72 Antir2 Runtime dil 3 4 1 9004 3 4 1 9004 Antir2 Runtime Version 3 4 1 9004 Culture neutral PublicKeyToken eb42632608e026 1F Web Application oaded Assemblies Site Scheduled Updates Web Server Log 112 129 TIBCO Spotfire Web Player 7 0 6 12 6 Site Advanced Procedures and Technical Reference This tab displays information about the current activity on the web
8. www chromium org developers design documents http authentication Mozilla Firefox Client Requirements You must configure these settings on every end user computer In the Firefox browser address box type about config For the following parameters set the values to the Spotfire Web Player URL for which you want to activate Negotiate e network negotiate auth delegation uris e network negotiate auth trusted uris Proceed to Deploy Web Packages to Spotfire Server on page 54 Single Sign On Using Impersonation with Kerberos Login System Create an Impersonation Account on the Domain Controller The dedicated user account you intend to use for Impersonation must be present on the Domain Controller You should log on to the Domain Controller and create or verify that the dedicated user account you intend to use is available Note The account does not need to have Delegation user rights Set up Kerberos on the Spotfire Server Follow the instructions in the TIBCO Spotfire Server Installation and Configuration Manual to set this up e The Spotfire Server needs to be configured to support Kerberos authentication e A member of the Account Operators or Administrators domain groups must use the Windows Support Tools typically installed on one of the domain controllers to configure m The Service Principal Names SPNs for the Spotfire Server m A keytab file for the Spotfire Server e The Impersonation user
9. 10 gt lt webServic nabled false gt lt ems nabled false serverUrl topic W clientId reconnectAttemptCount 10 reconnectAttemptDelayMilliseconds 1000 reconnectAttemptTimeoutMilliseconds 1000 gt lt externalUpdate gt lt cacheSettings nabled false pa th W maxDiskSizeMb 0 maxAgeMinutes 1440 gt lt scheduledUpdates gt lt setup gt lt spotfire dxp web gt lt applicationSettings gt lt Spotfire Dxp Internal Properties Settings gt lt setting name LibraryCache Enabled serializeAs String gt lt value gt False lt value gt B lt setting gt lt Spotfire Dxp Internal Properties Settings gt lt Spotfire Dxp Web Properties Settings gt lt setting name ScheduledUpdatesUsername serializeAs String gt lt value gt ScheduledUpdatesUsername lt value gt lt setting gt lt setting name ScheduledUpdatesPassword serializeAs String gt lt value gt ScheduledUpdatesPassword lt value gt lt setting gt lt setting name EmsUpdateUsername serializeAs String gt lt value gt EmsUpdateUsername lt value gt lt setting gt lt setting name EmsUpdatePassword serializeAs String gt lt value gt EmsUpdatePassword lt value gt lt setting gt lt Spotfire Dxp Web Properties Settings gt lt applicationSettings gt lt SS EMS Updates TIBCO Spotfire Web Player 7 0 89 129 Advanced Procedures and Techni
10. 106 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference Show performance counters Select to show performance counters as described below Run a full GC Only available when performance counters are enabled Click to run a full GC garbage collection to get rid of memory that is not in use any more Note A full garbage collection may take time and the Web Player will be unresponsive while the garbage collection is running Column Description Title The title of the analysis The path of the analysis file is shown in the tooltip Instances Overview only The number of open instances of the analysis file User Name Details only The name of the user that uses the analysis Loading Time The loading time for the analysis Execution Time The execution time measures the time spent executing request for the analysis Data Table Size Data View Size The memory size of the data tables in the analysis For the Overview view the total memory size is displayed For the Details view one column shows the memory size shared between instances of the analysis and one shows the memory size of the data tables that are not shared between instances The memory size of the data views in the analysis For the Overview view the total memory size is displayed For the Details view one column shows the memory size shared between instances of the
11. 7 216 116 Other patent s pending TIBCO Software Inc Confidential Information 2 129 TIBCO Spotfire Web Player 7 0 Contents 1 Pre Installation Planning 5 1 1 Introduction 5 1 2 Architectural Overview 5 1 3 Software Overview 7 1 4 Authentication Alternatives 8 1 4 1 Username and Password 10 1 4 2 Anonymous Preconfigured Access 10 1 4 3 Single Sign On 10 1 4 4 Client Certificate 14 1 5 Service Accounts 14 1 6 Conceptual Outline of Installation Process 16 1 7 Pre Installation Checklist 17 2 Prerequisite Installation 19 2 1 Operating System 19 2 1 1 Internet Access 19 2 1 2 Active Scripting 19 2 1 3 Antivirus and Malware Scanning Software 19 2 2 Internet Information Server and ASP NET 20 2 2 1 Install on Microsoft Windows 2008 R2 Server 20 2 2 2 Install on Microsoft Windows 2012 Server 24 3 Install Spotfire Web Player 27 3 1 Copy the Installation Files 27 3 2 Run the Installer 27 3 3 Configure ASP NET Authentication 28 3 3 1 Username and Password 29 3 3 2 Anonymous Preconfigured Access 31 3 3 3 Single Sign On Using Delegation with Kerberos Login System 32 3 3 4 Single Sign On Using Impersonation with Kerberos Login System 33 3 3 5 Single Sign On Using Impersonation with NTLM Login System 34 3 3 6 Single Sign On Using Impersonation with Basic Login System 36 3 3 7 Client Certificate 37 3 3 8 Configure Proxy Handling 39 3 4 Configure IIS Authentication 39 3 4 1 Configure SSL 40 3 5 Verify the Configuration File 41
12. Controls ms P f en s a J 6 pE Authentication Authorization Compression Default Directory Error Pages Rules Document Browsing pa met m E m f b J amp WF amp Failed Request Handler HTTP Redirect HTTP IP Address IeM Tracing Rules Mappings Respo and Dom SESS Make sure that ASP NET 4 0 30319 is present in the list and set it to Allowed If ASP NET 4 0 30319 is not present you must open the command console and run the following command When the command completes repeat Step 11 and Step 12 C Windows Microsoft NET Framework64 v4 0 30319 aspnet_regiis exe i Install on Microsoft Windows 2012 Server This section explains how to install IIS and ASP NET on your Microsoft Windows 2012 Server and how to make sure that IIS has all the necessary components to run Spotfire Web Player gt Installing on Microsoft Windows 2012 Server 1 Install Microsoft NET Framework 4 5 2 on the server if it is not already present You can download Microsoft NET Framework 4 5 2 from http download microsoft com Note Make sure that you upgrade to the latest version of Microsoft NET Framework 4 5 4 5 2 or later 2 On your Microsoft Windows 2012 Server navigate to the Administrative Tools options and then select Server Manager 3 In the navigation pane select Dashboard and then click Add Roles and Features 4 Ifthe Before you begin page appears click Next 5 Select the applicable option in the Installati
13. Example All users of the Spotfire Web Player should connect to a Teradata connection using the username terauser and the password terapassword but it is not appropriate to store these credentials in the analysis file that uses the Teradata connection To configure this you should add a credentials profile in the web config section above with the profile name teradata the username terauser and the password terapassword Then each analysis file with the Teradata connection is saved with the credentials profile teradata that you specified in the Credentials tab in the Data Connection Properties dialog in TIBCO Spotfire TIBCO Spotfire Web Player 7 0 83 129 Advanced Procedures and Technical Reference 6 5 TIBCO Spotfire Statistics Services If statisticians or analysts in your company use data functions or predictive analytics tools in TIBCO Spotfire as a part of an analysis files and Spotfire Web Player will be used with these analysis files you must configure properties in this section so that TIBCO Spotfire Statistics Services can execute the data function or predictive analytic function Spotfire Web Player does not include any statistical engine such as MATLAB SAS S PLUS R or Tibco Enterprise Runtime for R TERR Rather it relies on the engine configured in Spotfire Statistics Services and specified in Spotfire Professional application For more information see the TIBCO Spotfire Statistics Services Installation and Admini
14. License Enabled TIBCO Spotfire Web Player Vv TIBCO Spotfire Web Player Extemal updates of analysis files i TIBCO Spotfire Enterprise Player Y Open File Open from Library Open Linked Data ISININ ISIS In addition to the above licenses there might be additional custom third party licenses needed to open analysis files and their linked data The account must also have access to read all the data files in the library that is to be pre loaded scheduled TIBCO Spotfire Web Player 7 0 15 129 Pre Installation Planning 1 6 10 11 When delegated Kerberos is used on the Spotfire Server the Windows user configured as the Scheduled Updates user must also have access to the data sources used by the analysis and be allowed to log in to the machine running the Web Player The account must also be able to be delegated i e the account option Account is sensitive and cannot be delegated must not be selected in Active Directory Conceptual Outline of Installation Process Performing the tasks in Prerequisite Installation on page 19 and Install Spotfire Web Player on page 27 will guide you through a full installation of Spotfire Web Player 7 0 with detailed explanations The conceptual overview or process of the installation and configuration procedures Read the Pre Installation Checklist on page 17 and record the required information Spotfire Web Player requires either Microsoft Windows 2008 R
15. Note If you complete this procedure after you install and configure IIS you must restart IIS for the changes to take effect Antivirus and Malware Scanning Software You should disable on access scanning of files in the Spotfire Web Player webroot directory and all sub directories When certain antivirus and malware scanning software packages perform an on access scan they modify the scanned files or the TIBCO Spotfire Web Player 7 0 19 129 Prerequisite Installation 2 2 2 2 1 attributes of the scanned file this results in IIS triggering a restart of the web application When the web application restarts users are logged out and the analyses is closed For performance reasons we also recommend that you disable the on access scanning for these types of software packages for directories that are used by the Spotfire Web Player You should exclude the following directories from on access scans lt Program Files gt TIBCO Spotfire Web Player C Windows Microsoft NET Framework64 v4 0 30319 Temporary ASP NET Files Internet Information Server and ASP NET Install Microsoft Internet Information Services IIS on this computer and then set up ASP NET on HS Install on Microsoft Windows 2008 R2 Server This section explains how to install IIS and ASP NET on your Microsoft Windows 2008 R2 Server and how to make sure that IIS has all the necessary components to run Spotfire Web Player If you have already installed
16. To use the upgrade tool you first need to specify certain information in the upgrade tool configuration file You can find the configuration file Spotfire Dxp Web UpgradeTool exe config in the webroot bin Tools directory of the installation TIBCO Spotfire Web Player 7 0 59 129 Upgrading The available settings in the configuration file are listed below Enter this information in the lt value gt tags lt applicationSettings gt lt Spotfire Dxp Web UpgradeTool Properties Settings gt lt setting name Credentials Enabled serializeAs String gt lt value gt False lt value gt lt setting gt lt setting name Credentials Username serializeAs String gt lt value gt CredentialsUsername lt value gt lt setting gt lt setting name Credentials Password serializeAs String gt lt value gt CredentialsPassword lt value gt lt setting gt lt setting name WebRootPath serializeAs String gt lt value gt C Program Files TIBCO Spotfire Web Player 7 0 webroot lt value gt lt setting gt lt setting name ServerArea serializeAs String gt lt value gt Production lt value gt lt setting gt lt setting name Proxy Enabled serializeAs String gt lt value gt False lt value gt lt setting gt lt setting name Proxy Username serializeAs String gt lt value gt ProxyUsername lt value gt lt setting gt lt setting name Proxy Password ser
17. Windows Authentication Requires Restart 2 The Spotfire Web Player server you are connecting to must be located in the Intranet security zone Note If the website is located in the Internet security zone Internet Explorer will not even attempt Kerberos authentication This is because in most Internet scenarios a connection with a domain controller can not be established The simple rule is that any URL that contains periods such as an IP address or Fully Qualified Domain Name FQDN is in the Internet zone If you are connecting to an IP address or FQDN then you can use the settings in Internet Explorer or Group Policy to add this site to the Intranet security zone For more information on how Internet Explorer evaluates the zone of a resource see the Microsoft knowledge base article KB 258063 Google Chrome Client Requirements You must launch Google Chrome with the following parameters e auth server whitelist e auth negotiate delegate whitelist For example TIBCO Spotfire Web Player 7 0 49 129 Install Spotfire Web Player 3 6 2 chrome ex auth server whitelist domain com auth negotiate delegate whitelist domain com Where domain com is the URL to the Spotfire Web Player server You can enter the URL with a preceding wildcard character to enable Google Chrome to connect to any URL that ends in domain com For more information see the Chromium Projects developer page at http
18. and then click Apply Enabling Constrained Delegation for a Dedicated User Account On the Domain Controller select Start gt Programs gt Administrative Tools Select Active Directory Users and Computers Locate the dedicated user account 48 129 TIBCO Spotfire Web Player 7 0 Install Spotfire Web Player 4 To open the account properties right click the account name and then click Properties 5 On the Delegation tab select Trust this user for delegation to specified services only Note The Delegation tab is only visible for accounts that SPNs are mapped to 6 Select Use any authentication protocol 7 Click Add 8 Click Users or Computers and select the account that the Spotfire Server has a keytab for and the SPNs are mapped to See Install and Configure Kerberos on the Spotfire Server on page 42 9 Select all services that apply click OK and then click Apply Spotfire Web Player Server Requirements You must configure these settings on the Spotfire Web Player server 1 Under Control Panel gt Network and Internet gt Internet Options gt Advanced select Enable Integrated Windows Authentication Requires Restart 2 The Spotfire Server you are connecting to must be located in the Intranet security zone Internet Explorer Client Requirements You must configure these settings on every end user computer 1 Under Tools gt Internet Options gt Advanced you must select Enable Integrated
19. authentication gt lt setup gt lt applicationSettings gt lt Spotfire Dxp Web Properties Settings gt lt Impersonation This is the username and password used for impersonation gt lt setting name ImpersonationUsername serializeAs String gt lt value gt impersonator lt value gt lt setting gt lt setting name ImpersonationPassword serializeAs String gt lt value gt password lt value gt lt setting gt lt Spotfire Dxp Web Properties Settings gt lt applicationSettings gt TIBCO Spotfire Web Player 7 0 29 129 Install Spotfire Web Player lt system web gt lt authentication mode Forms gt lt forms loginUrl Login aspx cookieless UseCookies defaultUrl Default aspx slidingExpiration true timeout 525600 gt lt authentication gt lt authorization gt lt deny users gt lt allow users gt lt authorization gt When you have completed the changes save the file Important To be safe you should create a backup copy of web config and store it in a reliable location You might need the information later If your environment requires a proxy service proceed to Configure Proxy Handling on page 39 Otherwise proceed to Configure IIS Authentication on page 39 3 3 1 1 URL Authentication To simplify integration with other systems you can allow users to log in via URL or standard basic authentication if Username and Passwo
20. lt filter type log4net Filter LoggerMatchFilter gt lt param name AcceptOnMatch value false gt lt param name LoggerToMatch value WebLogger gt lt filter gt lt An example how to filter out logging rows from a specific logger gt lt lt filter type log4net Filter LoggerMatchFilter gt lt loggerToMatchvalue Spotfire Dxp Framework Utilities ServerLoggerManager gt lt acceptOnMatch value false gt lt filter gt gt lt appender gt lt root gt lt Use this to get logging on INFO level gt lt level value INFO gt lt Replace with these rows to get INFO logging and a separate log that also contains DEBUG logging gt glas lt level value DEBUG gt lt appender ref ref FileAppenderDebug gt gt lt appender ref ref FileAppender gt lt root gt Note The tab can only show log information that is logged with the appender type FileAppender More information about the log system can be found at http logging apache org log4net 6 12 8 1 Log Levels Possible values for log level are DEBUG INFO WARN ERROR FATAL You can specify the minimum level you want to be logged every event for that level and above will be logged TIBCO Spotfire Web Player 7 0 115 129 Advanced Procedures and Technical Reference 6 13 DEBUG Log Level The DEBUG log level creates the most detailed log of events Due to the number
21. tfire Dxp In ternal Proper Enabled serializeAs String gt axCacheTime serializeAs String gt ties Settings gt lt Spotfire Dxp Data Properties Settings gt lt se tting name lt value gt 64 lt value gt lt s lt se etting gt tting name lt value gt 01 00 00 lt value gt lt s lt se etting gt DataBlockStoragelIOSizeKB serializeAs String gt DataOnDemand MaxCacheTime serializeAs String gt tting name AllowedWebRootFiles serializeAs String gt 68 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference lt value gt lt value gt lt setting gt lt setting name AllowedFilePaths serializeAs Xm1 gt lt value gt lt ArrayOfString gt lt string gt lt ArrayOfString gt lt value gt lt setting gt lt Spotfire Dxp Data Properties Settings gt lt applicationSettings gt Use an XML editor to open the web config file from the webroot directory for example C Program Files Tibco Spotfire Web Player 7 0 webroot Web config Note We recommend that you use an XML editor when you modify XML files An XML editor has features to provide a clear view of the XML code and some text editors corrupt configuration files Important When you save changes to the web config file IIS automatically detects that the file has been modified and restarts the Spotfire Web Player application Users who are logged int
22. 3 6 Additional Authentication Configuration 42 3 6 1 Single Sign On Using Delegation with Kerberos Login System 42 3 6 2 Single Sign On Using Impersonation with Kerberos Login System 50 3 6 3 Single Sign On Using Impersonation with NTLM Login System 52 3 6 4 Single Sign On Using Impersonation with Basic Login System 53 3 65 Client Certificate 54 3 7 Deploy Web Packages to Spotfire Server 54 3 8 Licenses and Library Rights 55 3 8 1 Licenses 55 3 8 2 Spotfire Library User Rights 55 3 9 URL Preference 56 4 Upgrading 58 4 1 Upgrading to New Version 58 4 2 Deploying Extensions and Upgrades 59 5 Testing the Installation 63 TIBCO Spotfire Web Player 7 0 3 129 6 Advanced Procedures and Technical Reference 65 6 1 Customize Web Pages 65 6 1 1 Customize the Header Banner 65 6 1 2 Custom Error Web Page 66 6 2 Advanced Web Config Settings 66 6 2 1 Setup Element 69 6 2 2 User Interface Element 71 6 2 3 Performance Element 74 6 2 4 Spotfire Dxp Services Settings Element 78 6 2 5 System Web Settings Element 78 6 2 6 Application Settings Element 78 6 3 Language Support 80 6 3 1 Specify Language Mappings 80 6 3 2 Language Packs 81 6 4 Data from External Sources 81 6 5 TIBCO Spotfire Statistics Services 84 6 6 Scheduled Updates 85 6 6 1 Set up Scheduled Updates 88 6 6 2 Upgrade an Existing Schedule 98 6 7 Cache and Preload SBDF Files 98 6 8 Resource Monitoring to Improve Performance 100 6 9 Encrypt Usernames and Passwords 102 6 10 Configure Maximum
23. Anonymous Preconfigured Access on page 31 e Single Sign On Using Delegation with Kerberos Login System on page 32 28 129 TIBCO Spotfire Web Player 7 0 Install Spotfire Web Player e Single Sign On Using Impersonation with Kerberos Login System on page 33 e Single Sign On Using Impersonation with NTLM Login System on page 34 e Single Sign On Using Impersonation with Basic Login System on page 36 e Client Certificate on page 37 In addition Proxy Handling is explained in this chapter 3 3 1 Username and Password The installation wizard configures the ASP NET Authentication method however if you need to change to Username and Password authentication any time after installation you must edit the following settings You must modify the web config file to set lt authentication mode gt to Forms including sub section Also lt authorization gt should be set to lt deny users gt lt allow users gt These settings technically mean that the system will deny un authenticated users and allow any user that has not been denied You can also specify whether you want to allow users to save entered username and password If you do allow user to save this information it is saved in an encrypted cookie on the client Modify the relevant values indicated by bold text in the following code lt spotfire dxp web gt lt setup gt lt impersonation enabled false gt lt
24. Finally you must restart the web server by entering the following commands in the command prompt net stop was y net start was net start w3svc TIBCO Spotfire Web Player 7 0 45 129 Install Spotfire Web Player 3 6 1 3 Register Web Server Principal Names SPN In this section you verify the registration of the Service Principal Names is correct on the IIS computer running Spotfire Web Player e Ifthe web application pool hosting Spotfire Web Player is running under a dedicated user account you must map both SPNs HTTP servername and HTTP servername domain td to that dedicated user account Important HTTP SPNs that are already mapped to any other account must be modified to be mapped to the dedicated user account e Ifthe Spotfire Web Player is accessible at additional hostnames for example www domain tld then an SPN must be registered for that hostname as well That is you must register an SPN for each DNS A record However no SPNs should be registered for any DNS CNAME records e No action is required if both of the following conditions are met In this case default SPNs will apply m IIS is accessible at http servername or http servername domain tld where tla top level domain such as com or local The web application pool hosting the Spotfire Web Player is running under the Network Service account Adding an SPN using SetSPN To add a server name mapped to a dedicated user account setspn A
25. HTTP servername port Domain UserName setspn A HTTP servername domain tld port Domain UserName To add an additional host name mapped to a computer account setspn A HTTP hostname port Domain ComputerName setspn A HTTP hostname domain tld port Domain ComputerName To add an additional host name mapped to a dedicated user account setspn A HTTP hostname port Domain UserName setspn A HTTP hostname domain tld port Domain UserName Removing old SPNs If you used a dedicated user account for the application pool and need to change to a pre defined account you must modify the existing SPNs You can do this with the same setspn commands except you must use the switch to delete D instead of add A Fully Qualified Name Resolution When you use Kerberos authentication on the Spotfire Web Player server all communication must use a fully qualified domain name FQDN 46 129 TIBCO Spotfire Web Player 7 0 Install Spotfire Web Player gt Verifying that IIS can be reached with an FQDN 1 On the domain controller open a command prompt 2 At the command prompt type ping fqdn For example ping mywebserver mydomain ms local If IIS responds to the ping the server is configured to respond to FQDN requests 3 6 1 4 Enabling Delegation For IIS on the Spotfire Web Player server to be able to pass user tickets to the Spotfire Server delegation user rights must have been enabled on the Domain Controller for the
26. Install Microsoft NET Framework 4 5 2 on the server if it is not already present Copy the new Spotfire Web Player 7 0 installer files to a temporary directory on the server Run the installer Note Be sure to specify the same name for the Virtual Directory as for the previous version If you change it old links to analyses will not find their targets The installer will automatically remove the older Spotfire Web Player and install the new Spotfire Web Player Edit the new web config in that directory to suit your needs as described in the Installation chapter You can review the settings made in the old web config but do 58 129 TIBCO Spotfire Web Player 7 0 4 2 10 11 12 Upgrading not copy entire sections of XML and paste into the new 7 0 web config since the structure has been changed and needs to be intact Configure the web site as described in the Installation chapter Configure Licenses and Library Rights as described in the Installation chapter Set the URL preference as described in the Installation chapter Redeploy any custom extensions that were previously deployed on your Spotfire Web Player server If the extensions were not deployed as packages on the old Spotfire Web Player server you need to build packages of the extensions using the Package Builder located in the Spotfire SDK http stn spotfire com stn Extend SDKOverview aspx Note The packages must be marked with the in
27. Mode Basic Mschine Name REF ARCH SRV7 No of Processors s Memory Working Set Size 2 150 MB Memory Used For Caching Csiculations 222 MB CPU Losd 0 Memory available before swapping to disk 9 275 MB Available Physical Memory 11 732 MB Total Physical Memory 16 381 MB Server GC True Web Server GC Latency Mode SustsinedLowLatency Thread Pool Available 18 0 Thread Pool Min o0 Thread Pool Mex 16 0 Thread Pool Queue o Thread Pool Queue Age 00 00 00 TIBCO Spotfire Web Player 7 0 111 129 Advanced Procedures and Technical Reference 6 12 4 Web Application This tab displays information about the Spotfire Web Player web application and shows the configurations and settings specified in the web config file 6 12 5 Web Player Monitoring Spotfire Server spotfire dxp web setup javeScriptApilenabled errorReportinglemsilAddress errorReporting maxMsilLength langueges installedLenguages cultureName langusgesilangusgeMsppings suthenticstion serverUrl authenticstion customAuthenticstoritype suthenticstion impersonstion ensbled authenticstion certificstes useCertificstes suthenticstion certificstes storeName suthenticstionicertificstes storeLocation scheduledUpdates enabled scheduledUpdates uselibrary scheduledUpdates libraryFileName scheduledUpdstes concurrentUpdstes scheduledUpdates settingsFile scheduledUpdates forcedUpdetelensbled scheduledUpdates forcedUpdate maximumRejectecUpdates scheduledUpdates externalUpdate k
28. Operators or Administrators domain groups must use the Windows Support Tools typically installed on one of the domain controllers to configure m The Service Principal Names SPNs for the Spotfire Server A keytab file for the Spotfire Server e You must enable ASP NET Impersonation on IS This alternative does not require that you to configure Delegation on the Domain Controller Instead you configure a trusted account on the Spotfire Web Player that the Spotfire Server allows to run requests as another user This is referred to as Impersonation More information about keytab files and Kerberos on the Spotfire Server refer to the TIBCO Spotfire Server Installation and Configuration Manual If it is not possible to complete these requirements you can use either Impersonation with NTLM Login or Impersonation with Basic Login to achieve single sign on Delegation with Kerberos Login In this approach when a user connects to the Spotfire Web Player from a browser the Windows credentials are used to automatically log in the user The Spotfire Web Player then contacts the Spotfire Server which prompts the Spotfire Web Player to authenticate the user The Spotfire Web Player automatically logs into the Spotfire Server as the end user Delegation makes it possible for the Spotfire Web Player to log into the Spotfire Server as the end user and not the account that is actually running the Spotfire Web Player The requirements
29. Reference 6 8 Resource Monitoring to Improve Performance Resource monitoring is a way to ensure good performance to the users of the Spotfire Web Player when the server load gets too high It allows you to configure threshold values that prevent users from opening new files if these threshold values are exceeded In effect it ensures good performance for users already working with analyses on the Spotfire Web Player while temporarily denying users the ability to open analyses when the server is under heavy load To enable resource monitoring you must set siteLimitations to enabled true in the configuration file and add at least one threshold value If at least one of the threshold values is exceeded additional users will be prevented from opening analyses To modify the configuration file use an XML editor to open the web config file from the webroot directory for example C Program Files Tibco Spotfire Web Player 7 0 webroot Web config Note We recommend that you use an XML editor when you modify XML files An XML editor has features to provide a clear view of the XML code and some text editors corrupt configuration files The web config settings have the following default values lt spotfire dxp web gt lt performance gt lt siteLimitations enabled false minimumAvailableMb Infinite maximumOpenAnalyses Infinite gt Key Description enabteg Enable the server limitation function by setting this
30. Size for File Upload 103 6 11 Configure the Spotfire Web Player Using FIPS 104 6 12 Diagnostics 105 6 12 1 Web Player Monitoring 105 6 12 2 Spotfire Server 111 6 12 3 Web Server 111 6 12 4 Web Application 112 6 12 5 Loaded Assemblies 112 6 12 6 Site 113 6 12 7 Scheduled Updates 114 6 12 8 Web Server Log 114 6 13 Logging and Monitoring 116 6 13 1 Enable logging in web config 117 6 13 2 Enable logging in log4net config 118 6 13 3 External Monitoring Tool 124 6 14 Performance 124 6 15 Set up a Server Cluster 125 6 16 Backup and Restore 127 7 Uninstall 129 7 1 Stopping the Application Pool 129 7 2 Spotfire Web Player Software Uninstall 129 4 129 TIBCO Spotfire Web Player 7 0 1 1 1 2 Pre Installation Planning Pre Installation Planning Introduction The TIBCO Spotfire Web Player must be installed on a Microsoft Internet Information Services IIS server The Spotfire Web Player renders the Spotfire visualizations and graphics that are delivered to users When a user launches a Web browser on a local computer and types the URL to an analysis on the Spotfire Web Player the Spotfire Web Player opens a connection to the TIBCO Spotfire Server In turn the Spotfire Server manages the data and delivers the required information to the Spotfire Web Player the Spotfire Web player then renders the view to be presented in the web browser on the local computer Note For new or changed features functionality changes and information
31. To configure Kerberos on the Spotfire Server follow the instructions in the TIBCO Spotfire Server Installation and Configuration Manual e Configure the Spotfire Server to support Kerberos authentication e A member of the Account Operators or Administrators domain groups must use the Windows Support Tools typically installed on one of the domain controllers to configure m The Service Principal Names SPNs for the Spotfire Server m A keytab file for the Spotfire Server 42 129 TIBCO Spotfire Web Player 7 0 3 6 1 1 any aD 3 6 1 2 Install Spotfire Web Player Remove the NTLM Provider When using delegated Kerberos authentication it is important to remove the possibility for the clients to use the NTLM authentication protocol This is done by removing the NTLM provider from the web application s authentication configuration Removing the NTLM Provider Select Start gt Administrative Tools gt Internet Information Services IIS Manager In the navigation panel to the left select Server name gt Sites gt Default Web Site gt SpotfireWeb Double click on the Authentication icon under IIS in the main panel Select Windows Authentication in the list Click Providers in the right hand panel Select NTLM in the list Click Remove Click Ok Configure the Application Pool Account on IIS While it is possible to use Single Sign On using delegation with Kerberos login system with the applica
32. Totals 4 00 01 23 show performance counters Total Data Table Total Data View Total Document Execution Timey Size Size Node Count Idle Time Scheduled 00 01 16 00 00 01 7 00 00 01 3 00 00 00 00 00 00 00 01 24 81MB 161 KB 24630 00 01 32 false 00 00 04 6 3 4 MB 2 7 M8 20193 00 00 17 false 1 4 KB 18 K8 3697 00 00 04 false 506 KB 650 KB 8487 00 00 30 false 23 MB 25M8 172097 00 00 00 tue 94 KB 223 KB 19503 00 00 00 true 108 MB 29 MB 248697 00 00 04 Description Show Overview Details Select the level of detail shown in the list of open analyses If Overview is selected an analysis will only be listed once even though there may be several open instances of the analysis Refresh Refreshes the list of the open analyses and performance counters The list of analyses displays the current values The difference between the current values and the previous values are displayed within parenthesis Close Analysis Close the selected analysis Note If Overview is selected all instances of the analysis will be closed Note The user is not notified when the administrator closes the analysis Open Analysis Open a new instance of the selected analysis Show Document Nodes and View Sizes Select whether to show Document Nodes and View Sizes in the list of open analyses or not These calculation may take a substantial time when enabled Disabling them can make the refresh faster
33. Windows integrated authentication Also make sure that you run the file as a user with the permission to start and stop IIS on the Spotfire Web Player server The upgrade tool will check if there are any upgrades available on the Spotfire Server and if there are it will automatically stop the application pool install the upgrades and restart the application pool It is also possible to schedule the webupdate bat file to run at given times using the Task Scheduler on the Spotfire Web Player server 62 129 TIBCO Spotfire Web Player 7 0 Testing the Installation 5 Testing the Installation Perform the following procedures to verify that your installation of Spotfire Web Player works as intended gt Opening an Analysis in a Web Browser 1 Open a web browser 2 Enter the URL to the Spotfire Web Player For example http s lt servername gt SpotfireWeb 3 Log inif necessary Response You will now see the Spotfire Library which by default contains some folders and a few analysis files 4 Navigate to a folder and click on an analysis file 5 Verify that the analysis is displayed in your web browser gt Publishing an Analysis and Viewing it in a Web Browser 1 Onacomputer that has the regular TIBCO Spotfire client installed start TIBCO Spotfire by selecting Start gt All Programs gt TIBCO gt TIBCO Spotfire 2 Login 3 Select File gt Open to open some data For example use an Excel file or similar 4
34. about issues see the TIBCO Spotfire Web Player Release Notes at http docs tibco com Architectural Overview In the most basic Spotfire installation the Spotfire Web Player and Spotfire clients communicate with a single Spotfire Server as illustrated below Spotfire Database Spotfire Spotfire Server Web Player server Authentication Service lt a n aay Spotfire Spotfire jane Web Player clients TIBCO Spotfire Web Player 7 0 5 129 Pre Installation Planning In a Spotfire system with more than one Spotfire Server the Spotfire Web Player communicates with a cluster of Spotfire Servers behind a load balancer Authentication Spotfire asr Service Database iN t Jaume a Spotfire bo Ty s gt A Management Console Pa S I A F N F r O Cluster of Nae Spotfire Servers af lt eS Fd gt a Spotfire Web Player clients Spotfire clients Load Balancer Spotfire SS my Web Player server Regardless of whether one or several Spotfire Servers exist in the Spotfire installation the Spotfire Web Player is installed and configured in the same way You can also configure a group of Spotfire Web Player servers as a cluster onns yT yaa Spotfire Database Spotfire Server J Authentication I Service Cannes y Cluster of lt Web Player Servers L af va Ss A P Nann Spotfire clients Seu ES Spotfire Web Player clients You can configure a Spotfire
35. an analysis that is based on data from a prompted or personalized information link there are some issues you should be aware of 86 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference Whenever a user opens an analysis that is based on a prompted information link the user will select a certain view of the data to be loaded In the same manner whenever a user opens an analysis based on a personalized information link the data loaded will be determined by the user rights of the user who logs in However when a scheduled update of this file occurs that update will cause the analysis to reload based on the prompted values specified when originally saving the file and for the user rights of a user that the administrator set up to programmatically run the scheduled update This means that users with an analysis already open will see a different selection of data the next time they update the analysis since the scheduled update has in fact updated the underlying data on the server You need to be especially careful if you are setting up scheduled updates for analyses with personalized information links If the user you specify for the scheduled updates has access to more data than the intended users of the analyses then these users might see more data than they have access to 1 e they will see all the data that the user specified for scheduled updates has access to Concerning Sharing Routines for Li
36. analysis and one shows the memory size of the data views that are not shared between instances TIBCO Spotfire Web Player 7 0 107 129 Advanced Procedures and Technical Reference Document Node Count The amount of document nodes For the Overview view the total amount is displayed For the Details view one column shows the amount shared between instances of the analysis and one shows the amount that are not shared between instances The document node count is a measure of the complexity of the analysis More plots pages columns filtering schemes markings etc will lead to a higher value If NET memory is a problem it is likely that the analyses that use much more document nodes than the others are an issue Idle Time The time elapsed since the last user interaction Scheduled True if the analysis is scheduled for automatic updates Performance Counters Y Show performance counters Name Value Process Private Bytes w3wp 2268 Webplayer total working memory 2168 NET CLR Memory Bytes in all Hesps w3wp 885 MB Number of shared docu Webplayer cached Webplayer processor time 0 3 0 7 Total processor time 0 4 0 7 NET CLR Memory Induced GC w3wp Run a full GC 2 Performance Counter Description Process Private Bytes w3wp The amount of memory that the process has asked for Webplayer total working memory The amount of memory used
37. com en us library cc731499 aspx 2012 http technet microsoft com en us library cc731499 aspx Note Some details of the procedure are different between Windows Server 2008 R2 and Windows Server 2012 For more information see http technet microsoft com You have now configured a cluster of Spotfire Web Player servers Using the Command Prompt we can see on each of the server nodes that the network settings have been changed 126 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference C gt ipconfig Windows IP Configuration Ethernet adapter Local Area Connection Connection specific DNS Suffix TP Address aot a So eae Se E ce A 192 168 1 6 SUDNEE Mask e 4 Sei ty es Vee ae ke A an MOE TLZ9 ZI ZOO IP Address 4 6 aon 4A ww Seow 6 ob 19251268513 Subnet Mask 2 4 re SF E an Ge A Ge 25 Oe 5 250680 Default Gateway 192 168 1 1 Connecting to SpotfireWeb on the cluster IP address in this example http 192 168 1 6 Spotfireweb will start the Spotfire Web Player against one of the server nodes In a clustered Spotfire Web Player environment you should set the WebPlayerUr1 in the Spotfire Dxp Web KeepAlive exe config file to a domain name to which all servers in the environment can connect If some servers cannot reach the server entered in the WebPlayerUr1 some servers depending on the load balancer may not be kept alive by the keepalive service In the situation where some servers c
38. counterInstance The instance of the performance counter Value The value the performance counter returns UserSessionStatisticsLog Properties Default level oFF Property Description sessionId The ASP NET session ID ipAddress The IP Address of the web client userName The username of the logged on client browserType The name and major version number of the browser cookies Returns true if cookies are enabled loggedInDuration The duration of time the user has been logged in maxOpenFilesCoun The maximum number of open files openFilesCount The number of currently open files DateTimesLog Properties DateTimesLog only supports the message format Default level oFF MemoryStatisticsLog Properties Default level oFF Property Description sessionId The ASP NET session ID userName The username of the logged on client analysisId The unique ID for the analysis TIBCO Spotfire Web Player 7 0 121 129 Advanced Procedures and Technical Reference tablelId The unique ID for the table This will be empty if the value is a total analysisPath The library path for the analysis title The title of the analysis type The type of information one of SharedApproximateTotalTableSize SharedApproximateTotalViewSize DocumentNodeCount SharedDocumentNodeCount ApproximateExecutionTime value The number of bytes nodes or
39. created given the licenses for the library and configured for impersonation on the Spotfire Server For more information and procedures see the TIBCO Spotfire Server Installation and Configuration Manual Set the lt authentication mode gt to none This also requires authorization to be set to allow all users lt allow users gt Now remove the lt deny users gt line Modify the relevant values indicated by bold text in the following code lt spotfire dxp web gt lt setup gt lt ImpersonationUsername and ImpersonationPassword must also be set to enable impersonation gt lt impersonation enabled true gt lt authentication gt lt setup gt lt applicationSettings gt lt Spotfire Dxp Web Properties Settings gt lt Impersonation This is the username and password used for impersonation gt lt setting name ImpersonationUsername serializeAs String gt lt value gt impersonator lt value gt lt setting gt lt setting name ImpersonationPassword serializeAs String gt lt value gt password lt value gt lt setting gt lt Spotfire Dxp Web Properties Settings gt TIBCO Spotfire Web Player 7 0 31 129 Install Spotfire Web Player lt applicationSettings gt lt system web gt lt authentication mode None gt lt authentication gt lt authorization gt lt allow users gt lt authorization gt When you have completed the changes save
40. for example Login analysisid The document id GUID of the currently open document TIBCO Spotfire Web Player 7 0 119 129 Advanced Procedures and Technical Reference argument An argument for the operation for example the path of the analysis status Failure or Success MonitoringEventsLog Properties Default level INFO Property Description syenk Typs The type of event Information Information related to the event argument Arguments related to the event DocumentCacheStatisticsLog Properties Default level oFF Property Description parh The path of the currently open document mgdifiedon The modified date of the document referenceCount The count of concurrent open references to the current document OpenFilesStatisticsLog Properties Default level oFF Property Description sessionId The ASP NET session ID filePath The path of the currently open document modifiedon The modified date of the document fileId The file ID elapsedTime The time since opened inactiveTime The inactivity time 120 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference PerformanceCounterLog Properties Default level INFO Property Description counterCategory The category of the performance counter counterName The name of the performance counter
41. in the format HH MM SS for data on demand to be cached This setting is only used if you configured data on demand to be cached on the Spotfire Web Player Default value is one hour 01 00 00 TIBCO Spotfire Web Player 7 0 79 129 Advanced Procedures and Technical Reference BiToncavebnooek ties Provide the full path to files stored in the Spotfire Web Player installation directory or any of it s subdirectories that you want to access from the Spotfire Web Player Separate entries with a semi colon All paths are relative to the webroot directory For example c Program Files Tibco Spotfire Web Player 7 0 Example lt value gt Logfiles PerformanceCounter txt Logfiles Spotfire Dxp Web log lt value gt AlTowedFilePaths Dpawide the fill nath ta directarieearfilecana Ce ae Provide the full path to directories or files on a local disk other than the Spotfire Web Player installation directory that you want to access in the Spotfire Web Player Specify each file or directory in a separate lt string gt tag For example lt value gt lt ArrayOfString gt lt string gt C MyData lt string gt lt string gt C Logs spotfire txt lt string gt lt ArrayOfString gt lt value gt 6 3 Language Support This section covers how you can specify a language for the user interface in a browser and information about using Language Packs with Spotfire Web Playe
42. in web config The following section shows how to configure the collection of user and session statistics and performance counters in the web config file lt spotfire dxp web gt lt performance gt lt performanceCounterLogging nabled true logiInterval 120 counters Ww debugLogInterval 15 debugCounters Ww gt lt statistics flushInterval 300 enabled true gt Key Description performanceCounter Logging enabTed Set this to true default to enable the logging of the specified performance counters The result of this logging can be found in the PerformanceCounterLog txt file specified in the 1og4net config file logInterval Specify the number of seconds between each performance counter logging at INFO level Default value is 120 TIBCO Spotfire Web Player 7 0 117 129 Advanced Procedures and Technical Reference FOUREEES Add performance counters you wish to log at both INFO and DEBUG level separated by a comma Each counter consists of three parts category counter and instance separated by a semi colon Both standard Windows performance counters as well as a set of internal TIBCO counters may be included Pybus Teg Tee ye Specify the number of seconds between each performance counter logging at DEBUG level Default value is 15 Boned Cunt ene Add additional performance counters you wish to log at DEBUG level
43. installation as a combination of Spotfire Server clusters and Spotfire Web Player clusters 6 129 TIBCO Spotfire Web Player 7 0 Pre Installation Planning Spotfire Server and Spotfire Web Player on a Single Computer We recommend that you install Spotfire Web Player on one or more separate computers or dedicated IIS servers However it is possible to install Spotfire Web Player on the same computer where you installed Spotfire Server Since this has an adverse impact on performance for both products and leads to communication complications because by default both Spotfire Server and the Spotfire Web Player are configured to listed on port 80 Kerberos authentication is not supported in the scenario where Spotfire Server and Spotfire Web player are installed on the same computer 1 3 Software Overview Technology Spotfire Web Player is implemented as an Internet Information Services ASP NET AJAX web application For specific system requirements see http support spotfire com sr asp Installation and File Locations The Spotfire Web Player installation wizard installs and configures Spotfire Web Player on a Windows server The wizard copies all of the files contained in the distribution to a directory that you specify during the installation process the default directory is C Program Files TIBCO Spotfire Web Player 7 0 0 Windows Service The Spotfire Web Player installation creates the TIBCO Spotfire Web Player Kee
44. labeled 6 7 and 8 in the previous code sample Position Tag with default value Explanation 6 lt documentCache gt purgelInterval 300 Specify the number of seconds between server searches to identify unused open documents templates to be purged Default value is 300 seconds range is 60 to 3600 itemExpirationTimeout 00 00 00 Specify the length of time in the format HH MM SS that a document can remain in the cache when no open analysis is using that document template Default value is 00 00 00 maximum value is 23 59 59 7 lt analysis gt 74 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference checkClosedinterval 60 Specify how often in seconds the server should check if an analysis has been closed on the client Default value is 60 range is 60 to 300 closedTimeout 120 Specify how long in seconds an analysis session will stay alive on the server when a ping fails Default value is 120 range is 60 to 600 checkInactivityInterval 300 Specify how often in seconds the server should check if an analysis session has had no user activity excluding pings Default value is 300 range is 60 to 12 3600 inactivityTimeout 02 00 00 Specify the length of time in the format HH MM SS that an analysis session can be alive on the server when the no user activity has been detect
45. license features must enabled for all users who should have access to analyses in the Spotfire Web Player Note that other license features under the TIBCO Spotfire Enterprise Player License and the TIBCO Spotfire Business Author License may also be applicable TIBCO Spotfire Web Player e TIBCO Spotfire Web Player select this license for all users of Spotfire Web Player TIBCO Spotfire Enterprise Player e Open File this license function is required to open an analysis from the Spotfire Web Player e Open from Library this license function is required to open an analysis saved in the library For more information on these and other licenses see the TIBCO Spotfire Deployment and Administration Manual Configuring License Functions Start TIBCO Spotfire and log in as an administrator Select Tools gt Administration Manager Select the Groups and Licenses tab Select a group for which you want to configure licenses Click the Licenses tab in the right hand pane For each group of users that will use the Spotfire Web Player click the Edit button select the check boxes for the above mentioned license functions and click OK Spotfire Library User Rights The analyses shown in the Spotfire Web Player are in effect files stored in the Spotfire Library It is therefore necessary for the various users of Spotfire Web Player to have access to the library sections where a variety of content is stored TIBCO Spotfi
46. of events the DEBUG log level will create a separate log file To do this specify the following in the lt root gt section lt root gt lt level value DEBUG gt lt appender ref ref FileAppenderDebug gt lt appender ref ref FileAppender gt lt root gt This will create one log file with DEBUG level and one log file with INFo level Note Be careful of selecting DEBUG since this will log large amounts of events and quickly create huge log files There is also a risk that you miss important information among less important information due to the volume of information in the log This level is only to be used when actively trying to find the source of a problem Other Log Levels If you do not want to use the DEBUG log level simply specify INFO WARN ERROR or FATAL in the lt root gt section lt root gt lt level value WARN gt lt appender ref ref FileAppender gt lt root gt Logging and Monitoring To track the resource usage for the Spotfire Web Player server you can enable logging and monitoring of the server by adding and enabling performance counters in the web config file and by adding the settings for the log files you want to create in the log4net config file located in the webroot App data directory of the installation The following log files can be enabled in the log4net config file e AuditLog txt At INFO level user login and logout initiate open for analy
47. pages showHelp true gt Specify if the Help menu item is displayed If true the menu item is displayed in the top right menu of the Spotfire Web Player When a user clicks Help the Spotfire Web Player online help is launched lt pages showUserName true gt Specify if the user name should appear in the Spotfire Web Player user interface for instance in the Modified By section in the library browser and the Analysis Information dialog The default value is true If you set this value to false the user name will not be displayed TIBCO Spotfire Web Player 7 0 71 129 Advanced Procedures and Technical Reference lt diagnostics errorLogMaxLines 2000 gt Specify the maximum number of lines from the error log files to display on the diagnostics page Default value is 2000 range is 1000 50000 lt analysis gt showToolTip true Specify if highlighting tooltips should be shown in visualizations Setting this value to false will increase performance showClose true Specify if the Close menu item is displayed If true the menu item is displayed in the top right menu of the Spotfire Web Player S8howlToolBar true N A aA a a A a a S ON Ran Erue Specify if the menu and the Refresh Collaboration Bookmark and Filter buttons in the tool bar are displayed If true the buttons are displayed in the tool bar of the Spotfire Web Player Note If you
48. separated by a comma statistics ae aioe Specify the number of seconds between each logging Default value is 300 enabled When true enables logging of all the other statistics for the Spotfire Web Player server The result of this logging can be found in the other log files specified in the log4net config file 6 13 2 Enable logging in log4net config This section shows how you can configure the log4net config file located in the webroot App_ data directory of the installation to create the log files mentioned earlier Each section in the configuration file corresponds to a log file The file paths in each appender have to be set correctly For example they should be set to the same directory as the default log file Spot fire Dxp Web 1og which can be found in the installed Log4net config There are two levels for logging INFO and DEBUG Select which level to use for each log in this file and specify the performance counters for the levels in the web config file as described in Enable logging in web config on page 117 You can log to a database instead of log files This is done by writing AdoNetAppenders instead of the RollingFileAppenders in the log4net config file Note The logging specified in the 1og4 net config file can be switched on or off while the Spotfire Web Player server is running This is done by setting the level value to DEBUG INFO OF OFF 6 13 2 1 Logging Prop
49. set this value to false users of the Spotfire Web Player will not be able to use the functionality made available through these controls Note If you set both this value and the value for showPageNavigation to false the entire grey top bar of the Spotfire Web Player will not appear show nalysisInformationTool true Specify if the Analysis Information menu item is displayed If true the menu item is displayed in the top right menu of the Spotfire Web Player Shoyi spo r Lem eve Specify if the Open in TIBCO Spotfire menu item is displayed If true the menu item is displayed in the top right menu of the Spotfire Web Player ShovExponEVisuaitzanion ninug Specify if the Export Visualization Image menu item is displayed If true the menu item is displayed in the top right menu of the Spotfire Web Player This value also controls the display of the menu item in the Visualization menu showUndoRedo true Specify if the Undo and Redo menu items are displayed and if undo is available in the visualization If true the menu item is displayed in the top right menu of the Spotfire Web Player 72 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference showDodPanel Specify the behavior of the Details on Demand DoD panel If the value is e empty the DoD panel is displayed if the author of the analysis file chooses to display the DoD panel
50. site Web Player Monitoring Spotfire Server Web Server Web Application Loaded Assemblies Ea Scheduled Updates Web Server Log Uptime 02 56 50 Concurrent users 2 4 Number of cached queries for data connections o Cached analyses er 2 Open ansiyses Current sessions leifg 0 1 SchedulerUserSession localhost internal 3 2 zhdj4dgdpgjuehruaag2iwwx 10 100 24 11 usert Reference Architecture Test fil Reference Architecture Test files Reference Architecture Test files KMesns 2014 3 42 Current analyses Reference Architecture Test files 22_USACounties 26 PM b3cdae 1dde7b50120062 14 12 51 51 PM 2014 3 39 36 PM 1 761b3a8 O 00 00 05 00 06 30 f761b2aa O 00 00 07 00 06 15 16 1b3as O 00 00 09 00 06 00 usert 3 27 2014 3 42 02 PM 3641b2607 17836223053 27 125176 1b3as 0 00 00 05 00 06 30 Reference Architecture Test files Airports usert 3 27 2014 3 42 12 PM 8306b40s0fb1039 1d0do 27 1251ff61b2as 0 00 00 07 00 06 15 Reference Architecture Test files KMesns usert 2727 2014 3 42 26 PM b3cdse1dde7b501200622 27 125 1f6 1b3aa 0 00 00 09 00 06 00 Clear cache for all data connections General Information Numbers within parentheses indicates the maximum number of concurrent users analyses that was measured during this uptime Name Description Uptime How long the web application has been running Concurrent users The number of currently logge
51. the default e mail application maxMailLength 1000 Specify the maximum number of characters in the e mail that is generated when a user clicks the Report error to administrator link Some e mail systems including Lotus Notes have a 2000 character limit automaticallyShutDownAfterStartup FailureAfterMinutes 5 Specify the number of minutes the Spotfire Web Player application will wait before trying to restart if there has been an error during startup This setting is useful in the case where the Spotfire Server is offline for maintenance Note Do not set this value to a number less than 2 because IIS might disable the Spotfire Web Player application pool if the Spotfire Web Player is restarted several times over a short period 3 lt authentication gt serverUrl http spotserver Specify the URL to the Spotfire Server This is the server to which the Spotfire Web Player will connect This URL is entered in the installation wizard during the Spotfire Web Player installation but you can modify the URL in this element enableAutocomplete false Specify if passwords can be saved in the browser Set this value to true to allow passwords to be saved This also enables the login dialog to display auto complete suggestions for user names 70 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference loginService Specify if the login service
52. to the Spotfire Web Player anonymously which means that they are all technically logged in as the same user 76 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference maxRenderTimeMs 60000 Specify the time limit for each request or render job is allowed to create an image on the Spotfire Web Player for a visualization You can use this setting to prevent long running requests or jobs from making the Spotfire Web Player unresponsive Note If an end user encounters a case where this setting times out they will receive the error The max rendering time maxRenderTimeMs was exceeded The default value is 60 seconds in milliseconds 60000 maxAnalysisShutdowniInformations 1024 When an analysis is closed on the Web Player server the reasons why it was closed are stored and used when the analysis is re opened This value specifies the maximum number of entries stored Note This setting should not be changed userPreferencesMaxAge 00 05 00 Specify the interval in the format HH MM SS for the preferences and licenses to be synchronized when additional users log in to the Spotfire Web Player Default value is 00 05 00 8 lt hierarchicalClustering gt maxinteractiveElements 2000 Specify the maximum number of rows or columns of a hierarchical clustering that can be started interactively in the Spotfire Web Player Default value is 200
53. to true 100 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference minimumAvailableMb This value is the threshold when the Spotfire Web Player server will deny additional users attempting to open an analysis It is specified as available megabytes of free RAM left for the Spotfire Web Player to use before it starts to swap to disk This is not the same as the number of Mb available in the computer since the Spotfire Web Player tries to swap out memory to disk if less than 15 memory is left in the server Recommended value A good value to try first is 50 Mb A higher value gives better performance for the users but fewer people can open files if the limit is reached Also a higher value can sometimes affect the NET framework which will not release its memory if there is too much available on the computer The default value is Infinite which means that no resource monitoring will be performed for this attribute Note Specified values should be numeric only That is 50 Mb is specified as 50 in the web config file maximumOpenAnalyses Users will be prevented from opening analyses if the number of open analyses is above or equal to this setting Recommended value This is very dependent on the size of the analysis files that are used and if users open the same sharing or different analyses If you are unsure leave this at the default Infinite value and
54. wizard by double clicking setup exe Comment Installation from a network drive is not supported 2 On the Welcome page Click Next 3 On the TIBCO Spotfire License Agreement read the License Agreement To proceed you must agree to the License Agreement and then click Next 4 Specify the directory where you want to install Spotfire Web Player and then click Next Comment Ifthe server has more than one disk we recommend that you install on the fastest disk This will decrease the Spotfire Web Player load time and also optimize any swapping 5 Type the name of the Virtual Directory to create in IIS The name you type here will be part of the Spotfire Web Player URL We recommend that you accept the default SpotfireWeb Spotfire Web Player URL pattern http s lt servername gt SpotfireWeb TIBCO Spotfire Web Player 7 0 27 129 Install Spotfire Web Player 3 3 6 Type a port number for the Spotfire Web Player and then click Next Comment The port number that you type in this step must match the IIS port number Specify the TIBCO Spotfire Server URL and then click Next Note You can modify the URL later by editing the web config file Type the e mail address to the Spotfire administrator and then click Next Note You can modify the e mail address later by editing the web config file Click Install to start the installation and when the wizard completes click Finish After the installation has fin
55. 0 maxElements 30000 Specify the maximum number of rows or columns of a hierarchical clustering that can run on the Spotfire Web Player Scheduled updates can run hierarchical clustering up to this size Default value is 30000 maxiInteractiveJops 2 Specify the maximum number of interactive clustering jobs running in parallel Default value is 2 cpuFactoriInteractivedJobs 0 8 Specify an estimate of the number of threads that clustering will use for interactive jobs ona multi core server running Spotfire Web Player Default value is 0 8 TIBCO Spotfire Web Player 7 0 77 129 Advanced Procedures and Technical Reference cpuFactorLargeJobs 0 5 Specify an estimate of the number of threads that clustering will use for scheduled update jobs on a multi core server running Spotfire Web Player Default value is 0 5 nativeMemory 500 gt Specifies a memory limit in MBytes for the clustering algorithm The default value 500 MBytes matches maxElements 30000 6 2 4 Spotfire Dxp Services Settings Element The following table contains details about the tags and attributes along with the values that you can modify in the lt Spotfire Dxp Services Settings gt element of the configuration file This section corresponds to the part of the configuration file labeled 9 in the previous code sample Position Tag with default value Explana
56. 0 97 129 Advanced Procedures and Technical Reference 6 6 2 6 7 Set Startup Type to Automatic Start the service Comment The Keep Alive service will create a log at C Program Files TIBCO Spotfire Web Player 7 0 Logfiles Spotfire Dxp Web KeepAlive log The Scheduled Updates are now active Comment You can review the KeepAlive log to verify that it is working Upgrade an Existing Schedule We recommend that in order to keep the scheduled updates for Spotfire Web Player 7 0 you should keep them in the library You can do this by setting the attribute useLibrary to true in web config However if you have an existing schedule that you want to use in the new installation it is important to follow the instructions below Upgrading an Existing Schedule Before uninstalling the old version make a backup of the old ScheduledUpdates xml located in the Spotfire Web Player 6 0 webroot app data directory Copy the ScheduledUpdates xm1 file to the installation media directory and replace the existing empty file Install Spotfire Web Player 7 0 The first time the Spotfire Web Player site starts it will read the installed schedule file in Spotfire Web Player 7 0 webroot app data directory and upload the content to the library Note This upload will only be done once for a library if the file has already been uploaded the contents in ScheduleUpdates xml in the app_data directory will be overwritten by the content already ex
57. 2 Server or Microsoft Windows 2012 or R2 Server You must install Microsoft Internet Information Services IIS and configure it with ASP NET 4 5 2 Copy the Spotfire Web Player installation files to the computer Run the Spotfire Web Player installer If required configure the ASP NET authentication in the web config file Comment It is important that you decide which authentication method to use before you install For more information on the authentication alternatives see Authentication Alternatives on page 8 If required configure IIS authentication Review the web config file to verify that no unwanted changes have been made during installation Complete the configuration of the authentication method you selected for your environment Configure the licenses and library rights for the Spotfire Web Player users Configure the URL preference 16 129 TIBCO Spotfire Web Player 7 0 Pre Installation Planning 1 7 Pre Installation Checklist Before you begin the Spotfire Web Player 7 0 installation there are several things you must determine This section contains checklists that you must complete Compatibility There are some things that you must take into consideration regarding compatibility and different versions of the software In order to install Spotfire Web Player 7 0 you must have Spotfire Server 7 0 Also Spotfire Web Player 7 0 does not support side by side installations of different versi
58. 7 0 webroot Web config Note We recommend that you use an XML editor when you modify XML files An XML editor has features to provide a clear view of the XML code and some text editors corrupt configuration files 2 Add anew settings collection named lt languageMappings gt 3 For each mapping from a browser language that is not directly supported add a setting in the format lt add browserLanguage en GB installedLanguageToUse en US gt 4 Save web config Important When you save changes to the web config file IIS automatically detects that the file has been modified and restarts the Spotfire Web Player application Users who are logged into the Spotfire Web Player will be disconnected 6 3 2 Language Packs For information on how to deploy language packs for Spotfire Web Player please refer to the TIBCO Spotfire Deploying and Using a Language Pack manual If you deploy a Japanese or another double byte language pack or if you intend to use data containing characters from these languages you might also need to install Windows files for East Asian Languages from the Regional and Language Option on the Spotfire Web Player server 6 4 Data from External Sources TIBCO Spotfire can access data directly from several external data sources using the Spotfire Data Connectors To be able to use analyses with data from these sources in Spotfire Web Player you must specify the authentication method in the web config
59. Click OK to accept Import Settings Response The data is loaded and a visualization appears 5 Select File gt Save As gt Library Item Enter a name and click Next a A Enter a Description and click Next 8 Select Override these settings and embed all data and click Finish TIBCO Spotfire Web Player 7 0 63 129 Testing the Installation 9 10 11 12 On the page that appears verify that there is a link to the Spotfire Library and also directly to the published file Save as Library Item A Sales Data for Q2 has been published A Location for the file in the Library Copy Link Sales and Marketing 2009 Sales Data for Q2 The analysis can be accessed with the TIBCO Spotfire Web Player from u Copy Link Piave http dxpwebclient Spotfire Web ViewAnalysis aspx file Sales and Marketing 2009 Sales Data for Q2 Send an email to notify users about the analysis Send Email Click on the link to the published file Response Your web browser launches Log in to the Spotfire Library if necessary Verify that the analysis is displayed in your web browser Testing the Installation from a Web Browser on the Server If you would like to test the application from a web browser directly on the web server you need to turn off Internet Explorer Enhanced Security Configuration Otherwise you will not be able to use Internet Explorer for more than st
60. IIS with an earlier version of ASP NET you must install Microsoft NET Framework 4 5 2 Installing on Microsoft Windows 2008 R2 Server Install Microsoft NET Framework 4 5 2 on the server if it is not already present You can download Microsoft NET Framework 4 5 2 from http download microsoft com Note Make sure that you upgrade to the latest version of Microsoft NET Framework 4 5 4 5 2 or later On your Microsoft Windows 2008 R2 Server navigate to the Administrative Tools options and then select Server Manager 20 129 TIBCO Spotfire Web Player 7 0 3 4 5 Prerequisite Installation In the navigation pane select Roles and then click Add Roles E Server Manager File Action View Help 9 2mE ED eO J Roles a Features E Diagnostics igi Configuration Fr Storage ix View the health of the roles installed on your server and add or remove roles and features Roles Summary 2l Roles Summary Help Roles 0 of 17 installed Remove Roles y g 4 J X Last Refresh 11 12 2007 08 43 00 Configure refresh I If the Before you begin page appears click Next In the Select Server Roles page select Web Server IIS and then click Next Add Roles Wizard x ic Select Server Roles Before You Begin Select one or more roles to install on this server Roles Description ry Web Server IIS provides a reliable Active Directory Certificate Ser
61. Next and then click Finish Configure User Rights for the Dedicated User Account You must add the dedicated user account to the local Administrators group Adding the Dedicated User Account to the Local Groups On the Spotfire Web Player server select Start gt Administrative Tools gt Computer Management Expand Local Users and Groups and then click Groups Open the Administrators group and add the dedicated user account Configure the Application Pool Identity Next you must set the application pool to run as the dedicated user account by following these steps Configuring the Application Pool Identity Select Start gt Administrative Tools gt Internet Information Services IIS Manager In the IIS Manager select Computer name gt Application Pools and then select TIBCO Spotfire Web Player Pool Right click the application pool and select Advanced Settings Select Identity and click On the Application Pool Identity page select Custom account and click Set Enter the user name and password for the dedicated application pool user account Click OK three times 44 129 TIBCO Spotfire Web Player 7 0 Install Spotfire Web Player Configure the Account to be Used for Decrypting Kerberos Tickets If Kernel mode authentication is enabled and the web application s application pool is running under a custom identity then the web application must be configured so that the application pool s identity is us
62. O Software Inc and or subsidiaries of TIBCO Software Inc in the United States and or other countries All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only This software may be available on multiple operating systems However not all operating system platforms for a specific software version are released at the same time Please see the readme txt file for the availability of this software version on a specific operating system platform THIS DOCUMENT IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND EITHER EXPRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE OR NON INFRINGEMENT THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT TIBCO SOFTWARE INC MAY MAKE IMPROVEMENTS AND OR CHANGES IN THE PRODUCT S AND OR THE PROGRAM S DESCRIBED IN THIS DOCUMENT AT ANY TIME Copyright 1996 2015 TIBCO Software Inc ALL RIGHTS RESERVED THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND OR QUALIFIED DIRECTLY OR INDIRECTLY BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND READ ME FILES TIBCO Spotfire is covered by U S Patent No 6 014 661 and U S Patent No
63. PANEL k gt By default the xHTML is lt table cellpadding 0 cellspacing 0 style white space nowrap gt lt tr gt lt td style width lpx vertical align bottom gt lt img alt Logo src SAppPath Images CompanyLogoWide png gt lt td gt lt td style white space nowrap vertical align bottom gt lt span class CustomizationAreaLargeText gt Spotfire Web Player lt span gt lt td gt lt tr gt lt table gt To customize the xHTML edit the Header htm file in the installation directory before installing the product or edit the file after installation then located in the App Data directory of the web root Note This file is a translatable file that can be loaded in different languages If you install a language pack you should modify the file on that installation also If no TIBCO Spotfire Web Player 7 0 65 129 Advanced Procedures and Technical Reference 6 1 2 translation is needed the file is language independent you can just copy the file for the default here This file is located in lt web root gt App Data lt Language gt Header htm Example the German file is located in lt web root gt App Data de DE Header htm Custom Error Web Page If your Spotfire Web Player environment is open to external users you can replace the default error messages that are displayed for the Spotfire Web Player to prevent users from injecting user controlled error messages through a URL
64. RM can help ensure equitable servicing of Web server i The default installation for the Web Server IIS role indudes the installation of role services that enable you to serve static content make minor customizations such as default documents and HTTP errors monitor and log server activity and configure static content compression aaa ra ewe 7 Inthe Select Role Services page you must select at a minimum the settings listed for each group in the following table You may need to select more options for your environment Comment In the Security group make sure to select the authentication types required in your environment Group Setting Common HTTP Features Application Development Health and Diagnostics Security Performance Static Content Default Document Directory Browsing HTTP Errors ASP NET NET Extensibility ISAPI Extensions ISAPI Filters HTTP Logging Request Monitor Basic Authentication Windows Authentication Request Filtering Static Content Compression 22 129 TIBCO Spotfire Web Player 7 0 Group Prerequisite Installation Setting Management Tools IIS 6 Management Compatibility IIS Management Console IIS Management Scripts and Tools IIS 6 Metabase Compatibility IIS 6 WMI Compatibility IIS 6 Scripting Tools Comment If a prompt for Add role services and features required for ASP NET appears select Add Required Role Services 8 When yo
65. S computer right click the account name and then click Properties On the Delegation tab select Trust this computer for delegation to any service Kerberos only and then click Apply Enabling Unconstrained Delegation for a Dedicated User Account On a Domain Controller in Windows Server 2003 Mode On the Domain Controller select Start gt Programs gt Administrative Tools Select Active Directory Users and Computers Locate the dedicated user account To open the account properties right click the account name and then click Properties On the Delegation tab select Trust this user for delegation to any service Kerberos only and then click Apply Note The Delegation tab is only visible for accounts that SPNs are mapped to Enabling Constrained Delegation for a Computer Account On the Domain Controller select Start gt Programs gt Administrative Tools Select Active Directory Users and Computers Locate the computer account To open the computer properties for the IIS computer right click the account name and then click Properties On the Delegation tab select Trust this computer for delegation to specified services only Select Use any authentication protocol Click Add Click Users or Computers and select the account that the Spotfire Server has a keytab for and the SPNs are mapped to See Install and Configure Kerberos on the Spotfire Server on page 42 Select all services that apply click OK
66. TIBCO Spotfire Web Player 7 0 Installation and Configuration Manual TIBC Revision date 9 February 2015 Important Information SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY OR PROVIDE LIMITED ADD ON FUNCTIONALITY OF THE LICENSED TIBCO SOFTWARE THE EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE AGREEMENT OR IF THERE IS NO SUCH SEPARATE AGREEMENT THE CLICK WRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE SOFTWARE AND WHICH IS DUPLICATED IN THE LICENSE FILE OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICK WRAP END USER LICENSE AGREEMENT THE LICENSE S LOCATED IN THE LICENSE FILE S OF THE SOFTWARE USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME This document contains confidential information that is subject to U S and international copyright laws and treaties No part of this document may be reproduced in any form without the written authorization of TIBCO Software Inc TIBCO and Spotfire are either registered trademarks or trademarks of TIBC
67. Web Properties Settings gt lt Impersonation This is the username and password used for impersonation 36 129 TIBCO Spotfire Web Player 7 0 3 3 7 Install Spotfire Web Player gt lt setting name ImpersonationUsername serializeAs String gt lt value gt user lt value gt lt setting gt lt setting name ImpersonationPassword serializeAs String gt lt value gt pa55w0rd lt value gt lt setting gt lt Spotfire Dxp Web Properties Settings gt lt applicationSettings gt When you have completed the changes save the file Note If ASP NET Impersonation was enabled for the Spotfire Web Player in the IIS management console there may be a duplicate lt identity impersonate true gt element in web config This duplicate setting may prevent Spotfire Web Player from working Important To be safe you should create a backup copy of web config and store it in a reliable location You might need the information later If your environment requires a proxy service proceed to Configure Proxy Handling on page 39 Otherwise proceed to Configure IIS Authentication on page 39 Client Certificate You must modify the web config file to enable lt impersonation enabled gt by setting it to true In the lt certificates gt element set the useCertificates value to true storeName to My and storeLocation to LocalMachine Set the lt authentication mode gt to none Since the authenticatio
68. XML editor when you modify XML files An XML editor has features to provide a clear view of the XML code and some text editors corrupt configuration files Locate the lt system web gt section Add the following line in the lt system web gt section lt machineKey validationkey AutoGenerate IsolateApps decryptionKkey AutoGenerate IsolateApps validation 3DES decryption 3DES gt Save the web config file Restart the IIS service 104 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference Note Changing to the 3DES algorithm from the AES algorithm decreases the security level 6 12 Diagnostics By entering the following URL in your browser you will reach the Diagnostics page of Spotfire Web Player Example http lt servername gt SpotfireWeb Administration Diagnostics aspx You can also reach it by clicking Tools gt Diagnostics in the library This page consists of several tabs which lists various kinds of system information Diagnostics Export Inf Web Player Monitoring Spottire Server Server Web Server Web Application Loaded Assemblies Site Scheduled Updates Web Server Log Server URL http J ref erch srv2 spotfireref local 8060 e Web Player Monitoring e Spotfire Server e Web Server e Web Application e Loaded Assemblies e Site e Scheduled Updates Optional tab e Web Server Log Access to these tabs is under license control and can o
69. all performance you can modify these values to allow IIS to run a recycle process Configure and Start the Keep Alive Service The default setting for IIS is to shut down the web application if there has not been a connection to it in the last 20 minutes This behavior prevents the Scheduled Updates 94 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference from running their tasks and keeping the specified analysis files instantiated in memory To avoid this a windows service will read the configuration file and ping the Spotfire Web Player to make sure that IIS is running during the periods configured in the schedules Note IIS needs to periodically restart itself to clear up free memory so it is recommended to give IIS at least an hour of free time every 24 hours When the Spotfire Web Player was installed a Windows service named Spotfire Dxp Web KeepAlive exe was installed in the Tools directory of the Spotfire Web Player server For example C Program Files TIBCO Spotfire Web Player 7 0 webroot bin Tools The service is not enabled during the Spotfire Web Player installation and configuration To enable the service go to Administrative Tools gt Services gt TIBCO Spotfire Web Player Keep Alive Service and set startup type to Automatic You must restart the service after you have saved your final settings in the configuration file Spot fire Dxp Web KeepAlive exe config which is located in
70. annot reach this URL we recommend that you use an IP address or localhost and circumvent the load balancer Modify the configuration file webroot bin Tools Spotfire Dxp Web KeepAlive exe config lt setting name WebPlayerUrl serializeAs String gt lt value gt http clustername SpotfireWeb KeepAlive ashx lt value gt lt setting gt 6 16 Backup and Restore If Spotfire Web Player needs to be restored this is done by completing a new installation of the Spotfire Web Player However since the Spotfire Web Player does not store any state itself you must make a backup of important files after configuring the Spotfire Web Player in order to be able to recover it properly Note It is also important to back up the Spotfire Server to be able to recover all settings Please refer to the TIBCO Spotfire Server Installation and Configuration Manual for more information on how to back up the Spotfire Server Note Do not forget to make a new backup of the Spotfire Web Player after making changes to any of the important files listed below Files to Back up A standard installation is performed in this location C Program Files TIBCO Spotfire Web Player 7 0 webroot TIBCO Spotfire Web Player 7 0 127 129 Advanced Procedures and Technical Reference Back up the following files paths are relative to the webroot directory Files When to include web config Always app_data Header htm If the header has
71. atic web pages To turn it off go to the Server Manager select the Security Information section click Configure IE ESC and select Off A simpler option is to test the installation from another stand alone computer 64 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference 6 Advanced Procedures and Technical Reference 6 1 Customize Web Pages This section covers the process to co brand an analyses file by customizing the header banner and how to modify the error handling to minimize the ability of users to inject malicious code 6 1 1 Customize the Header Banner You can co brand an analyses by displaying your company logo in the top header of the Spotfire Web Player analyses Perform this modification in the Header htm file in the App Data directory of the installation directory To enable the display of this co branding element and modify the height of the display area you must modify the configuration file To enable the header banner and change the height see User Interface Element on page 71 The Header htm file is a part of an xHTML file it should only contain the xhtm1 of the visible component NOT the HTML HEAD or BODY tags The xHTML is then merged into the top of all the pages the outlined part in the image below and displayed to the user eR OpUUS oe Gr epee Spotfire Web Player Help Close he table of everything Another page page malua FILTER
72. atically by the installer but if you want to confirm that you have the correct settings use the following procedure TIBCO Spotfire Web Player 7 0 39 129 Install Spotfire Web Player 3 4 1 Configuring Authentication on IIS 7 and IIS 8 Click Start gt Administrative Tools gt Internet Information Services IIS Manager In the Internet Information Services IIS Manager navigation pane click Local computer gt Sites gt Default Web Site Expand SpotfireWeb and then double click Authentication Enable or Disable authentication methods as required for your environment E Internet Information Services US Manager E lt gt gt PASP2008SRV64 gt Sites gt Default WebSite SpotfreDXP gt File View Help Authentication 17 Ie ca Start Page 5 84 PASP2008SRV64 PAsP2008sRv _SFOUP by No Grouping 2 Application Pools Name _ Status Response Type 5 8 Sites Anonymous Authentication Enabled Default Web Site H E aspnet_dient f D SpotfireWeb ASP NET Impersonation Windows Authentication Spotfire Authentication Method Authentication Setting Username amp Password Anonymous Authentication Enabled Forms Authentication Enabled Anonymous Login Anonymous Authentication Enabled Single Sign On Windows Authentication Enabled ASP NET Impersonation Enabled Client Certificate Anonymous Authentication Enabled Note If y
73. been customized Note Include any other files related to the customized header for example images bin Tools Spotfire Dxp Web Keep alice exe contig If you use scheduled updates and the keep alive service app datatscheduledupd tes xm If the scheduled updates are not stored in the library app_data ServerUnavailable htm If you created a custom page Certificate files If you use SSL https Mashups If you have any mashup applications gt Recovering the Spotfire Web Player 1 Install Spotfire Web Player as described in this manual and configure it in the same way as the old one Comment If you are using Kerberos X 509 certificates have configured impersonation towards the TIBCO Spotfire Server or have a server cluster you should restore to a computer with the same name the same IP address and the same port number 2 Replace the web config file in the webroot directory of the new installation with the backup file Comment If the username and password have been encrypted in lt Spotfire Dxp Internal Properties Settings gt they are not readable on a new computer and the encryption needs to be done again 3 Replace the other applicable files with the backed up versions 4 Ifyou have upgraded the Spotfire Web Player with extensions or upgrades you must upgrade the Spotfire Web Player again 5 Verify that the new installation works as intended by following the instructions in the chapter Testing the Insta
74. by the Web Player process NET CLR Memory Bytes in all Heaps w3wp The amount of INET CLR memory used by the process Data Engine memory The amount of memory used by the data engine This includes all data views and data tables Data Engine Cache memory The amount of memory used by the data engine cache This can be paged out if necessary 108 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference Webplayer memory available before A web player server that is low on memory will paging data to disk start to page out data engine memory Number of shared document nodes The total number of document nodes that can be shared Webplayer cached documents The number of cached analyses Webplayer processor time The current percentage of processor time used by the web player Total processor time The current percentage of processor time used by all processes NET CLR Memory Induced The number of induced full garbage collections GC w3wp 6 12 1 2 Troubleshooting Performance The first thing is to look at the performance counters at the bottom of the Open Analysis page e If Webplayer processor time is constantly high CPU is an issue e If Webplayer total working memory is high and Webplayer memory available before paging data to disk is low then RAM is an issue Troubleshoot CPU If CPU is constantly high look at the loa
75. cache instead of from the server When this is enabled the schedules are not carried out as specified but are delayed until the library cache is updated Set this value to false lt Spotfire Dxp Web Properties Setting s gt ScheduledUpdates Username ScheduledUpdates Password The name of the Scheduled Updates account user that will be used to access the TIBCO Spotfire Server when updating analysis files This user must have user rights on the Spotfire Server to access the relevant files and be a member of the Scheduled Updates Users group on the server If you have configured the Spotfire Web Player to use Anonymous Preconfigured Access this user must be the same user you specified for Impersonation ImpersonationUsername The user name needs to contain the domain so enter the value on the syntax domain username Enter this information in the lt value gt tags Note If you have configured the Spotfire Web Player to use Client Certificate authentication this value should be left empty To specify a scheduled update user with client certificates see Client Certificate on page 37 To encrypt this credential see Encrypt Usernames and Passwords on page 102 The password for the user that will be used to access the TIBCO Spotfire Server when updating analysis files If you have configured the Spotfire Web Player to use Anonymous Preconfigured Access this must be the password for the us
76. cal Reference spotfire dxp web scheduledUpdates externalUpdate ems section must be filled in to use this This is the username and password for the user that connects to the gt EMS server The following table contains details about the tags and elements that you can modify in the configuration file as listed in the previous code sample Key Description lt scheduledUpdates gt siabled To enable Scheduled Updates set this key to true Hon LEY To save the Scheduled Updates settings in the library instead of locally make sure that this key is set to true se braryEtLeN me Specifies the name of the file that contains the Scheduled Updates settings in the library settingsFile The relative path to the ScheduledUpdates xml file from the webroot directory This key is filled in automatically by default concurrentUpdates The maximum number of concurrent updates that can be executed at the same time This is used to limit resources used by the update mechanism Default value is 2 min value is 1 and max value is 10 aaa How often the ScheduledUpdates xml file should be read to check if any updates should be run This is set in seconds Default value is 60 min value 30 and max value 3600 one hour lt forcedUpdate gt enabled It is possible to force updates upon users even though the analysis is set to notify the users This is useful if someone has left an analysis open for a long time an
77. ces On the Features page select NET Framework 4 5 and then click Next When you have selected the appropriate settings click Next and then on the Confirmation page click Install When the installation completes click Close Start the IIS Manager TIBCO Spotfire Web Player 7 0 25 129 Prerequisite Installation 14 In the navigation pane select the server top node and then select ISAPI and CGI Restrictions 15 Make sure that ASP NET 4 0 30319 is present in the list and set it to Allowed gt Enabling Microsoft NET Framework 3 5 on Windows Server 2012 1 On the Microsoft Windows 2012 Server navigate to the Administrative Tools options and then select Server Manager 2 Select Dashboard in the left hand list and click Add Roles and Features 3 Inthe Add Roles and Features Wizard if the Before you begin dialog appears click Next 4 Inthe Select installation type dialog select Role based or feature based installation and click Next 5 In the Select destination server dialog select the target server and click Next 6 Inthe Select server roles dialog click Next 7 Inthe Select features dialog select the check box next to Net Framework 3 5 Features and click Next 8 Inthe Confirm installation selections dialog you are prompted to specify an alternate source path for NET 3 5 Comment If the target computer does not have access to Windows Update specify the path to the sources sxs folder on the in
78. computer or dedicated user account which the application pool is running under gt Enabling Unconstrained Delegation for a Computer Account On a Domain Controller in Windows 2000 Mixed or Native Mode 1 On the Domain Controller select Start gt Programs gt Administrative Tools 2 Select Active Directory Users and Computers 3 Locate the computer account 4 To open the computer properties for the IIS computer right click the account name and then click Properties 5 On the General tab select Trust computer for delegation and then click Apply gt Enabling Unconstrained Delegation for a Dedicated User Account On a Domain Controller in Windows 2000 Mixed or Native Mode 1 On the Domain Controller select Start gt Programs gt Administrative Tools 2 Select Active Directory Users and Computers 3 Locate the dedicated user account 4 To open the account properties right click the account name and then click Properties 5 Select the Account tab in the Account Options list select Account is trusted for delegation and then click Apply gt Enabling Unconstrained Delegation for a Computer Account On a Domain Controller in Windows Server 2003 Mode 1 On the Domain Controller select Start gt Programs gt Administrative Tools 2 Select Active Directory Users and Computers 3 Locate the computer account TIBCO Spotfire Web Player 7 0 47 129 Install Spotfire Web Player To open the computer properties for the II
79. consistent when troubleshooting problems with the installation Impersonation account When a user logs into the Web Player this account is used to impersonate the user on the Spotfire Server This is normally used when Web Player is set up using custom authentication or when Windows authentication is used without delegated Kerberos The account is only used to access the Spotfire Server when logging the user in using impersonation This user should have no licenses in Spotfire set and have no access rights in the library to prevent any security problems The user must also be in the Impersonator group Note If Anonymous authentication is used the impersonation account must have access rights to the library Application Pool account This is the Windows Account that will execute the application pool of the Web Player and is at installation set to the local NETWORK SERVICE account on the Web Player sever machine In some cases for example when delegated Kerberos is used this account needs to be changed For security reasons the application pool account should never be allowed to log in to the Spotfire Server This can be prevented by making sure that the account is not synchronized with the Spotfire Server Scheduled Updates account This account should be in the group Scheduled Updates Users and needs to have the following licenses usually set on the Scheduled Updates Users group to be able to open analyses and their linked data
80. d here to be able to use more than one on the same computer on ae Specify the number of reconnect attempts to be made if a connect fails By default this number is set to 10 reconnectAttempt Specify the delay for the reconnect attempts By default this is set to 1000 milliseconds saan ea Specify the timeout for the reconnect attempts By default Milliseconds this is set to 1000 milliseconds seacheset tings If the Web Player Server is restarted analyses that are scheduled to be pre loaded will need to be reloaded If the data used in the analyses take a long time to load so will the analyses Therefore it is possible to cache data from scheduled analyses on disk to be able to reload the analyses faster on restart This is specified in this section enabled Set to true to enable caching of data on disk path Specify the path on disk where data is to be stored Pa zeMb Specify the maximum disk space used for the cached data Set this to 0 zero to cache data without an upper limit 7 ee Specify how long a cache entry should be kept on disk if it has not been reloaded by scheduled updates TIBCO Spotfire Web Player 7 0 91 129 Advanced Procedures and Technical Reference lt applicationSettin gs gt lt Spotfire Dxp In ternal Propertie s Settings gt LibraryCache Ena bled If caching of metadata for items in the library is enabled metadata is retrieved from the
81. d in users Number of cached queries for data connections The number of cached queries to external data sources This can be reset by clicking Clear cache for all data connections at the bottom of the page Cached analyses The number of currently cached analyses Open analyses The number of currently open analyses Current sessions This section shows a list of the currently active sessions The information shows the username the number of open analyses the sessionID the IP number of the client the browser used and the time the session started The open analyses are also listed for each session Current analyses This section shows a list of the currently open analyses and which users are accessing them The information shows the path to the file the time it was opened the analysisID any pending Http requests the time since the last ping and the idle time of the analysis TIBCO Spotfire Web Player 7 0 113 129 Advanced Procedures and Technical Reference 6 12 7 Scheduled Updates 6 12 8 This tab displays the log for any Schedules Updates It contains the path and name of all scheduled files and also information about the time of the last update the duration of the last update and the chosen schedule for each file Web Player Monitoring Spotfire Server Web Server Web Application Loaded Assemblies Site Scheduled Updates Web Server Log Reference Architecture Test files Kazakhs
82. d you want to avoid numerous versions of the analysis to be kept simultaneously To enable forced updates set this key to true maximumRejected Updates Specify the number of times a user can be notified of new updates without accepting them before the update is forced on the user lt externalUpdate gt keepAliveMinutes If a schedule has not been set up for when a file is to be pre loaded specify the number of minutes the file should be kept alive 90 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference DelayMilliseconds lt webService gt cnabteg To enable updates triggered by a web service set this key to true Note To enable updates triggered by a web service scheduledUpdates must also be enabled and configured semg Note For information on TIBCO Enterprise Message Service and details on the following settings see to the TIBCO Enterprise Message Service User s Manual Beer ee To enable updates triggered by a message sent from TIBCO Enterprise Message Service set this key to true Note To enable updates triggered by ems scheduledUpdates must also be enabled and configured SENS EUT Specify the URL and if applicable the port to the EMS server nope Specify the topic that the EMS durable subscriber should listen to Crier By default the EMS durable subscriber uses the computer name as the client id Specify another client i
83. ding time and execution time columns in the Open Analyses table The analyses with the highest values are consuming the most CPU Troubleshoot Memory Consumption If the memory consumption is very high it is important to find out which type of memory that is the bottleneck e Ifthe Data Engine memory is a large portion of the Webplayer total working memory the Data Table and Data View columns are the most important Are there any analyses that hold a lot of data table and view memory e If on the other hand Data Engine memory is only a small portion of the Webplayer total working memory then the NET memory is an issue and now the Document Node count is the column to look at Document nodes are a bit more complicated since they may be of different sizes However it is likely that the analyses that use much more document nodes than the others are an issue To get rid of a possible error source when measuring NET memory it is recommended to run a full GC 2 two times to give the system a chance to reclaim memory that is released Be careful if the server is very busy since the system may be unresponsive for a while during the GC TIBCO Spotfire Web Player 7 0 109 129 Advanced Procedures and Technical Reference Conclusions The result of the troubleshooting above will hopefully give you information on which analyses that actually consumes the memory It is possible to get statistics for a single ana
84. e ashx lt value gt lt setting gt TIBCO Spotfire Web Player 7 0 95 129 Advanced Procedures and Technical Reference lt setting name EMS Enabled serializeAs String gt a lt value gt False lt value gt lt setting gt lt setting name EMS ServerUrl serializeAs String gt lt value gt EMSServerUrl lt value gt lt setting gt lt setting name EMS Topic serializeAs String gt lt value gt EMSTopic lt value gt lt setting gt lt setting name EMS UserName serializeAs String gt lt value gt EMSUserName lt value gt lt setting gt lt setting name EMS Password serializeAs String gt lt value gt EMSPassword lt value gt lt setting gt lt setting name EMS ReconnectAttemptCount serializeAs String gt lt value gt 10 lt value gt lt se lt set na se gt tting gt ting me EMS ReconnectAttemptDelayMilliseconds rializeAs String lt value gt 1000 lt value gt lt se lt set na se gt tting gt ting me EMS ReconnectAttemptTimeoutMilliseconds rializeAs String lt value gt 1000 lt value gt lt se lt Spo lt appli lt Erro lt log4net gt tting gt tfire Dxp Web KeepAlive Properties Settings gt cationSettings gt r logging and statistics gt lt appender name type gt lt file val Log gt FileAppender log4net Appender Roll
85. e day Therefore when saving the analysis to the library you can set sharing routines for the huge data table to always share and sharing routines for the small data table to always load You then set up a scheduled update for the analysis file to load and update every ten minutes starting at 4 am and ending at 10 pm TIBCO Spotfire Web Player 7 0 87 129 Advanced Procedures and Technical Reference 6 6 1 What will happen is that the first time the scheduled update is run 4 am both the huge data table and the small data table will be loaded as the analysis is opened and kept in memory Every ten minutes the analysis file will be updated but only the small data table will be reloaded since the sharing routines specify that the huge data table will only be loaded the first time the analysis is opened The sharing routine always share means that the data table will only be loaded the first time someone opens the analysis in this case the first scheduled update Users opening the analysis in their web browsers during the day will get a quick response from the server since the analysis is already in memory Every ten minutes the scheduled update will run on the server and the end users will see the icon stating that they can update their analysis by clicking on it Doing so will update the analysis with the latest data The scheduled update will be fast since it only reloads the small data table and not the hu
86. eb config and store it in a reliable location You might need the information later If your environment requires a proxy service proceed to Configure Proxy Handling on page 39 Otherwise proceed to Configure IIS Authentication on page 39 3 3 4 Single Sign On Using Impersonation with Kerberos Login System You must modify the web config file to set lt impersonation enabled gt value to true specify lt authentication mode gt as Windows and lt identity impersonate gt to true In order to authenticate to the Spotfire Server you must specify a username and password You enter this information farther down in the web config file in the lt value gt tags for ImpersonationUsername and ImpersonationPassword The account you specify here is the impersonation account you created on the Domain Controller and configured on the Spotfire Server for the Spotfire Web Player to use in connecting to the Spotfire Server Important You must include the domain name when you specify the username in the web config file For example lt setting name ImpersonationUsername serializeAs String gt lt value gt MYDOMAIN user lt value gt lt setting gt lt setting name ImpersonationPassword serializeAs String gt lt value gt pa55w0rd lt value gt Modify the relevant values indicated by bold text in the following code lt spotfire dxp web gt lt setup gt lt ImpersonationUsername and ImpersonationPassword must al
87. ed excluding pings Default is 02 00 00 range is 00 01 00 to Infinite regularPollChangesInterval 500 Specify the base interval in microseconds from when a change is made on the client to when the client polls the server for a status update Default value is 500 range is 200 to 1000 maxPolIChangesInterval 3000 Specify the maximum value in microseconds by which the poll interval in regularPollChangesInterval is increased for each try until this value is reached Default value is 3000 range is 1000 to 10000 pollLoadIinterval 1000 Specify the interval in microseconds between polls when an analysis file is loading Default value is 1000 range is 1000 to 10000 Specify the frequency in seconds with which the client should ping or poll the server to keep the analysis alive Default is 15 range is 10 to 60 toolTipDelay 1000 Specify the length of time in microseconds that the client must wait before requesting a visualization highlighting tooltip from the server Default value is 1000 range is 200 to 3000 TIBCO Spotfire Web Player 7 0 75 129 Advanced Procedures and Technical Reference antiAliasEnabled true Specify if anti aliasing is enabled The default value is true and we recommend that you leave anti aliasing enabled in order to produce visualizations that are clear and sharp All graphics in the Spotfire Web Player are rendered wit
88. ed to decrypt the incoming Kerberos service tickets This is done by setting the configuration parameter useAppPoolCredentials to true for the Spotfire Web Player s web application gt Checking if Kernel Mode Authentication is Enabled 1 Select Start gt Administrative Tools gt Internet Information Services IIS Manager 2 Inthe navigation panel to the left select Server name gt Sites gt Default Web Site gt SpotfireWeb 3 Double click on the Authentication icon under IIS in the main panel 4 Select Windows Authentication in the list 5 Click Advanced Settings in the right hand panel 6 Kernel mode authentication is enabled if the Enable Kernel mode authentication checkbox is selected gt Configuring the Application Pool s Identity to Decrypt Kerberos Tickets 1 Select Start gt Administrative Tools gt Internet Information Services IIS Manager 2 Inthe navigation panel to the left select Server name gt Sites gt Default Web Site gt SpotfireWeb 3 Double click on the Configuration Editor icon under Management in the main panel 4 At the top of the main panel there are two fields called Section and From 5 For Section select system webServer security authentication windowsAuthentication 6 For From select ApplicationHost config lt location path Default Web Site SpotfireWeb gt 7 Inthe properties panel under the two fields set the useAppPoolCredentials property to True and click Apply 8
89. ed update time 15 15 INFO 2014 03 27 15 18 56 842 8068 WorkThresd 67 leifg WAT 52 Spotfire Dxp Web WebAnalysis Opening shareable master document with origin dsta Baseball linked DxpFileFromLibraryy INFO 2014 03 27 15 18 58 574 2068 WorkThresd 67 leifg Spotfire Dxp Web Library ScheduledUpdates Update of data Baseballl linked execution time 00 00 02 1840140 normalized update time 16 18 INFO 2014 03 27 15 21 56 868 8068 WorkThresd 54 leifg WAT 53 Spotfire Dxp Web WebAnalysis Opening shareable master document with origin dsta Baseball linked DxpFileFromLibrary INFO 2014 03 27 15 21 58 646 8068 WorkThresd 54 leifg Spotfire Dxp Web Library ScheduledUpdstes Update of dsts Basebsill linked execution time 00 00 02 2152142 normalized update time 15 21 INFO 2014 03 27 15 24 66 009 8068 WorkThresd 90 leifg WAT 54 Spotfire Dxp Web WebAnslysis Opening shareable master document with origin dsta Baseball linked DxpFileFromLibrary The page shows the log file located at lt Installdir gt Logfiles Spotfire Dxp Web 1log on the web server You can customize the severity of events to be logged by changing the following section in the log4net config file located in the webroot App data directory of the installation lt appender name FileAppender type log4net Appender RollingFileAppender gt lt PreserveLogFileNameExtension value true gt lt file value Logs Spotfire Dxp Web log gt lt app
90. eepAliveMinutes scheduledUpdates externsiUpdstelwebServicelenabled scheduledUpdstes extemsiUpdatelems ensbled scheduledUpdates extemaiUpdate emsiserverUrl scheduledUodstes extemsiUpdate emsitopic scheduledUpdstes externsiUpdstelemsiclientld scheduledUpdstes externsiUpdatelems reconnectAttemptCount scheduledUpdstes externsiUpdatelems reconnectAttemptDelsyMilliseconds scheduledUpdstes externsiUpdatelems reconnectAttemptTimeoutMiilliseconds tion Settings Spotfire Dxp Web Properties Settings appli ScheduledUpdstesUsemame ScheduledUpdstesPassword ScheduledUpdstesCentificsteSerisiNumber EmsUpdateUsemame EmsUpdatePassword ImpersonationUsemsme ImpersonstionPsssword ImpersonationCertificateSerialNumber ProxyUsemsme ProxyPassword 123 Web Server Web Application Loaded Assemblies Site Scheduled Updates Web Server Log True spotfireadmin example com 1000 en US Ittpiref arch srv2 spotfireref local 8060 False False TrustedPeople LocslMschine True False ScheduledUpdstes App_Dsta ScheduledUpdates xml True 2 10 False False REF ARCH SRV7 10 1000 1000 leitg Loaded Assemblies This tab displays information about the assemblies that are loaded by the web application Web Player Monitoring Spotfire Server Accessibility ni dll 4 0 30319 18403 ACTIVEDS dil 6 1 7600 16285 sdsidpe dil 6 1 7600 16385 ADVAPI32 dil 6 1 7601 18247 antirruntime dil 2 7 7 1 antir runtime Version
91. eference lt parameter gt lt parameterName value timeStamp gt lt dbType value String gt lt size value 50 gt lt layout type log4net Layout PatternLayout gt lt conversionPattern value Sproperty timeStamp gt lt layout gt lt parameter gt lt parameter gt lt parameterName value hostName gt lt dbType value String gt lt size value 50 gt lt layout type log4net Layout PatternLayout gt lt conversionPattern value property hostName gt lt layout gt lt parameter gt lt parameter gt lt parameterName value sessionId gt lt dbType value String gt lt size value 50 gt lt layout type log4net Layout PatternLayout gt lt conversionPattern value property sessionId gt lt layout gt lt parameter gt lt parameter gt lt parameterName value ipAddress gt lt dbType value String gt lt size value 50 gt lt layout type log4net Layout PatternLayout gt lt conversionPattern value property ipAddress gt lt layout gt lt parameter gt lt parameter gt lt parameterName value userName gt lt dbType value String gt lt size value 50 gt lt layout type log4net Layout PatternLayout gt lt conversionPattern value property userName gt lt layout gt lt parameter gt lt parameter gt lt parameterName value operation gt lt dbType value String gt lt size value 50 gt lt layout type l
92. endToFile value true gt lt rollingStyle value Size gt lt maxSizeRollBackups value 4 gt lt maximumFileSize value 500MB gt lt staticLogFileName value false gt lt layout type log4net Layout PatternLayout gt lt conversionPattern value 5level date Sproperty pid Sthread Sproperty user tlogger message newline gt lt layout gt lt filter type log4net Filter LoggerMatchFilter gt lt param name AcceptOnMatch value false gt lt param name LoggerToMatch value WebLogger gt lt filter gt lt filter type log4net Filter LevelRangeFilter gt lt levelMin value INFO gt lt acceptOnMatch value true gt lt filter gt lt appender gt 114 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference lt appender name FileAppenderDebug type log4net Appender RollingFileAppender gt lt PreserveLogFileNameExtension value true gt lt file value Logs Spotfire Dxp Web Debug log gt lt appendToFile value true gt lt rollingStyle value Size gt lt maxSizeRollBackups value 10 gt lt maximumFileSize value 500MB gt lt staticLogFileName value false gt lt layout type log4net Layout PatternLayout gt lt conversionPattern value 5level Sdate Sproperty pid Sthread property user tlogger Smessagesnewline gt lt layout gt
93. er you specified for Impersonation ImpersonationPassword Enter this information in the lt value gt tags Note If you have configured the Spotfire Web Player to use Client Certificate authentication this value should be left empty To specify a scheduled update user with client certificates see Client Certificate on page 37 To encrypt this credential see Encrypt Usernames and Passwords on page 102 92 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference EmsUpdateUsername The name of the user that will be used to access the EMS server Enter this information in the lt value gt tags Pmsypdatepassword The password for the user that will be used to access the EMS server Enter this information in the lt value gt tags 6 6 1 2 Configure the Update Schedule To set scheduled updates for different analyses use the Update Schedule dialog in the library To be able to configure scheduled updates for different analyses the user must be a member of the group Administrator or the group Web Player Administrator on the server Make sure that the user has the necessary access rights to the appropriate library items Note Setting up scheduled updates using the dialog in the library will overwrite locally stored ScheduledUpdates xm1 files The only way to upload locally stored scheduled updates is to save the xml file in a separate location before i
94. erface The section starts with an example of a configuration file web config followed by a table with an explanation of each setting lt spotfire dxp web gt 66 129 TIBCO Spotfire Web Player 7 0 o Oo amp Advanced Procedures and Technical Reference lt kkkkkxkxkxkxkxkxkkxkkxkxkxkxkxkxkkkxkkkkxkxkkxkkkkkxkxkxkxkxkxkkkxkkxkxkxkxkkkkkkkkkxkkkxk Web Player settings for non visible items gt lt setup gt lt Set to true to enable the client Java Script API gt lt javaScriptApi enabled false gt lt The mailto link on the error page will use the email address below You can also set the maximum length of the email gt lt errorReporting emailAddress spotfireadmin yourcompany com maxMailLength 1000 automaticallyShutDownAfterStartupFailureAfterMinutes 5 gt lt authentication serverUrl http spotserver enableAutocomplete false gt lt loginServic nabled true loginRequireSsl false gt lt authentication gt lt application redirectToEmptyPageOnSessionEnd true gt lt setup gt lt l KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKK KEK This section contains settings for the user interface of the Web Player gt lt useriInterface gt lt pages showLogout true showAbout true showHelp true showUserName true gt lt diagnostics errorLogMaxLines 2000 gt lt analysis showToolTip tr
95. erprise Message Service and details on the following settings please refer to the TIBCO Enterprise Message Service User s Manual S_ ServerUrl za The URL and if applicable the port to the EMS server za S_Topic The topic that the EMS durable subscriber should listen to EMS UserName The name of the user that will be used to access the EMS server EMS Password The password of the user that will be used to access the EMS server EMS Reconnect AttemptCount The number of reconnect attempts to be made if a connect fails By default this value is 10 EMS Reconnect AttemptDelay illiseconds The delay for the reconnect attempts By default this value is 1000 milliseconds EMS Reconnect AttemptTimeout illiseconds The timeout for the reconnect attempts By default this value is 1000 milliseconds Pilesppender The path to the directory where the log file for the keep alive service will be stored Now that the Spotfire Dxp Web KeepAliv you can start the Keep Alive service exe config file has been configured Note If you make any changes to the configuration file later you must restart the service for them to take effect gt Starting the Keep Alive Service 1 Select Start gt Administrative Tools gt Services 2 Double click on the service TIBCO Spotfire Web Player Keep Alive Service TIBCO Spotfire Web Player 7
96. erties To extract all information to a log file the default format message is used However for most log files it is also possible to specify which properties to write to the log files This is especially important if you log to a database instead of a log file as this makes it easier to get the properties in separate columns in the database 118 129 TIBCO Spotfire Web Player 7 0 General Properties Advanced Procedures and Technical Reference These properties are logged for all log files Property Description hostName The server computer name timeStamp The event timestamp instanceld The unique ID of the running web player instance AuditLog Properties Default level INFO Property Description sessionId The ASP NET session ID ipAddress The IP Address of the web client userName The username of the logged on client operation The audit operation for example Login analysisId The document id GUID of the currently open document argument An argument for the operation for example the path of the analysis status Failure or Success TimingLog Properties Default level INFO Property Description endTime The time the event ends duration The duration of the event sessionId The ASP NET session ID ipAddress The IP Address of the web client userName The username of the logged on client operation The audit operation
97. file for how users will connect to the external data sources TIBCO Spotfire Web Player 7 0 81 129 Advanced Procedures and Technical Reference Locate the section below and enter information on the authentication method for each connector used If the connector is not listed in the lt adapters gt section add it using the format seen below where MyAdapter is replaced with the name of the connector For information on the naming of the connectors see the TIBCO Spotfire Connectors Installation Manual lt Spotfire Dxp Data Access Adapters Settings gt lt l Different authentication modes can be set up for the various data sources Valid modes are WebConfig To connect with credentials stored in Spotfire Dxp Web Properties Settings DataAdapterCredentials below Kerberos To connect using Kerberos authentication Prompt To prompt the user for credentials ServiceAccount To connect as the account used to run the application pool in the IIS gt lt setting name WebAuthenticationMode serializeAs Xm1 gt lt value gt lt adapters gt lt adapter name Spotfire MyAdapter mode Prompt gt lt adapters gt lt value gt lt setting gt lt Spotfire Dxp Data Access Adapters Settings gt There are four authentication alternatives for each connector The authentication methods will differ depending on if the analysis was set up using Windows Authentication or Database Authentication Note All authentica
98. fire Library TIBCO Spotfire Web Player 7 0 57 129 Upgrading 4 4 1 Upgrading Upgrading to New Version Upgrading from TIBCO Spotfire Web Player 6 5 or earlier to TIBCO Spotfire Web Player 7 0 basically consists of uninstalling the previous version and then installing the most recent version Performing an upgrade is therefore almost identical to performing a new installation as described in the chapter Install Spotfire Web Player on page 27 The new version 7 0 installer will first uninstall the old version of the software and then install the new version Therefore it is important to make backups of files you want to reapply settings from However there are manual steps which you must perform to make sure authentication is configured in the same way as on your previous version If you have custom extensions to the Spotfire Web Player these will need to be redeployed on the new version as well Upgrading the Spotfire Web Player These steps explain the basic workflow you must perform to upgrade the Spotfire Web Player However when performing Step 2 to Step 8 you should read the instructions in the chapter Install Spotfire Web Player on page 27 Make a backup of your old installation directory This is likely to be located in a default directory such as C Program Files Tibco Spotfire Web Player 6 5 Note This will contain your web config file and other important files needed for the upgrade
99. for this alternative are TIBCO Spotfire Web Player 7 0 13 129 Pre Installation Planning e On the Domain Controller you must configure Delegation for the computer account or dedicated user account that is used to run the application pool in IIS on the Spotfire Web Player An administrator on the Domain Controller must complete this requirement e The Spotfire Server must use Kerberos Login System e A member of the Account Operators or Administrators domain groups must use the Windows Support Tools typically installed on one of the domain controllers to configure m The Service Principal Names SPNs for the Spotfire Server m A keytab file for the Spotfire Server Note You could create a potential security issue when you enable Unconstrained Delegation for the Spotfire Web Player account either computer account or dedicated user account because the change has an impact on all of the services running on the Spotfire Web Player computer or under that dedicated user account An alternative if it is supported by the Domain Controller is to use the more secure Constrained Delegation If it is not possible to complete the requirements in this section you should use one of the Impersonation alternatives instead More information about keytab files and Kerberos on the Spotfire Server refer to the TIBCO Spotfire Server Installation and Configuration Manual 1 4 4 Client Certificate With this option users who acces
100. g WAT 48 Spotfire Oxp Web WebAnslysis Opening shareable master document with origin idata Baseball linked DxpFileFromLibrary INFO 2014 03 27 15 06 58 458 8068 WorkThresd 22 leifg Spotfire Oxp Web Library ScheduledUpdates Update of dsta Bsseball linked execution time 00 00 02 2308143 normalized update time 15 06 INFO 2014 03 27 15 09 56 721 8068 WorkThresd 81 leifg WAT 46 Spotfire Oxp Web WebAnslysis Opening shareable master document with origin idata Baseball linked DxpFileFromLibraryy INFO 2014 03 27 15 09 58 405 8068 WorkThresd 81 leifg Spotfire Dxp Web Library ScheduledUpdates Update of dsta Basebsll linked execution time 00 00 02 1372137 normalized update time 15 09 INFO 2014 03 27 15 12 56 761 8068 WorkThresd 24 leifg WAT 50 Spotfire Oxp Web WebAnslysis Opening shareable master document with origin idata Baseball linked DxpFileFromLibrary INFO 2014 03 27 15 12 58 640 8068 WorkThresd 34 leifg Spotfire Oxp Web Library ScheduledUpdates Update of dsta Basebsll linked execution time 00 00 02 2308143 normalized update time 15 12 INFO 2014 03 27 15 15 56 802 8068 WorkThresd 22 leifg WAT 51 Spotfire Dxp Web WebAnalysis Opening shareable master document with origin dsta Baseball linked DxpFileFromLibraryy INFO 2014 03 27 15 15 58 649 2068 WorkThread 22 leifg Spotfire Oxp Web Library ScheduledUpdates Update of dsta Basebsll linked execution time 00 00 02 1996141 normaliz
101. ge data table Set up Scheduled Updates There are three steps to setting up scheduled updates These will be explained in more detail below If you want to upgrade an earlier version of an existing schedule see Upgrade an Existing Schedule on page 98 gt Setting up Schedules Updates 1 Edit Web config 2 Configure the Update Schedule 3 Configure and Start the Keep Alive service 6 6 1 1 Edit the Configuration File The first thing to do is to enable scheduled updates and disable library caching in the configuration file There are also a few settings you can modify to configure how you want scheduled updates to work in your environment Use an XML editor to open the web config file from the webroot directory for example C Program Files Tibco Spotfire Web Player 7 0 webroot Web config Note We recommend that you use an XML editor when you modify XML files An XML editor has features to provide a clear view of the XML code and some text editors corrupt configuration files Example 88 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference lt configuration gt lt spotfire dxp web gt lt setup gt lt scheduledUpdates nabled true useLibrary true libraryFileName ScheduledUpdates settingsFile App Data ScheduledUpdates xml concurrentUpdates 2 updateIntervalSeconds 60 lt forcedUpdat nabled true maximumRejectedUpdates 2 gt lt externalUpdate keepAliveMinutes
102. gether with a Spotfire analysis file used to analyze them Export the monitoring analysis file without the logs Use this if the logs have been copied in another way 110 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference 6 12 2 Spotfire Server This tab displays information about the Spotfire Server Web Player Monitoring Spotfire Server Server Web Server Web Application Loaded Assemblies Site Scheduled Updates Web Server Log Server URL htto l ref srch srv2 spotfireref locsl 8060 Authentication Basic Allow Remember Me True OS Name Windows Server 2008 OS Version 6 0 System Type amd84 Server Locsie en_US Java Vendor Oracle Corporation Java Version 1 7 0_45 Database Driver Microsoft JDBC Driver 4 0 for SQL Server 4 0 2208 100 Database Version Microsoft SQL Server 11 00 2100 Application Server Apache Tomesti7 0 42 Server Version 28 0 0 310 Server jar IS 28 0 0 310 Serverjar JAAS 28 0 0 310 Server jar Library 28 0 0 310 Serverjar server 28 0 0 310 Server jar WSP 6 12 3 Web Server This tab displays information about the web server environment Web Player Monitoring Spotfire Server Web Application Loaded Assemblies Site Scheduled Updates Web Server Log Product Version 14 2 7421 5453 OS Name Microsoft Windows NT 6 1 7601 Service Pack 1 OS Version Microsoft Windows NT 6 1 7601 Service Pack 1 System Type x04 NET Version 4 0 20319 18444 Authentication
103. h anti aliasing enabled However anti aliasing does impose a slight performance impact The performance impact may become noticeable for visualizations that consist of a very large amount of graphical objects If you encounter this rare situation you can set this value to false useClearType true Specify if ClearType is enabled The default value is true and we recommend that you leave ClearType enabled in order to produce clear and sharp text in visualizations All graphics in the Spotfire Web Player are rendered with ClearType enabled However ClearType does impose a slight performance impact The performance impact may become noticeable for certain visualizations If your performance is in question you can disable ClearType by setting this value to false documentStateEnabled true Specifies that the state of files is maintained between sessions If this value is set to true when users resume working on a file the file will be in the state in which that user left the file undoRedoEnabled true Specify if the Undo and Redo functionality is enabled userServicesPoolEnabled true Specify if the user services pool should be enabled Enabling the user services pool reduces the number of web service calls to the server because only one set of user services such as preferences and licenses is created for each user This is especially useful if the users are logged in
104. he just created The analyst wants to make sure this analysis is preloaded each morning when the sales department comes to work and starts their day by checking the results from the previous day The administrator configures the TIBCO Spotfire Web Player He adds the analysis file to the list of analyses to be scheduled for updates He sets it to be automatically loaded at 4 am in the morning since he knows the database will be updated at midnight This should be enough time to get the analysis loaded in memory before people come to work and attempt to open the analysis He also determines that it should be continually kept in memory for the remainder of the working day until 8 pm The administrator also needs to specify a user that will automatically log into the TIBCO Spotfire Server and access the Spotfire Library in order to preload the analysis Technically this user needs access to the file and any other that is scheduled for updates However the administrator is careful to pick a user account whose user rights are as limited as possible see also Concerning Prompted and Personalized Information Links below The administrator tells the analyst that the analysis is now scheduled for updates as requested The analyst sends an e mail to the sales department with the URL to the new analysis and tells them that from now on they can check the sales figures from the previous day by clicking the link At midnight the company database is u
105. heir Windows credentials As long as the users connect to the Spotfire Web Player from the appropriate Windows Domain and the Spotfire Server is already be configured with the same authentication type users will not have to supply their credentials again Note In this alternative when you configure the Spotfire Web Player authentication method to use one of the impersonation authentication methods you can configure the Spotfire Server to use any authentication method If you are not using impersonation the only single sign on method that can work for both the Spotfire Server and the Spotfire Web Player is delegated Kerberos Component Setting IIS Integrated Windows Authentication ASP NET Windows Spotfire Server NTLM Kerberos or Basic e Client Certificate users who connect to the Spotfire Web Player are authenticated using client certificates Component Setting IIs Anonymous ASP NET None Spotfire Server Client Certificate TIBCO Spotfire Web Player 7 0 9 129 Pre Installation Planning 1 4 1 1 4 2 1 4 3 These authentication alternatives are described in more detail below and the procedures required to configure the alternatives are described in the chapter Install Spotfire Web Player on page 27 Username and Password This is the default authentication configured during the Spotfire Web Player installation If you select this alternative no post installation authentication configuration is re
106. ializeAs String gt lt value gt ProxyPassword lt value gt lt setting gt lt setting name Certificate Enabled serializeAs String gt lt value gt False lt value gt lt setting gt lt setting name Certificate StoreName serializeAs String gt lt value gt My lt value gt lt setting gt lt setting name Certificate StoreLocation serializeAs String gt lt value gt CurrentUser lt value gt lt setting gt lt setting name Certificate SerialNumber serializeAs String gt lt value gt 00BDFB57D2A172B66E lt value gt lt setting gt lt Spotfire Dxp Web UpgradeTool Properties Settings gt lt Spotfire Dxp Internal Properties Settings gt lt setting name ManifestDownloadTimeoutMilliseconds serializeAs String gt lt value gt 60000 lt value gt lt setting gt lt Spotfire Dxp Internal Properties Settings gt lt applicationSettings gt 60 129 TIBCO Spotfire Web Player 7 0 Upgrading Key Description Credentials Enabled Set to true if you use Username Password authentication If you use Single Sign On set this to false and make sure that you run the batch file as a user with the proper permissions for the Spotfire Server Note It is possible to encrypt the information in this configuration file you do this by running the file Spotfire Dxp Web UpgradeTool exe also located in the Tools directory in the command prompt with the flag protectSettings after you ve modif
107. ied the configuration file Then you run the batch file as described below To remove the encryption run the exe file with the flag unprotectSettings in the command prompt Enter this information in the lt value gt tags Credentials Username Credentials Password Specify the username to log into the Spotfire Server Enter this information in the lt value gt tags Specify the password to log into the Spotfire Server Enter this information in the lt value gt tags Helse PATH The path of the webroot directory of the installation This is set automatically when installing Enter this information in the lt value gt tags ServerArea The server area Default value Production Other valid values Test Enter this information in the lt value gt tags Proxy Enabled Set to true if you use proxy handling for communication to the Spotfire Server and need to provide a username and password for the proxy Enter this information in the lt value gt tags Proxy Username Specify the username for the proxy server if needed Enter this information in the lt value gt tags Proxy Password Specify the password for the proxy server if needed Enter this information in the lt value gt tags TIBCO Spotfire Web Player 7 0 61 129 Upgrading Certificate Enabled Set this to true if the Spotfire Server requires Client Certificate authentication For more i
108. ing 2009 Sales Data for Q2 Send an email to notify users about the analysis Send Email Beha In order for this information to appear on the Save as Library Item page you must set a Group Preference containing the Spotfire Web Player URL We recommend that you set this preference for the Everyone group That way all Spotfire users will see the URL when publishing files to the Spotfire Library Setting the URL Preference Start TIBCO Spotfire Log in as an administrator Select Tools gt Administration Manager Select the Preferences tab 56 129 TIBCO Spotfire Web Player 7 0 Install Spotfire Web Player 5 Select the Everyone group in the list Click the Edit button nN aD Expand the Application node and select ApplicationPreferences 8 Click in the text field for DXPLibraryWebURL and enter the URL of the Spotfire Web Player Edit Preferences Xi Group Name Everyone Application DxpLibranWebURL http Spotserver Spotfireveb ApplicationPreferences Language Default BarChart RequireLoginE veryND ays BoxPlot ShowWelcomeScreen CrossT able ToolBars LineChart MapChart ParallelCoordinatePlot PieChart ScatterPlot SummaryT able Table Visualization 9 Click OK 10 Click Close to exit the Administration Manager 11 All users should now see the URL of their analysis when saving to the Spot
109. ingFileAppender ue C Program Files TIBCO Spotfire Web Player 7 0 s Spotfire Dxp Web KeepAlive log Most of the information in this configuration file has already been filled in automatically during installation However you should verify that the information is correct and as desired Enter the information in the lt value gt tags Depending on the type of authentication you have configured for your Spotfire Web Player you must also configure the WindowsUserName and WindowsPassword attributes accordingly see below Key Description Settings FilePath The path to the ScheduledUpdates xml file This is by default the webroot directory of the Spotfire Web Player server 96 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference PingIntervalMinute s This setting determines how often the Spotfire Web Player should be pinged Do not set this to more than half the time of the IdleTime out settings of the Spotfire application pool in IIS Specify this in minutes Den oM See ans Leave this value empty Windows Passrorg Leave this value empty i The URL to the KeepAlive ashx file on the Spotfire Web Player server that you want to keep alive Most often this is localhost EMS Enabled The value should be t rue if updates triggered by a message sent from TIBCO Enterprise Message Service is enabled Note For information on TIBCO Ent
110. is enabled The default setting is enabled true which is required for Spotfire on the iPad and other integrating products Note If https is used on the server we recommend that you enable the loginRequireSs1 attribute to force integrating products to use ssl lt application redirectToEmptyPageOnSessionEnd t rue gt If set to true the user will be redirected from the library to an empty page after session timeout default 20 minutes This is to avoid unauthorized browsing of the library If the user is working with an analysis in another tab of the browser only the tab with the library will be redirected and the user will not be logged out Default value is true 6 2 2 Position User Interface Element The following table contains details about the tags and attributes along with the values that you can modify in the lt userInterface gt element of the configuration file This section corresponds to the part of the configuration file labeled 5 in the previous code sample Tag with default value Explanation 5 lt pages showLogout true gt Specify if the Log out menu item is displayed If true the menu item is displayed in the top right menu of the Spotfire Web Player lt pages showAbout true gt Specify if the About Spotfire Web Player menu item is displayed If true the menu item is displayed in the top right menu of the Spotfire Web Player lt
111. ished the web player is accessed from http s lt server name gt port lt virtual directory gt The application will run in the application pool TIBCO Spotfire Web Player Pool The application pool is connected to NET CLR version v4 0 30319 and is using integrated managed pipeline mode Note This must not be changed The application pool runs as the NETWORK SERVICE account NETWORK SERVICE has read write and delete access to the Logs and Temp folders in the installation directory Configure ASP NET Authentication To configure the authentication used by the ASP NET layer you must edit the Spotfire Web Player configuration file The exception is if you are using Username and Password authentication in this case you do not need to edit the configuration file The Spotfire Web Player configuration file web config is in the webroot directory for example C Program Files Tibco Spotfire Web Player 7 0 webroot Web config Note We recommend that you use an XML editor when you modify XML files An XML editor has features to provide a clear view of the XML code and some text editors corrupt configuration files You can modify the configuration file so that the ASP NET layer uses one of the following authentication alternatives Each option is described in Authentication Alternatives on page 8 and you should decide on which authentication alternative to use before proceeding e Username and Password on page 29 e
112. isting in the library Therefore always keep a backup of the file Use the Update Schedule dialog in the library to make changes to the scheduled updates Cache and Preload SBDF Files In order to quickly create and share map chart visualizations that uses geocoding tables and to quickly open SBDF files from the library it is possible to cache and preload the SBDF files stored in the library The cache is an in memory cache that keeps recently opened SBDF files from the library open If files have not been accessed for a specified time or if memory is low they will be removed from memory The SBDF cache settings are configured in the web config file 98 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference lt sbdfCach nabled true cacheTimeoutMinutes 30 gt lt preloadSettings enabled true libraryCheckIntervalMinutes 10 librarySearch MapChart IsGeocodingTable true AND MapChart IsGeocodingEnabled true gt lt preloadSettings gt lt sbdfCache gt Key Description sbdfCache enabteg Set to true to enable the cache a Specify the minimum time an SBDF file is stored in the cache If the preload service is used this should be a bit longer than the libraryCheckInterval setting preloadSettings naples Set to true to enable the preload service of SBDF files Note The cache must be enabled for the preload service to work libraryCheck 5
113. just use the minimumAvailableMb setting Note Analyses opened by Scheduled Updates will not be counted towards this limit When you have completed modifying the web config file you should save the file The resource monitoring changes take effect as soon as you save the file Logging To help you determine the threshold values you can enable the Spotfire Web Player log to state the actual performance values that the settings are compared against This is done by first enabling siteLimitations in the Spotfire Web Player configuration file web config and then adding the lt SiteResourceMonitor gt element below to the log4net config file It is located in the webroot App_ data directory of the installation TIBCO Spotfire Web Player 7 0 101 129 Advanced Procedures and Technical Reference 6 9 lt logger name Spotfire Dxp Web SiteResourceMonitor gt lt level value DEBUG gt lt logger gt The Spotfire Web Player log will then add an entry to the log every time a user opens an analysis This can be viewed by opening the log file or viewing it in the diagnostics page Customize the Server Unavailable Page When a user who attempts to open an analysis is denied the ability to do so a web page will be displayed stating that the Server has reached maximum number of open analyses Please try again later You can replace this text with your own custom HTML snippet Create a file named ServerU
114. lable Note The dedicated user account does not need to have Delegation user rights Create an Impersonation Account on the Spotfire Server or LDAP Server Follow the instructions in the TIBCO Spotfire Server Installation and Configuration Manual to set this up e Ifthe Spotfire Server has been configured to use Database login system the same impersonation username must be present in the Spotfire Server Database e Ifthe Spotfire Server has been configured to use LDAP login system the same impersonation username must be present on the LDAP Server TIBCO Spotfire Web Player 7 0 53 129 Install Spotfire Web Player 3 6 5 3 6 5 1 any aD 3 7 e The Impersonation username must also be configured for impersonation on the Spotfire Server Proceed to Deploy Web Packages to Spotfire Server on page 54 Client Certificate For the web application to be able to access the impersonation certificate and if applicable the scheduled update certificate the account running the application pool for example NETWORK SERVICE must be given reading permissions for the certificates Change the Access Rights Modifying access rights on Windows Server 2008 R2 and Windows Server 2012 is completed using the Microsoft Management Console Changing the Access Rights Start the Microsoft Management Console For the Local Computer add the Certificates snap in Select Certificates Local Computer gt Personal gt Cer
115. llation on page 63 128 129 TIBCO Spotfire Web Player 7 0 Uninstall T Uninstall 7 1 Stopping the Application Pool Before uninstalling TIBCO Spotfire Web Player it is important to stop the application pool for the Spotfire Web Player in HS This is done to make sure that no instances of the Spotfire Web Player are running when you uninstall it gt To Stop the Application Pool 1 Select Start gt Administrative Tools gt Internet Information Services IIS Manager 2 Select Local computer gt Application Pools 3 Select TIBCO Spotfire Web Player Pool 4 Click Stop 7 2 Spotfire Web Player Software Uninstall To uninstall TIBCO Spotfire Web Player go to Programs and Features in the Control Panel and uninstall TIBCO Spotfire Web Player Note Some temporary files and log files may still exist in the installation directory by default c Program Files TIBCO Spotfire Web Player 7 0 Simply delete them after uninstalling the Spotfire Web Player TIBCO Spotfire Web Player 7 0 129 129
116. ller You should log on to the Domain Controller and create or verify that the dedicated user account you intend to use is available If you want to limit the number of computers this impersonation account can log in to you must give the account the user rights to log in to the service account for the computer running the Spotfire Server Note The dedicated user account does not need to have Delegation user rights Set up NTLM on the Spotfire Server Follow the instructions in the TIBCO Spotfire Server Installation and Configuration Manual to set this up e The Spotfire Server needs to be configured to support NTLM authentication e The Impersonation username specified on the Domain Controller must also be configured for impersonation on the Spotfire Server Spotfire Web Player Server Requirements You must configure these settings on the Spotfire Web Player server Under Control Panel gt Network and Internet gt Internet Options gt Advanced select Enable Integrated Windows Authentication Requires Restart The TIBCO Spotfire Server you are connecting to must be located in the Intranet security zone Internet Explorer Client Requirements You must configure these settings on every end user computer Under Tools gt Internet Options gt Advanced select Enable Integrated Windows Authentication Requires Restart The Spotfire Web Player server you are connecting to must be located in the Intranet security zone
117. lt setup gt lt system web gt lt identity impersonate true gt lt authentication mode Windows gt lt authentication gt lt authorization gt lt deny users gt lt allow users gt lt authorization gt lt applicationSettings gt lt Spotfire Dxp Web Properties Settings gt lt Impersonation This is the username and password used for impersonation gt lt setting name ImpersonationUsername serializeAs String gt lt value gt MYDOMAIN user lt value gt lt setting gt lt setting name ImpersonationPassword serializeAs String gt lt value gt pa55w0rd lt value gt lt setting gt lt Spotfire Dxp Web Properties Settings gt lt applicationSettings gt When you have completed the changes save the file Note If ASP NET Impersonation was enabled for the Spotfire Web Player in the IIS management console there may be a duplicate lt identity impersonate true gt element in web config This duplicate setting may prevent Spotfire Web Player from working Important To be safe you should create a backup copy of web config and store it in a reliable location You might need the information later TIBCO Spotfire Web Player 7 0 35 129 Install Spotfire Web Player 3 3 6 If your environment requires a proxy service proceed to Configure Proxy Handling on page 39 Otherwise proceed to Configure IIS Authentication on page 39 Single Sign On Using Impe
118. luates the zone of a resource see the Microsoft knowledge base article KB 258063 Google Chrome Client Requirements You must launch Google Chrome with the following parameters e auth server whitelist e auth negotiate delegate whitelist For example chrome ex auth server whitelist domain com auth negotiate delegate whitelist domain com Where domain com is the URL to the Spotfire Web Player server You can enter the URL with a preceding wildcard character to enable Google Chrome to connect to any URL that ends in domain com For more information see the Chromium Projects developer page at http www chromium org developers design documents http authentication Mozilla Firefox Client Requirements You must configure these settings on every end user computer 1 Inthe Firefox browser address box type about config TIBCO Spotfire Web Player 7 0 51 129 Install Spotfire Web Player 2 For the following parameters set the values to the Spotfire Web Player URL for which 3 6 3 you want to activate Negotiate e network negotiate auth delegation uris e network negotiate auth trusted uris Proceed to Deploy Web Packages to Spotfire Server on page 54 Single Sign On Using Impersonation with NTLM Login System Create an Impersonation Account on the Domain Controller The dedicated user account you intend to use for Impersonation must be present on the Domain Contro
119. lysis in the desktop client to find out which pages or plots that use most of the resources Open the analysis in the desktop client and go to Help gt Support Diagnostics and Logging gt Diagnostics Information to get detailed resource usage information Temporarily removing pages plots or tables may give some more hints e Ifthe data table size is big it is the raw data that is the problem Are there tables or columns that are not used Otherwise more RAM is needed e Ifthe data view size is high or it seems like the number of document nodes is high the found analyses might be too complicated Note that unused columns pages and plots will generate more document nodes 6 12 1 3 Logging This tab allows you to enable the monitoring logging and to export the results of the logging as files and as analyses files Web Player Monitoring Spotfire Server Web Server Web Application Loaded Assemblies Site Scheduled Updates Web Server Log Open Analyses Logging Currently On Enable Monitoring Logging Restore Monitoring Logging Export Monitoring Logs and Analysis Export Monitoring Analysis Option Enable Monitoring Logging Restore Monitoring Logging Export Monitoring Logs and Analysis Export Monitoring Analysis Description Start logging to the logs needed for the monitoring analysis on debug level Restore logging levels to what is specified in the log4net config file Export a snapshot of the log files to
120. mation to help you decide which approach to use to meet your security and usability requirements Spotfire Web Player Server ASP NET Spotfire Spotfire Server ae You configure the security on each of these three components in a specific way to determine how the overall Spotfire Web Player authentication works The most common alternatives are e Username amp Password users who connect to the Spotfire Web Player are prompted to enter a username and password Their credentials are verified against the Spotfire Server which can be configured in various ways for example LDAP Database or Windows NT Domain This is the default 8 129 TIBCO Spotfire Web Player 7 0 Pre Installation Planning authentication alternative for Spotfire Web Player If you select this alternative no post installation authentication configuration is required Component Setting IIs Anonymous and Forms ASP NET Forms Authentication Spotfire Server Basic Authentication e Anonymous Access users who connect to the Spotfire Web Player are logged in automatically using preconfigured credentials that you specify when you configure the ASP NET component These credentials are used for all users to access the Spotfire Server Component Setting IIs Anonymous ASP NET None Preset User Password Spotfire Server Basic Authentication e Single Sign On users who connect to the Spotfire Web Player are automatically authenticated using t
121. milliseconds depending on type 6 13 2 2 Log to Database Example This example shows how to log the AuditLog to a database The connectionString should specify a database that contains a table with columns that match the SQL statement specified in commandText For the other logs replace the relevant properties names and settings lt Audit log appender to database gt lt appender name AuditLogAdoNetAppender type log4net Appender AdoNetAppender gt lt bufferSize value 1 gt lt connectionType value System Data SqlClient SqlConnection System Data Version 1 0 3300 0 Culture neutral PublicKeyToken b77a5c561934e089 gt lt connectionString value Data Source db_ server Initial Catalog spotfire logging User ID spotfire Password spotfire gt lt commandText value INSERT INTO AuditLog Webserver hostName level sessionId ipAddress userName operation analysisId argument status timeStamp VALUES hostName level sessionId ipAddress userName operation analysisId argument status timeStamp Gl gt lt parameter gt lt parameterName value level gt lt dbType value String gt lt size value 10 gt lt layout type log4net Layout PatternLayout gt lt conversionPattern value Slevel gt lt layout gt lt parameter gt 122 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical R
122. n is handled by the application you should set to allow all users lt allow users gt Now remove the lt deny users gt line You must specify the serial number of the certificate to be used for the impersonation and if applicable for scheduled updates Enter this information farther down in the web config file in the lt value gt tags The serial numbers can be found by double clicking on the certificate in the Microsoft Management Console Note If you copy the serial number from the certificate dialog you must remove any spaces Note The impersonation certificate and the scheduled update certificate should be installed in the Personal directory in the Local Computer certificate store Modify the relevant values indicated by bold text in the following code lt spotfire dxp web gt lt setup gt ae ImpersonationUsername and ImpersonationPassword TIBCO Spotfire Web Player 7 0 37 129 Install Spotfire Web Player Soe gt lt setting or ImpersonationCertificateSerialNumber gt lt bos must also be set to enable impersonation gt lt impersonation enabled true gt lt ImpersonationCertificateSerialNumber must also be set gt lt certificates useCertificates true storeName My storeLocation LocalMachine gt lt authentication gt lt system web gt lt authentication mode None gt lt authentication gt lt authorization gt lt allow users g
123. n page 39 Otherwise proceed to Configure IIS Authentication on page 39 Single Sign On Using Impersonation with NTLM Login System You must modify the web config file to set lt impersonation enabled gt value to true specify lt authentication mode gt as Windows and lt identity impersonate gt to true In order to authenticate to the Spotfire Server you must specify a username and password You enter this information farther down in the web config file in the lt value gt tags for ImpersonationUsername and ImpersonationPassword The account you specify here is the impersonation account you created on the Domain Controller and configured on the Spotfire Server for the Spotfire Web Player to use in connecting to the Spotfire Server Important You must include the Domain name when you specify the username in the web config file For example 34 129 TIBCO Spotfire Web Player 7 0 Install Spotfire Web Player lt setting name ImpersonationUsername serializeAs String gt lt value gt MYDOMAIN user lt value gt lt setting gt lt setting name ImpersonationPassword serializeAs String gt lt value gt pa55w0rd lt value gt Modify the relevant values indicated by bold text in the following code lt spotfire dxp web gt lt setup gt lt ImpersonationUsername and ImpersonationPassword must also be set to enable impersonation gt lt impersonation enabled true gt lt authentication gt
124. n the analysis then the username and password specified in the DataAdapterCredentials section will be used If WebConfig was specified above you must specify the username and password for a credentials profile in the DataAdapterCredentials section in the web config file shown below You can add multiple profiles with different credentials Se Credentials for the data adapters Each entry within the setting value credentials section should be in this format lt entry profile profile name gt lt username gt user lt username gt lt password gt password lt password gt lt entry gt For integrated security the username should be in the DOMAIN user format The profile is an arbitrary string To use the credentials in an analysis enter the same profile in the credentials tab of the data connection properties dialog in TIBCO Spotfire gt lt setting name DataAdapterCredentials serializeAs Xm1 gt lt value gt lt credentials gt lt credentials gt lt value gt lt setting gt The credentials profile is used to connect a username and password for an external data source to a specific analysis file without storing the actual username and password in the analysis The name of the profile is specified in the web config section above and in the analysis file To specify which profile to use for a connection in an analysis save the profile name in the Data Connection Properties dialog in TIBCO Spotfire
125. nabled true ervicesPoolEnabled true users maxRe nder imeMs 60000 maxAnalysisShutdownInformations 1024 userPreferencesMaxAge 00 05 00 gt lt hierarchicalClustering maxInteractiveElements 2000 maxElements 30000 maxInteractiveJobs 2 cpuFactorInteractiveJobs 0 8 cpuFactorLargeJobs 0 5 nativeMemory 500 gt lt performance gt lt spotfire dxp web gt lt Settings for the communication with the TIBCO Spotfire Server x x gt lt Spotfire Dxp Services Settings gt lt Cookies from the TIBCO Spotfire Server that should be sent back on all requests gt lt a separated list example ARRAffinity myCookie myCookie2 gt lt cookies autoTransfer gt lt Spotf ire Dxp Services Settings gt lt system web gt lt How long before a user is logged out when no analysis is displayed gt lt sessionState timeout 20 lt system web gt lt applic ationSetting s gt cookieless UseCookies gt lt Spotfire Dxp Internal Properties Settings gt lt se lt value gt 60000 lt value gt lt s lt se etting gt lt tting name tting name ManifestDownloadTimeoutMilliseconds serializeAs String gt LibraryCach lt value gt True lt value gt lt s lt se etting gt tting name LibraryCache lt value gt 00 10 00 lt value gt lt s lt Spo etting gt
126. nalysis file to be pre loaded on the server Note The time is set for the time zone of the web server If the user configuring the schedule is located in another time zone the current time of the web server is displayed This is to help the user calculate the appropriate times for the schedule Note If you want different settings for different days or between different hours click Add an additional schedule to add another one Select how often you want Spotfire Web Player to check if the analysis file or its underlying data has been changed and if so update the pre loaded instance Comment If you set this value too low Spotfire Web Player will check for updates before the previous update is finished loading The load time depends on the size of the analysis file and the amount of data it links to Click Save Note We recommend that when you set up scheduled updates that you reserve a window of at least one hour each night when no updates are scheduled As long as no other analyses files are open IIS can recycle itself clean up resources and free memory This recycle process will improve overall performance If there are open Spotfire Web Player analyses those connections will keep the server up because of the values in NeedsRefresh and inactivityTimeout which are designed to keep the analysis alive The value in NeedsRefresh is by default 15 seconds The default value for inactivityTimeout is 2 hours If you are considering over
127. name specified on the Domain Controller must also be configured for impersonation on the Spotfire Server 50 129 TIBCO Spotfire Web Player 7 0 Install Spotfire Web Player Spotfire Web Player Server Requirements You must configure these settings on the Spotfire Web Player server 1 Under Control Panel gt Network and Internet gt Internet Options gt Advanced you must select Enable Integrated Windows Authentication Requires Restart 2 The Spotfire Server you are connecting to must be located in the Intranet security zone Internet Explorer Client Requirements You must configure these settings on every end user computer 1 Under Tools gt Internet Options gt Advanced you must select Enable Integrated Windows Authentication Requires Restart 2 The Spotfire Web Player server you are connecting to must be located in the Intranet security zone Note If the website is located in the Internet security zone Internet Explorer will not even attempt Kerberos authentication This is because in most Internet scenarios a connection with a domain controller can not be established The simple rule is that any URL that contains periods such as an IP address or Fully Qualified Domain Name FQDN is in the Internet zone If you are connecting to an IP address or FQDN then you can use the settings in Internet Explorer or Group Policy to add this site to the Intranet security zone For more information on how Internet Explorer eva
128. navailable htm and place it in the App Data directory webroot App Data ServerUnavailable htm The HTML should not contain any lt Head gt or lt Body gt elements just the HTML body content Encrypt Usernames and Passwords All usernames and passwords specified in the lt Spotfire Dxp Internal Properties Settings gt part of the web config file can be encrypted These include e Username Password for Impersonation e Username Password for Proxy e Username Password for Scheduled Updates To encrypt the credentials specified here use the standard aspnet_regis exe tool found in ASP NET C gt aspnet_regiis ex pef applicationSettings Spotfire Dxp Web Properties Settings lt path_to_ web _application gt prov DataProtectionConfigurationProvider Example C WINDOWS Microsoft NET Framework64 v4 0 30319 aspnet_ regiis ex pef applicationSettings Spotfire Dxp Web Properties Settings C Program Files TIBCO Spotfire Web Player 7 0 webroot prov DataProtectionConfigurationProvider To decrypt the credentials use the following syntax C gt aspnet_regiis ex pdf applicationSettings Spotfire Dxp Web Properties Settings lt path_ to web _application gt 102 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference The web config file is encrypted using the machine key of the Spotfire Web Player server the file is residing on This means that you cannot move the web config to a
129. nformation on client certificates please refer to the TIBCO Spotfire Server Installation and Configuration Manual Enter this information in the lt value gt tags Certificate StoreName Specify the store name to get the certificate from Default value My Other valid values AddressBook AuthRoot CertificateAuthority Disallowed Root TrustedPeople TrustedPublisher Enter this information in the lt value gt tags Certificate StoreLocation Specify the location to get the certificate from Default value CurrentUser Other valid values LocalMachine Enter this information in the lt value gt tags Certificate SerialNumber Specify the serial number of the certificate Enter this information in the lt value gt tags lt Spotfire Dxp Internal Properties Settings gt ManifestDownloadTimeout Milliseconds Specify the manifest download time in milliseconds This is the time the application waits before aborting an operation when the server does not respond The default value is 60000 Use the Upgrade Tool After configuring the Spot fire Dxp Web UpgradeTool exe config run the webupdate bat file also found in the webroot bin Tools directory of the installation You can review the upgrade tool operations in the log file at webroot bin Tools Spotfire Dxp Web UpgradeTool log Make sure that you run the file as a user with the proper permissions for the Spotfire Server if you use
130. ng the service down at all Setting up a Server Cluster Using Microsoft Network Load Balancing One alternative is to configure a server cluster making use of the Microsoft Network Load Balancing NLB Cluster solution TIBCO Spotfire Web Player 7 0 125 129 Advanced Procedures and Technical Reference You can find more information about Microsoft NLB on Microsoft TechNet Windows Microsoft Technet URL Server 2008 R2 http technet microsoft com en us library cc725691 aspx 2012 http technet microsoft com en us library hh831698 aspx gt Setting Up the Server Cluster 1 Install Microsoft Windows Server 2008 R2 or Windows Server 2012 on a set of servers and connect them to the same subnet with fixed IP addresses 2 Install Network Load Balancing Windows Microsoft Technet URL Server 2008 R2 http technet microsoft com en us library cc731695 aspx 2012 http technet microsoft com en us library cc731695 aspx Note Some details of the procedure are different between Windows Server 2008 R2 and Windows Server 2012 For more information see http technet microsoft com 3 Install Spotfire Web Player on each server node and m Make sure that the local web server is running m Verify that you can open a Spotfire analysis in the Spotfire Web Player 4 Create and configure the cluster add hosts and configure them using the Network Load Balancing Manager Windows Microsoft Technet URL Server 2008 R2 http technet microsoft
131. nked Data When saving an analysis using linked data you can set up sharing routines Combining such sharing routines with scheduled updates can provide additional granularity when data should be loaded A basic scenario could be that you have an analysis that loads its data from a link to one single data table When saved to the library the sharing routines for the corresponding data table are set to always load new data This means that every time a scheduled update occurs the analysis will be updated with the latest data from the linked data table All end users that happen to have the analysis open in their web browsers will see the update icon and when clicked on the analysis on their screens will be updated with new data All end users will share the same data and RAM on the server However using sharing routines and multiple linked data tables you can set up more detailed configurations Say you have an analysis that uses two linked data tables One links to a huge amount of data that is only updated once every midnight The other data table is smaller but is updated every ten minutes You want to set up a scheduled update that keeps this analysis in memory the entire working day but continually updates with the latest data However it is only the small data table that you must reload and update every ten minutes Reloading the huge data table every ten minutes would be unnecessary since that will remain unchanged the entir
132. nly be accessed by a member of the Spotfire Administrators group the Web Player Administrator group or the Diagnostics Administrator group The Export Information button in the top right corner collects the information from all the diagnostics tabs in a text file you can save locally 6 12 1 Web Player Monitoring This tab shows statistics for all opened analyses The purpose of this is to make it possible to find problematic analyses when it comes to scalability There are two sub sections for this tab the Open Analyses tab and the Logging tab See the Troubleshooting section of this chapter for more information on how to use the information in this tab TIBCO Spotfire Web Player 7 0 105 129 Advanced Procedures and Technical Reference 6 12 1 1 Open Analyses This tab shows information on all open analyses on the web player server This information can be used to find out which analyses cause problems by consuming too much memory or CPU Web Player Monitoring Spotfire Server Web Server Web Application Loaded Assemblies Site Scheduled Updates Web Server Log Open Analyses Logging Currently On show Overview Refresh Clos TETE 7 SA efresl e Analysis Open Analysis V Show Document Nodes and View Sizes Average Loading Title Instances Time 120KDB_Monitoring_v10 emb 00 01 16 Airports 00 00 04 KMesns 00 00 01 4 22_USACounties 00 00 01 3 Kazakhstan Only Cached 00 00 00 Baseball linked Only Cached 00 00 00
133. nother computer as it will only work on the computer you encrypted it on 6 10 Configure Maximum Size for File Upload The default settings for file upload in the configuration file prevent users from working with a data file that exceeds four megabytes 4 MB To change this behavior you must set both maxRequestLength and maxAllowedContentLength Settings in the configuration file File upload is limited by both settings but the smaller setting will take precedence Users will encounter this limit in the following cases e Creating a new analysis from data file e Adding or replacing data from a data file to an open analysis e Opening an analysis file dxp from disk Examples Default values of 4 Mb and 28 6 Mb approximately lt lt location path Upload aspx gt lt system web gt lt httpRuntime maxRequestLength 4096 gt lt system web gt lt system webServer gt lt security gt lt requestFiltering gt lt requestLimits maxAllowedContentLength 30000000 gt lt requestFiltering gt lt security gt lt system webServer gt lt location gt gt Settings to allow uploading files that are slightly smaller than 10 Mb lt lt location path Upload aspx gt lt system web gt lt httpRuntime maxRequestLength 10240 gt lt system web gt lt system webServer gt lt security gt lt requestFiltering gt lt requestLimits maxAllowedContentLength 10485760 gt lt requestFiltering gt lt
134. nstalling the Spotfire Web Player Then copy the old xm1 file to the directory TIBCO Spotfire Web Player Installer before enabling scheduled updates the first time This will upload the existing scheduled updates to the library gt To Configure the Update Schedule 1 Go to the library by entering the address of the Spotfire Web Player server in the web browser Note To be able to configure the update schedule you must be logged in as an administrator or a Spotfire Web Player administrator 2 Click Tools gt Scheduled Updates 3 If there are existing files scheduled for updates click them to edit their update schedule or click Add analysis file TIBCO Spotfire Web Player 7 0 93 129 Advanced Procedures and Technical Reference 4 6 6 1 3 Browse to the file to set up an update schedule for and click on it to display the update schedule dialog Configure Update Schedule Update method Automatic User notification Schedule 1 Keep analysis pre loaded to assure fast access between O7 00 and 19 00 v V Monday v Friday Tuesday Saturday V Wednesday V Thursday Sunday Reload and trigger update within the specified time frame every minutes Add an additional schedule Cancel Select if the updates are to be done automatically or if the users are to be notified that a new version is available and let them update manually Select the days and the hours between which you want the a
135. o the Spotfire Web Player will be disconnected 6 2 1 Setup Element The following table contains details about the tags and attributes along with the values that you can modify in the lt setup gt element of the configuration file This section corresponds to the part of the configuration file labeled 1 2 3 and 4 in the previous code sample Position Tag with default value Explanation 1 lt Javagcriptipi cnableds false lt i gt Enables or disables the Spotfire Web Player Javascript API Enable this setting to allow users to share and view embedded analysis files using the Copy Link or Embed Code tools in the Spotfire Web Player You can control the domain of the Spotfire Web Player pages by typing the desired domain name in the domain attribute For example lt javaScriptApi nabled true domain example com gt For more information see the Spotfire Technology Network http spotfire tibco com stn 2 lt errorReporting gt TIBCO Spotfire Web Player 7 0 69 129 Advanced Procedures and Technical Reference emailAddress spotfireadmin yourcompany com Specify the e mail address for the Spotfire Web Player administrator When a user encounters certain server related errors a dialog with a Report error to administrator mailto link is displayed If the user clicks the link an e mail addressed to the administrator and including the error log is created in
136. og4net Layout PatternLayout gt lt conversionPattern value Sproperty operation gt lt layout gt lt parameter gt lt parameter gt lt parameterName value analysisId gt lt dbType value String gt lt size value 50 gt lt layout type log4net Layout PatternLayout gt lt conversionPattern value property analysisId gt lt layout gt lt parameter gt lt parameter gt lt parameterName value argument gt lt dbType value String gt lt size value 50 gt lt layout type log4net Layout PatternLayout gt lt conversionPattern value property argument gt lt layout gt lt parameter gt TIBCO Spotfire Web Player 7 0 123 129 Advanced Procedures and Technical Reference 6 13 3 6 14 lt parameter gt lt parameterName value status gt lt dbType value String gt lt size value 10 gt lt layout type log4net Layout PatternLayout gt lt conversionPattern value property status gt lt layout gt lt parameter gt lt appender gt External Monitoring Tool It is possible to monitor the Spotfire Web Player using an external monitoring tool There are three sources of information for such a tool e General Windows performance counters e TIBCO Spotfire Web Player performance counters e A dedicated monitoring events log file Performance Counters For a list of the custom performance counters included in the S
137. on you must include the ProxyUsername and ProxyPassword Settings Enter this information in the lt value gt tags The Proxy element of the web config file is a part of the standard NET Framework You can find more information about this configuration at the Microsoft Developer Network MSDN Use the information at MSDN if you need additional help setting up the attributes and values that are relevant to your specific Proxy server lt system net gt lt defaultProxy gt lt proxy proxyaddress http MyProxyServer 3128 scriptLocation MyScriptLocation gt lt defaultProxy gt lt system net gt lt applicationSettings gt lt Spotfire Dxp Web Properties Settings gt lt Proxy You need to set the system net defaultProxy proxy proxy address to use this Proxy username password for communication between web server and Spotfire server gt lt setting name ProxyUsername serializeAs String gt lt value gt user lt value gt lt setting gt lt setting name ProxyPassword serializeAs String gt lt value gt pa55w0rd lt value gt lt setting gt lt Spotfire Dxp Web Properties Settings gt lt applicationSettings gt Configure IIS Authentication If you are using Anonymous Preconfigured access Single Sign On authentication or Client Certificate authentication you must use the IIS Manager to configure IIS Authentication For Username and Password authentication this is configured autom
138. on Type page and then click Next 6 Select the server in the Server Selection page and click Next 7 On the Select Server Roles page select Web Server IIS and then click Next 24 129 TIBCO Spotfire Web Player 7 0 10 11 12 13 Prerequisite Installation Comment Ifa prompt for Add features required for Web Server IIS appears click Add Required Features and then click Next On the Web Server IIS page click Next On the Select Role Services page you must select at a minimum the settings listed for each group in the following table You may need to select more options for your environment After you select the correct options click Next Comment In the Security group you must make sure to select the required authentication types Group Setting Common HTTP Features Static Content Default Document Directory Browsing HTTP Errors Application Development ASP NET 4 5 NET Extensibility 4 5 ISAPI Extensions ISAPI Filters Health and Diagnostics HTTP Logging Request Monitor Security Basic Authentication Windows Authentication Request Filtering Performance Static Content Compression Management Tools IIS Management Console IIS Management Scripts and Tools IIS 6 Management Compatibility IIS 6 Metabase Compatibility IIS 6 WMI Compatibility IIS 6 Scripting Tools Comment If a prompt for Add role services and features required for ASP NET appears select Add Required Role Servi
139. ons of the Spotfire Web Player on the same computer If you have an earlier version of Spotfire Web Player on the computer the earlier version will not run Authentication There are seven different authentication alternatives for Spotfire Web Player Each of these is described in the chapter Authentication Alternatives on page 8 You must decide which alternative to use before installing the Spotfire Web Player Which of the authentication alternatives will you use for Spotfire Web Player Ports Before installing Spotfire Web Player verify that HS is running and is configured to use the port that the Spotfire Web Player will listen on The default port is port 80 What port will you use for Spotfire Web Player Installer Options When you run the Spotfire Web Player installation wizard you must answer the following questions Name of the Virtual Directory that will be part of the URL of the Spotfire Web Player We recommend SpotfireWeb The URL to the Spotfire Server for communication from the Spotfire Web Player E mail address of the local Spotfire Administrator TIBCO Spotfire Web Player 7 0 17 129 Pre Installation Planning SSL We recommend that you use SSL https for the authentication alternatives that send passwords in plain text Will you use SSL 18 129 TIBCO Spotfire Web Player 7 0 2 1 2 1 1 2 1 2 2 1 3 Pre
140. ou have set up Single Sign On enabled Windows Authentication then you must also make sure that the ASP NET Impersonation setting is enabled in the web config file by setting the impersonate attribute of the identity configuration element to true Regarding Username amp Password Since login validation is granted through a login dialog in the ASP NET layer IIS is normally configured to use anonymous access However it is possible to set IIS to NTLM In this case you can first verify that all users are logged in on your Windows Domain before they attempt to log on to the ASP NET layer where they are required to log in using their Spotfire credentials The Web site in IIS Directory security can use Integrated Windows Authentication Basic authentication or Anonymous access Configure SSL SSL communication is configured using IIS on the Spotfire Web Player server and then handled automatically by the browser and the web service calls to Spotfire Server 40 129 TIBCO Spotfire Web Player 7 0 Install Spotfire Web Player We recommend that you use SSL when you are using Basic and Forms authentication because these options transmit passwords in plain text Note SSL is required for Client Certificate authentication After configuring SSL the cookies should also be secured This is done by adding the section nttpcookies with the requiressu attribute to the system web Section in the web config file If forms authentication i
141. p Alive Service service This service is required for the Scheduled Updates feature to operate correctly To use Scheduled Updates you must set the Startup Type for the service to Automatic Upgrade Tool If you need to install new modules such as language packs or third party add ons you can use the Upgrade tool The Upgrade tool spot fire Dxp wWeb UpgradeTool exe IS contained in the lt installation directory gt webroot bin Tools directory For more information on using the Upgrade tool see the section Deploying Extensions and Upgrades on page 59 Log Files The Spotfire Web Player log entries are written to log files in the lt installation directory gt webroot bin Logfiles directory For more information about the Spotfire Web Player Log see the section Web Server Log on page 114 TIBCO Spotfire Web Player 7 0 7 129 Pre Installation Planning 1 4 Authentication Alternatives The Spotfire Web Player authentication consists of three components ITS ASP NET and Spotfire Server Each component can be configured in various ways and the combination of configurations define the overall authentication behavior The combination of how these three components are configured will define the security of the system and the experience for the users Before you begin the Spotfire Web Player installation it is important that you understand the authentication alternatives discussed in this chapter You can use this infor
142. pdated with the sales figures that were reported during the day At 4 am the scheduled update is activated on the TIBCO Spotfire Web Player and the analysis is loaded into memory It loads the new data from the company database and bases all graphs and results on this The following morning the sales people come into the office or turn on their laptops from home They check their e mail read the message from the analyst and click the link The web browser launches and quickly the analysis is displayed on screen showing the sales results for the previous day Since the data is already preloaded on the server there is no waiting time for it to load from the company database The next midnight the company database will be updated with new numbers At 4 am the analysis will be preloaded with the new data on the TIBCO Spotfire Web Player server and the sales people can access this the next morning as usual If a user should have the analysis open in his web browser overnight a small icon will appear on the screen after the scheduled update has been performed on the server This will tell the user that there is an updated version of the analysis available and clicking on the icon will refresh the analysis with the latest data Concerning Prompted and Personalized Information Links Scheduled Updates are mainly intended for use with analyses that have been set up using normal information links to load data If you set up scheduled updates for
143. potfire Web Player and a suggested set of general Windows performance counters see Enable logging in web config on page 117 Monitoring Log File For information on the monitoring log file MonitoringEventsLog txt see the general description in Logging and Monitoring on page 116 and for details on the log file see Enable logging in log4net config on page 118 Performance The system diagnostics page and the logging and monitoring configuration described earlier are very useful for monitoring the Spotfire Web Player server As a complement logging with the Performance Monitor tool found in Microsoft Management Console for Windows Server can give more information about the server status The logs can be observed graphically or saved to a file Good counters to log for an ASP NET application is described in ASP NET Performance Monitoring and When to Alert Administrators MSDN Library Thomas Marquardt Microsoft Corporation http msdn2 microsoft com en us library ms972959 aspx gt Enabling Performance Logging 1 Select Start gt Administrative Tools gt Reliability and Performance Monitor Performance Monitor on Windows Server 2012 2 Select Monitoring Tools gt Performance Monitor 3 Right click Performance Monitor and select New gt Data Collector Set 124 129 TIBCO Spotfire Web Player 7 0 10 11 6 15 Advanced Procedures and Technical Reference Specify a name for the data collector se
144. quired In this configuration when users connect to the Spotfire Web Player the ASP NET component displays a login form Please log into TIBCO Spotfire Web Player Username Password Remember me If the user selects Remember me their credentials are stored in a cookie This cookie is used for authentication during subsequent logins and the login form is not displayed If a user wants to remove the cached login cookie they should click logout on the Spotfire Web Player or Library web page The credentials that the user types into the login form are validated by the Spotfire Server Note Because the username and password are sent as clear text we recommend that you use this authentication alternative also known as Forms Authentication together with HTTPS SSL connections see Configure SSL on page 40 Anonymous Preconfigured Access With this option users who access the Spotfire Web Player services are automatically logged in as the user that you specify in the web config file This means all users who log in to Spotfire Server will appear to be the same Spotfire user In this scenario you must create this user grant the licenses for the library and configure the user for impersonation on the Spotfire Server Single Sign On You should use this authentication method to configure a single sign on experience for the Spotfire Web Player users In this scenario after a user supplies their Windows c
145. r 6 3 1 Specify Language Mappings You can define a mapping from a language preference configured by users in the browser to one of the languages installed on the Spotfire Web Player server For example if your users have French Canada fr CaA as the highest preference language in their web browser but the Spotfire Web Player uses French France fr FR you can specify that fr FR should be used even if the end users have not added fr FR to their list of supported languages in the browser To make this change you must add a new section to the Spotfire Web Player web configuration file 80 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference The highest preference language in the web browser that is either listed among installed languages or listed in the language mappings in the configuration file is picked as the language for the user interface However if no browser language matches the languages listed in the language mappings section the language specified by the IIS setting lt globalization gt is selected as long as this language is one of the installed languages If a language cannot be mapped from any of these settings en US is selected Note Languages listed under lt installedLanguages gt cannot be overridden gt Specifying Language Mappings 1 Use an XML editor to open the web config file from the webroot directory for example C Program Files Tibco Spotfire Web Player
146. rd authentication is configured Note This can only be used on the Spotfire Web Player Login aspx Web page Add the following attribute to the lt authentication gt element to allow URL authentication lt forms enableUrlLogin true gt It is now possible for users to log in using the address lt mywebplayer gt Login aspx username MyUsername amp password MyPassword AspxAutoDetectCookieSupport 0 Add the following attribute to allow basic login using authorization headers lt forms enableHeaderLogin true gt Add the following attribute to allow base64 encoded UTF8 username and password in the header lt forms useUtf8EncodingForBasicHeader true gt Example If you add all three attributes to the existing lt forms gt element the lt authentication gt element will look like the following lt authentication serverUrl http spotserver 30 129 TIBCO Spotfire Web Player 7 0 Install Spotfire Web Player enableAutocomplete false gt lt forms enableUrlLogin true enableHeaderLogin true useUtf8EncodingForBasicHeader true gt lt authentication gt 3 3 2 Anonymous Preconfigured Access In the web config file you must enable impersonation by changing the setting to true You must also specify the username and password to use when authenticating to the Spotfire Server You enter this information in the lt value gt tags for ImpersonationUsername and ImpersonationPassword Note This user must also be
147. re Web Player 7 0 55 129 Install Spotfire Web Player 3 9 If you configured Spotfire Web Player to use anonymous preconfigured authentication then you only need to configure access rights for the single preconfigured user and everyone will automatically use those credentials If you have configured authentication so that each user will be logged in with their own credentials you must set up access rights for all users or groups of users Configuring Spotfire Library User Rights Start TIBCO Spotfire and then click Tools gt Library Administration For information on how to create library sections and folders and how to configure access rights to these see the Library Administration section in the TIBCO Spotfire online help which you can reach by clicking Help URL Preference When a user publishes a new Spotfire analysis file to the Spotfire Library it is useful to instantly see the URL of that analysis In order to see this URL you must perform the following procedure When this is configured users can copy the URL and send it to other people who can open the analysis in Spotfire Web Player Save as Library Item Sales Data for Q2 has been published A Location for the file in the Library Copy Link Sales and Marketing 2009 Sales Data for Q2 zS The analysis can be accessed with the TIBCO Spotfire Web Player from Copy Link D http dpwebciient SpotfireWeb ViewAnalysis aspxile Sales and Market
148. redentials to log on to the network the Spotfire Web Player automatically uses the Windows credentials of the user to access the Spotfire Web Player 10 129 TIBCO Spotfire Web Player 7 0 Pre Installation Planning There are four ways to achieve a single sign on experience and they are more complex than the Anonymous or Username and Password methods this is because each approach requires additional configuration on the Windows Domain Controller or the Spotfire Server or both If you choose these alternatives you should be knowledgeable about Domain Controllers a cn N k Na Domain Controller lt gt lt lt gt User Spotfire Web Player Server Spotfire Server The alternative approaches are to enable Single Sign On using e Impersonation with NTLM Login e Impersonation with Basic Login e Impersonation with Kerberos Login e Delegation with Kerberos Login Impersonation with NTLM Login This alternative to use NTLM with Impersonation is the recommended single sign on method for Spotfire Server and is the preferred option for Spotfire Web Player In this approach when a user connects to the Spotfire Web Player from a browser the Windows credentials are used to automatically log in the user The Spotfire Web Player then contacts the Spotfire Server which prompts the Spotfire Web Player to authenticate the user The Spotfire Web Player automatically logs into the Spotfire Server using a predefined impe
149. requisite Installation Prerequisite Installation Operating System At this point for the computer where you intend to install Spotfire Web Player you should already have installed and configured either Microsoft Windows 2008 R2 Server a Microsoft Windows 2012 Server or a Microsoft Windows 2012 R2 Server For system requirements see http support spotfire com sr asp Note If you have an earlier version of Spotfire Web Player installed on the target computer that version will not work after you install Spotfire Web Player 7 0 Internet Access Some of the Spotfire Web Player features require Internet access Features such as collaboration and for any images in a table that are linked from a Web site on the Internet Other third party features may also be affected by lack of Internet access Active Scripting If you need to export text areas from the Spotfire Web Player you must enable Active Scripting on the Spotfire Web Player computer Enabling Active Scripting Start the Local Group Policy Editor gpedit msc Under Local Computer Policy expand Computer Configuration gt Administrative Templates gt Windows Components gt Internet Explorer gt Internet Control Panel gt Security Page gt Internet Zone Right click Allow active scripting and select Edit On the Allow active scripting page select Enabled In the Options area make sure that the Allow active scripting list is set to Enabled and then click OK
150. rsonation account You must add the impersonation account to the Spotfire Server Impersonator group Accounts in this group have the run services as another named user user right This user right means that by stating a valid username the system can run services as that user without requiring the password for that account To reduce the risk of security issues you can specify the Spotfire Web Player computer name or IP address as the only logon location that the impersonation account can use to access the Spotfire Server TIBCO Spotfire Web Player 7 0 11 129 Pre Installation Planning The requirements for this alternative are e An impersonation account for the Spotfire Web Player must be created on the Domain Controller e The Spotfire Server must be configured to use NTLM Login System e You must enable ASP NET Impersonation on IS This alternative does not require that you to configure Delegation on the Domain Controller Instead you configure a trusted account on the Spotfire Web Player that the Spotfire Server allows to run requests as another user This is referred to as Impersonation Impersonation with Basic Login If you cannot use NTLM you can use this alternative In this approach when a user connects to the Spotfire Web Player from a browser the Windows credentials are used to automatically log in the user The Spotfire Web Player then contacts the Spotfire Server which prompts the Spotfire Web Player to au
151. rsonation with Basic Login System You must modify the web config file to set lt impersonation enabled gt value to true specify lt authentication mode gt as Windows and set lt identity impersonate gt to true In order to authenticate to the Spotfire Server you must specify a username and password You enter this information farther down in the web config file in the lt value gt tags for ImpersonationUsername and ImpersonationPassword The account you specify here is the impersonation account you created on the Domain Controller and configured on the Spotfire Server for the Spotfire Web Player to use in connecting to the Spotfire Server Example lt setting name ImpersonationUsername serializeAs String gt lt value gt user lt value gt lt setting gt lt setting name ImpersonationPassword serializeAs String gt lt value gt pa55w0rd lt value gt Modify the relevant values indicated by bold text in the following code lt spotfire dxp web gt lt setup gt lt lin ImpersonationUsername and ImpersonationPassword must also be set to enable impersonation gt lt impersonation enabled true gt lt authentication gt lt setup gt lt system web gt lt identity impersonate true gt lt authentication mode Windows gt lt authentication gt lt authorization gt lt deny users gt lt allow users gt lt authorization gt lt applicationSettings gt lt Spotfire Dxp
152. s to the Spotfire Web Player are authenticated using client certificates The Spotfire Web Player then contacts the Spotfire Server which prompts the Spotfire Web Player to authenticate the user The Spotfire Web Player automatically logs into the Spotfire Server using a predefined impersonation client certificate and submits the user client certificate to the Spotfire Server to authenticate the user Therefore this authentication alternative requires that the Spotfire Server is set to use client certificates and that Impersonation is enabled on the Spotfire Server Note This manual does not cover how to install and configure the client certificates or how to configure SSL only how to configure the Spotfire Web Player to be able to use already installed client certificates for authentication 1 5 Service Accounts There are a number of service accounts used when setting up the Web Player e Impersonation account When impersonation is enabled this account is used to log in to the Spotfire Server instead of the user s accounts e Application Pool account This is the Windows Account that will execute the application pool of the Web Player 14 129 TIBCO Spotfire Web Player 7 0 Pre Installation Planning e Scheduled Updates account When enabled this account is used when pre loading analyses When setting up the Web Player different accounts should be used for all of these roles to make the system secure and to make logs
153. s used the requiressu attribute should also be added to the system web authentication forms section in web config Example lt configuration gt lt system web gt lt httpCookies requireSSL true gt lt authentication mode Forms gt lt forms loginUrl requireSSL true gt lt authentication gt You can find more information on configuring SSL at the Microsoft TechNet Web site http technet microsoft com 3 5 Verify the Configuration File At this point you should verify the changes you have made to the configuration file Note If you enable or disable Forms Authentication in IIS some unwanted changes may be written to the web config file and you must removed these changes gt Verifying and Correcting web config 1 Use an XML editor to open the web config file from the webroot directory for example C Program Files Tibco Spotfire Web Player 7 0 webroot Web config Comment We recommend that you use an XML editor when you modify XML files An XML editor has features to provide a clear view of the XML code and some text editors corrupt configuration files 2 Locate the following elements lt authentication mode gt lt authentication gt lt authorization gt TIBCO Spotfire Web Player 7 0 41 129 Install Spotfire Web Player lt authorization gt 3 Verify that these elements match the settings you specified earlier If they do not match IIS has modified the file and you mus
154. security gt lt system webServer gt lt location gt gt gt Configuring maximum size for file upload 1 Use an XML editor to open the web config file from the webroot directory for example TIBCO Spotfire Web Player 7 0 103 129 Advanced Procedures and Technical Reference 6 11 C Program Files Tibco Spotfire Web Player 7 0 webroot Web config Note We recommend that you use an XML editor when you modify XML files An XML editor has features to provide a clear view of the XML code and some text editors corrupt configuration files Find the lt location gt element associated with maxRequestLength 10240 copy the element and then delete the start and end comment strings as shown below Default Edited lt lt location path Upload aspx gt lt location path Upload aspx gt lt location gt gt lt location gt Modify the settings for maxRequestLength in KB and maxAllowedContentLength in bytes to fit your needs Save web config Configure the Spotfire Web Player Using FIPS If you want to run the Spotfire Web Player server on a computer that has FIPS Federal Information Processing Standard enabled an addition must be made to the configuration file Configuring web config for Use With FIPS Use an XML editor to open the web config file from the webroot directory for example C Program Files Tibco Spotfire Web Player 7 0 webroot Web config Note We recommend that you use an
155. ser This is referred to as Impersonation Impersonation with Kerberos Login With the Kerberos Login System you can configure single sign on to use Delegation or Impersonation If you can not configure Delegation on the Domain Controller you can use this alternative 12 129 TIBCO Spotfire Web Player 7 0 Pre Installation Planning In this approach when a user connects to the Spotfire Web Player from a browser the Windows credentials are used to automatically log in the user The Spotfire Web Player then contacts the Spotfire Server which prompts the Spotfire Web Player to authenticate the user The Spotfire Web Player automatically logs into the Spotfire Server using a predefined impersonation account You must add the impersonation account to the Spotfire Server Impersonator group Accounts in this group have the run services as another named user user right This user right means that by stating a valid username the system can run services as that user without requiring the password for that account To reduce the risk of security issues you can specify the Spotfire Web Player computer name or IP address as the only logon location that the impersonation account can use to access the Spotfire Server The requirements for this alternative are e You must create an impersonation account for the Spotfire Web Player on the Domain Controller e The Spotfire Server must use Kerberos Login System e A member of the Account
156. ses and analysis open and close is logged At DEBUG level state changes apply and save are also logged e TimingLog txt Logs similar information as the AuditLog but all events have a start time an end time and a duration logged as well e MonitoringEventsLog txt At INFO level Spotfire Web Player server start up and shut down is logged At DEBUG level session create and remove analyses open and close and cached analyses add and remove are also logged e DocumentCacheStatisticsLog txt The cached analyses sampled regularly e OpenFilesStatisticsLog txt The open analyses sampled regularly 116 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference e PerformanceCounterLog txt Standard and custom performance counters logged regularly e UserSessionStatisticsLog txt The existing sessions sampled regularly e DateTimes txt All time points from the Spotfire Web Player logs collected in one file to simplify joins between tables e MemoryStatisticsLog txt Writes resource usage per document Logs the amount of memory used by tables and views the number of internal document nodes and the execution time On INFo level the total values per document is logged and on DEBUG level detailed information per table is recorded Note You can log to a database instead of log files For more information see Enable logging in log4net config on page 118 6 13 1 Enable logging
157. so be set to enable impersonation gt lt impersonation enabled true gt lt authentication gt lt setup gt lt system web gt lt identity impersonate true gt lt authentication mode Windows gt lt authentication gt lt authorization gt TIBCO Spotfire Web Player 7 0 33 129 Install Spotfire Web Player 3 3 5 lt deny users gt lt allow users gt lt authorization gt lt applicationSettings gt lt Spotfire Dxp Web Properties Settings gt lt Impersonation This is the username and password used for impersonation gt lt setting name ImpersonationUsername serializeAs String gt lt value gt MYDOMAIN user lt value gt lt setting gt lt setting name ImpersonationPassword serializeAs String gt lt value gt pa55w0rd lt value gt lt setting gt lt Spotfire Dxp Web Properties Settings gt lt applicationSettings gt When you have completed the changes save the file Note If ASP NET Impersonation was enabled for the Spotfire Web Player in the IIS management console there may be a duplicate lt identity impersonate true gt element in web config This duplicate setting may prevent Spotfire Web Player from working Important To be safe you should create a backup copy of web config and store it in a reliable location You might need the information later If your environment requires a proxy service proceed to Configure Proxy Handling o
158. stallation media and then click OK After you specify the alternate source or if the target computer does have access to Windows Update close the warning 9 Click Install 10 When the installation completes click Close For more information on deploying NET 3 5 see Microsoft NET Framework 3 5 Deployment Considerations at http msdn microsoft com library windows hardware hh975396 26 129 TIBCO Spotfire Web Player 7 0 Install Spotfire Web Player 3 Install Spotfire Web Player This section explains how to install and configure Spotfire Web Player 3 1 Copy the Installation Files The Spotfire Web Player installation media contains a TIBCO Spotfire Web Player Installer directory Copy this source directory to a local disk on the target computer Note If you have an earlier version of Spotfire Web Player installed on the target computer that version will be removed when you install Spotfire Web Player 7 0 Before you start the installation process we recommend that you create a back up the web config file You can use this file for reference as you configure the new installation 3 2 Run the Installer In order to install Spotfire Web Player you must log in to the target computer with credentials that have Administrator user rights Before you install Spotfire Web Player make sure that the target computer is running IIS gt Running the Installer 1 From the directory you copied to the local disk start the installation
159. stration Guide and read the Configuring TIBCO Spotfire to use TIBCO Spotfire Statistics Services section If Spotfire Statistics Services requires authentication you must specify these authentication settings in the web config file by entering the Spotfire Statistics Services URL along with the username and password for Spotfire Statistics Services You can add additional rows to each of the settings to specify URLs usernames and passwords for several Spotfire Statistics Services Note The URLs must be specified exactly the same for the Spotfire Web Player server and the Spotfire Server For example you must use FQDN in both cases or neither case Enter information in the places indicated with bold format in the following code lt Spotfire Dxp Web Properties Settings gt lt setting name TibcoSpotfireStatisticsServicesURLs serializeAs Xml gt lt value gt lt ArrayOfString gt lt string gt lt string gt lt ArrayOfString gt lt value gt lt setting gt lt setting name TibcoSpotfireStatisticsServicesUsernames serializeAs Xml gt lt value gt lt ArrayOfString gt lt string gt lt string gt lt ArrayOfString gt lt value gt lt setting gt lt setting name TibcoSpotfireStatisticsServicesPasswords serializeAs Xml gt lt value gt lt ArrayOfString gt lt string gt lt string gt lt ArrayOfString gt lt value gt lt setting gt lt Spotfire Dxp Web Properties Settings gt
160. t lt authorization gt lt applicationSettings gt lt Spotfire Dxp Web Properties Settings gt The serial number of the certificate to use name ImpersonationCertificateSerialNumber serializeAs String lt value gt 00BDFB57D2A172B66C lt value gt lt setting gt Klez The serial number of the certificate to use gt lt setting name ScheduledUpdatesCertificateSerialNumber serializeAs String lt value gt 00BDFB57D2A172B66D lt value gt lt setting gt lt Spotfire Dxp Web Properties Settings gt lt applicationSettings gt When you have completed the changes save the file Important To be safe you should create a backup copy of web config and store it in a reliable location You might need the information later If your environment requires a proxy service proceed to Configure Proxy Handling on page 39 Otherwise proceed to Configure IIS Authentication on page 39 38 129 TIBCO Spotfire Web Player 7 0 3 3 8 3 4 Install Spotfire Web Player Configure Proxy Handling Proxy handling from the browser to the Web server is handled by the browser just as usual However if you need to use proxy handling for communication from the Spotfire Web Player server to the Spotfire Server you must make additional changes to the web config file To use proxies you must configure the settings shown in the example below If the proxy server is using Basic authenticati
161. t and click Next Specify the location to save the log files to and click Finish Select Data Collector Sets gt User Defined gt The newly created Data Collector Set Right click System Monitor Log in the window to the right and select Properties Add the counters needed Set various parameters such as Sample Interval Log Format and File Name The file name is specified as there can be multiple data collectors in the data collector set Comment Parameters can be found on both the Performance Counters tab and the File tab Click OK Right click Data Collector Sets gt User Defined gt The newly created Data Collector Set and select Start Stop to start or stop collecting the data The logging results will be saved in the specified data collector file Set up a Server Cluster Spotfire Web Player in a Server Cluster To obtain better scalability it is possible to configure a cluster of Spotfire Web Player servers Many different cluster solutions may be used as long as session affinity is maintained and the same ASP NET machineKey is set on all Spotfire Web Player servers Advantages with a Server Cluster Solution Setting up a server cluster has some advantages compared to a single server e The price for a set of less powerful servers may be lower than for a single high performance server e The application will be available as long as at least one server node is up and running so upgrading will be possible without taki
162. t manually insert the changes you previously made to the file 4 Save the file 3 6 Additional Authentication Configuration The four alternatives for Single Sign On authentication and Client Certificate authentication require additional configuration You may need to make changes on either your Windows Domain Controller the Microsoft Management Console or the Spotfire Server Because of this these alternatives require that you are knowledgeable about how a Domain Controller works For instructions on the configuration of these alternatives see the following chapters e Single Sign On Using Delegation with Kerberos Login System on page 42 e Single Sign On Using Impersonation with Kerberos Login System on page 50 e Single Sign On Using Impersonation with NTLM Login System on page 52 e Single Sign On Using Impersonation with Basic Login System on page 53 e Client Certificate on page 54 You do not need to complete any additional configuration for Username and Password authentication or for Anonymous Preconfigured access since the configuration for these methods are only in the web config file and on IIS If you implemented one of these authentication alternatives for your Spotfire environment you should go directly to Deploy Web Packages to Spotfire Server on page 54 3 6 1 Single Sign On Using Delegation with Kerberos Login System Install and Configure Kerberos on the Spotfire Server
163. tan Latest update 3 27 2014 12 54 54 PM Duration of latest update 0 19 172 Update method User notification Updated every 0 minutes between 5 00 AM and 10 00 PM on Mon Tue Wed Thu Fri Sat Sun data Baseball linked Latest update 3 27 2014 3 48 56 PM Duration of latest update 0 02 854 Update method User notification Updated every 3 minutes between 7 00 AM and 7 00 PM on Mon Tue Wed Thu Fri Sat Sun Manage scheduled updates Web Server Log This tab displays the log for the web application Web Player Monitoring Spotfire Server Web Server Web Application Loaded Assemblies Site Scheduled Updates INFO 2014 03 27 15 00 56 582 8068 WorkThread 35 leifg WAT 46 Spotfire Dxp Web WebAnalysis Opening shareable master document with origin idata Baseball linked DxpFileFromLibrary INFO 2014 03 27 15 00 58 287 8068 WorkThread 35 leifg Spotfire Dxp Wab Library ScheduledUpdates Update of data Baseball linked execution time 00 00 02 1216126 normalized update time 15 00 INFO 2014 03 27 15 03 56 655 8068 WorkThread 15 leifg WAT 47 Spotfire Oxp Web WebAnalysis Opening shareable master document with origin idata Baseball linked DxpFileFromLibrary INFO 2014 03 27 15 03 58 371 8068 WorkThresd 15 leifg Spotfire Oxp Web Library ScheduledUpdates Update of data Basebsll linked execution time 00 00 02 1840140 normalized update time 15 03 INFO 2014 03 27 15 06 56 695 8068 WorkThread 22 leif
164. tended client TIBCO Spotfire Any Client or TIBCO Spotfire Web Player After you have built the packages you must upgrade the Spotfire Web Player with the created packages by deploying them to the Spotfire Server and then using a special upgrade tool to make them appear on the Spotfire Web Player server For more information see Deploying Extensions and Upgrades on page 59 Any changes made to the ScheduledUpdates xm1 must also be transferred to the new version of this file see Upgrade an Existing Schedule on page 98 If you have customized the Header Banner see Customize Web Pages on page 65 reapply these modifications Finally clean up potential remaining files in the old installation directory Deploying Extensions and Upgrades If you have deployed packages marked with the intended client TIBCO Spotfire Any Client or TIBCO Spotfire Web Player to a Spotfire Server it is possible to extend or upgrade Spotfire Web Player with those packages using the upgrade tool For information on how to deploy packages to the Spotfire Server please refer to the TIBCO Spotfire Deployment and Administration Manual The upgrade tool is a batch file named webupdate bat which is run from the Spotfire Web Player server It connects to the Spotfire Server specified in the web config file and you should specify the authorization for the Spotfire Server in the upgrade tool configuration file Configure the Upgrade Tool
165. the file Important To be safe you should create a backup copy of web config and store it in a reliable location You might need the information later If your environment requires a proxy service proceed to Configure Proxy Handling on page 39 Otherwise proceed to Configure IIS Authentication on page 39 3 3 3 Single Sign On Using Delegation with Kerberos Login System You must modify the web config file to specify lt authentication mode gt as Windows and lt identity impersonate gt to true Note For this configuration you should leave the lt impersonation enabled gt value as false Modify the relevant values indicated by bold text in the following code lt spotfire dxp web gt lt setup gt lt impersonation enabled false gt lt authentication gt lt setup gt lt system web gt lt identity impersonate true gt lt authentication mode Windows gt lt authentication gt lt authorization gt lt deny users gt lt allow users gt lt authorization gt When you have completed the changes save the file 32 129 TIBCO Spotfire Web Player 7 0 Install Spotfire Web Player Note If ASP NET Impersonation was enabled for the Spotfire Web Player in the IIS management console there may be a lt identity impersonate true gt element in web config This setting may prevent Spotfire Web Player from working Important To be safe you should create a backup copy of w
166. the same directory Note If IIS running the Spotfire Web Player is set to Integrated Windows Authentication the service needs to run as a domain account that can access the IIS Go to Administrative Tools gt Services gt TIBCO Spotfire Web Player Keep Alive Service and enter the username and password of a user that has the user rights to access IIS in order for the ping to reach the Spotfire Web Player It must be a valid Windows account that can access the web application Note We recommend that you use an XML editor because some text editors corrupt configuration files An XML editor will also provide a more clear view of the XML code Example lt configuration gt lt applicationSettings gt lt Spotfire Dxp Web KeepAlive Properties Settings gt lt setting name SettingsFilePath serializeAs String gt lt value gt C Program Files TIBCO Spotfire Web Player 7 0 webroot App Data ScheduledUpdates xml lt value gt lt setting gt lt setting name PingIntervalMinutes serializeAs String gt lt value gt 10 lt value gt lt setting gt lt setting name WindowsUserName serializeAs String gt lt value gt WindowsUserName lt value gt lt setting gt lt setting name WindowsPassword serializeAs String gt lt value gt WindowsPassword lt value gt lt setting gt lt setting name WebPlayerUrl serializeAs String gt lt value gt http localhost 80 SpotfireWeb KeepAliv
167. thenticate the user The Spotfire Web Player automatically logs into the Spotfire Server using a predefined impersonation account You must add the impersonation account to the Spotfire Server Impersonator group Accounts in this group have the run services as another named user user right This user right means that by stating a valid username the system can run services as that user without requiring the password for that account Since the Spotfire Server is using a Basic login LDAP or Database system the list of valid usernames is stored on either an LDAP server or in the Spotfire Server database itself This is the main difference between this alternative and Impersonation with NTLM Login System To reduce the risk of security issues you can specify the Spotfire Web Player computer name or IP address as the only logon location that the impersonation account can use to access the Spotfire Server The requirements for this alternative are e The Spotfire Server must use either LDAP or Database Login System e You must create an impersonation account for the Spotfire Web Player on the LDAP Server or the Spotfire Server depending on whether the Spotfire Server has been configured to use LDAP or Database login system This alternative does not require that you to configure Delegation on the Domain Controller Instead you configure a trusted account on the Spotfire Web Player that the Spotfire Server allows to run requests as another u
168. tificates Right click the installed impersonation user certificate and select All Tasks gt Manage Private Keys Click Add Locate and select the account NETWORK SERVICE Grant the NETWORK SERVICE account Read permissions Click OK Proceed to Deploy Web Packages to Spotfire Server on page 54 Deploy Web Packages to Spotfire Server Any hotfixes released for Spotfire 7 0 must be deployed first as packages to the Spotfire Server and then pushed to the Spotfire Web Player with the upgrade tool you can download hotfixes from the TIBCO Spotfire hotfix download site http support spotfire com patches asp To deploy any hotfixes extensions or upgrades to the Spotfire Web Player follow the instructions in the chapter Deploying Extensions and Upgrades on page 59 For information on how to deploy packages to the Spotfire Server please refer to the TIBCO Spotfire Deployment and Administration Manual 54 129 TIBCO Spotfire Web Player 7 0 3 8 3 8 1 3 8 2 Install Spotfire Web Player Licenses and Library Rights Licenses All Spotfire Web Player users must have certain license functions enabled in order to open an analysis If you are using anonymous preconfigured authentication then the preconfigured single user that has been set up must have these license functions You can configure licenses from the TIBCO Spotfire Administration Manager found in the TIBCO Spotfire client The following
169. tion 9 lt Spotfire Dxp Services Settings gt lt cookies autoTransfer _ gt For a load balancer or proxy that requires specific cookies to be sent on all requests to the Spotfire Server you should add the cookies in this value Separate cookies with a semi colon 6 2 5 System Web Settings Element The following table contains details about the tags and attributes along with the values that you can modify in the lt system web gt element of the configuration file This section corresponds to the part of the configuration file labeled 9 in the previous code sample Position Tag with default value Explanation lt system web gt lt sessionsState timeout 20 cookieless UseCookies i gt Specify the time limit in minutes for a user to be inactive on the Start page or in the Library browser When the limit is reached the user is logged out and automatically redirected to the logout page Default value is 20 minutes 6 2 6 Application Settings Element The following table contains details about the tags and attributes along with the values that you can modify in the lt applicationSettings gt element of the configuration file 78 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference This section corresponds to the part of the configuration file labeled 10 in the previous code sample Position Tag
170. tion alternatives are not available for all connectors For information on which authentication alternatives that are supported for each connector see the specifications for that connector Windows Authentication e WebConfig select this to force all users that are accessing a specific analysis connect to the external data source using the username and password specified in the DataAdapterCredentials section described later in this chapter e Kerberos select this if your system is configured to authenticate users with Kerberos e Prompt select this to prompt the users for a username and password for the external data source e ServiceAccount select this to make all users connect to the external data source using the computer account or dedicated user account that is used to run the application pool in IIS on the Spotfire Web Player server Database Authentication 82 129 TIBCO Spotfire Web Player 7 0 Advanced Procedures and Technical Reference If an analysis is set up using database authentication the username and password for the data source can be stored in the analysis file If it is the credentials specified in the analysis file will supercede the authentication method specified in the web config file If the username and password are not stored in the analysis file the user will be prompted for a username and password The exception is if WebConfig is specified and an existing credentials profile is stored i
171. tion pool running as the pre defined Network Service account we recommend that you run the application pool as a dedicated application pool user account when using delegation To configure this follow the instructions in this section Note For security reasons the application pool account should never be allowed to log in to the Spotfire Server This can be prevented by making sure that the account is not synchronized with the Spotfire Server Create a Dedicated User Account The first step is to create a dedicated user account on the Domain Controller Creating the Dedicated User Account Select Start gt Administrative Tools gt Active Directory Users and Computers In the Active Directory Users and Computers area locate the organizational unit where you want to create the account Select the organizational unit right click and then select New gt User Type Full name and User logon names and then click Next TIBCO Spotfire Web Player 7 0 43 129 Install Spotfire Web Player Comment We recommend that you use the same value for the Full name the User logon name and the User logon name pre Windows 2000 fields Comment The First name Initials and Last name field values are insignificant in this scenario In the following screen use these settings e Clear User must change password at next logon e Select Password never expires e Select User cannot change password e Clear Account is disabled Click
172. u have selected the appropriate settings click Next and then in the Confirmation page click Install 9 When the installation completes the Installation Results page appears click Close Before You Begin Server Roles Web Server IIS Role Services Confirmation Progress The following roles role services or features were installed successfully o Installation succeeded Web Server IIS The following role services were installed Web Server Common HTTP Features Static Content Default Document Directory Browsing HTTP Errors Application Development ASP NET NET Extensibility ISAPI Extensions ISAPI Filters Health and Diagnostics HTTP Logging Request Monitor Security Basic Authentication Windows Authentication Request Filtering Performance Print e mail or save the installation report 10 Start the IIS Manager TIBCO Spotfire Web Player 7 0 23 129 Prerequisite Installation 11 12 13 2 2 2 In the navigation pane select the server top node and then select ISAPI and CGI Restrictions 5 CE MyServer raver a 39 v SE UW AN PUTUUpLYy Area E X 2 Application Pools ASP NET E 6 Sites Z H Q Default Web site g N w H DxpWeb_UH z EN NET NET NET Error NET NET Trust Application Authorizati Compilation Pages Globalization Levels Settings im We Connection Strings zE amp A Machine Key Pages and Providers Session State SMTP E mail
173. ue showClose true showToolBar true showAnalysisInformationTool true showExportFile true showExportVisualization true showUndoRedo true showDodPanel showFilterPanel s s s a s howPageNavigation true howStatusBar true howPrint true llowRelativeLinks false howAuthor true gt lt customHeader enabled false fileName Header htm height 40 gt lt closedAnalysis showOpenLibrary true showReopenAnalysis true redirectToLibrary true gt lt errorPage showOpenLibrary true showReopenAnalysis true gt lt serverUnavaliable showOpenLibrary true showReopenAnalysis true gt lt userInterface gt lt l KEKKKKKKKKKKK KK KK KK KK KK KK KK KK KK KK KK KK KK KK KK KKKKKKKKKK KK KK KKK This section contains setting for tuning performance Be careful when making changes gt lt performance gt lt documentCache purgelInterval 300 itemExpirationTimeout 00 00 00 gt lt analysis checkClosedInterval 60 closedTimeout 120 TIBCO Spotfire Web Player 7 0 67 129 Advanced Procedures and Technical Reference checkInactivityInterval 300 inact ivityTimeout 02 00 00 regularPollChangesInterval 500 maxPollChangesInterval 3000 pollLoadInterval 1000 needsRefreshInterval 15 toolTipDelay 1000 antiAliasl Enabled true useClearType true documentStateEnabl d true undoRedoE
174. very for instance 30 minutes an update is to be made The other is to use event driven updates which means that the update is triggered not by passed time but by a message sent from a web service or TIBCO Enterprise Message Service To enable event driven updates enable scheduled updates Then apply the appropriate event driven update settings to the web config file Edit the Configuration File on page 88 and configure and start the keep alive service See Configure and Start the Keep Alive Service on page 94 Note For information on TIBCO Enterprise Message Service and details on how to set it up please refer to the TIBCO Enterprise Message Service User s Manual Workflow for Scheduled Updates 1 An analyst works with TIBCO Spotfire She creates an analysis that shows the sales results for the previous day The data in this analysis comes from an information link which she has created This information link opens data from a database table which is updated each midnight with the sales data for the day that has passed She saves this analysis in the Spotfire Library Note The data does not have to come from an information link but can come from any linkable data source TIBCO Spotfire Web Player 7 0 85 129 Advanced Procedures and Technical Reference 2 The administrator of the TIBCO Spotfire Web Player server receives a call from the analyst asking him to set up a scheduled update for the analysis file s
175. vices ETA A C Active Directory Domain Services application infrastructure C Active Directory Federation Services J Active Directory Lightweight Directory Services C Active Directory Rights Management Services C Application Server C DHCP Server C DNS Server C Fax Server File Services C Network Policy and Access Services O Print Services C Terminal Services C UDDI Services V Web Server IIS C Windows Deployment Services C Windows Server Update Services Progress Results More about r e e ee Comment Ifa prompt for Add features required for Web Server IIS appears click Add Required Features and then click Next TIBCO Spotfire Web Player 7 0 21 129 Prerequisite Installation 6 Inthe Web Server IIS page click Next Add Roles Wizard Introduction to Web Server IIS security simplified diagnostics and delegated administration Things to Note when there are multiple roles on this Web servers are computers that have specific software that allows them to accept requests from dient computers and return responses to those requests Web servers let you share information over the Internet or through intranets and extranets The Web Server role indudes Internet Information Services IIS 7 0 a unified Web platform that integrates IIS 7 0 ASP NET and Windows Communication Foundation IIS 7 0 also features Using Windows System Resource Manager WS
176. with default value Explanation 10 lt applicationSettings gt lt Spotfire Dxp Internal Properties Settings gt ManifestDownloadTimeout Milliseconds Specify the manifest download time in milliseconds This is the time the application waits before aborting an operation when the server does not respond The default value is 60000 LibraryCache Enabled Specify if caching of metadata for items in the library is enabled Since metadata is retrieved from the cache instead of from the server caching reduces the number of web service calls to the server The cache is unique for each user Enabling this is especially useful if the users are logged in anonymously to the Spotfire Web Player as they are all technically logged in as the same user The default value is true Note If you are using scheduled updates you should set this value to false LibraryCache MaxCacheTime lt Spotfire Dxp Data Properties Sett ings gt DataBlockStoragelOS1izeKB Specify the length of time in the format HH MM SS for metadata to be cached Default value is ten minutes 00 10 00 Modify this setting to improve write performance on your Spotfire Web Player server with a RAID enabled storage systems Set the value of this setting in KB to twice the RAID stripe in KB Default value is 64 Note You must enable the RAID write cache on the server DataOnDemand_ MaxCacheTime Specify the length of time
Download Pdf Manuals
Related Search
Related Contents
Machine à glace en cubes type ACM 45 User`s Manual Benutzerhandbuch Manuel d`utilisation Pfister R89-8DC0 Installation Guide ThermalStrike Manual (single page display) Deutsch - Linksys Energy Sistem Extra Battery Copyright © All rights reserved.
Failed to retrieve file