Differences

This shows you the differences between two versions of the page.

--- qfaq:tutorials_howtos_etc:installing_quickr82 [2010/01/06 15:42] – external edit 127.0.0.1
+++ qfaq:tutorials_howtos_etc:installing_quickr82 [2014/10/12 00:39] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Installing Quickr 8.2 (Services for Domino) on Windows ======
 Detailed instruction how to install Quickr can be found in the [[http://publib.boulder.ibm.com/infocenter/lqkrdom/v8/topic/com.ibm.lotus.quickr.dominov82.doc/install/toc_installing.html|Administrators Guide]].
@@ Line 7: / Line 9: @@
 \\
 \\
-**Install Domino Server**
+===== Install Domino Server =====
     * Install Domino 8.5 (Choose: Enterprise Server) (part number for English version: C1SP7EN)
-    * Install Domino 8.5 Fixpack 1 (you can download it from FixCentral: http://www-933.ibm.com/eserver/support/fixes/fixcentral/swg/identifyFixes/2/Lotus%20Domino/8.5.0.0/Windows)
+    * Install Domino 8.5 HF1039 (you could get this hotfix from support; please open a PMR and mention that you need a fix for SPR# MKIN7TGMQV)
     * Choose to set up HTTP services.
     * Use a Domino server certifier that includes no more than two organizational units (OUs). For example, the certifier /OU=Dallas/OU=Div1/O=Acme is acceptable, but the certifier /OU=Sales/OU=Dallas/OU=Div1/O=Acme is not acceptable. Otherwise the internal names of local users defined in Lotus Quickr places will be truncated and these users will be unable to log in to the server.
@@ Line 18: / Line 21: @@
 \\
-**Adapt Server Document Settings**
+===== Adapt Server Document Settings =====
+Before you start: Be aware that Quickr currently DOES NOT support Internet site documents. So even it might work in general you will face problems during production use. So please don't use Internet site documents with Quickr.
     * From IBM Lotus Notes® or the Domino Administrator, open the Domino Directory (names.nsf) on the server.
     * Open the Server document for the server and click Edit Server.
     * Select "Basics"
-      * * Set "Fully qualified Internet hostname" to the alias you are using for Lotus Quickr (the hostname you are using in the URL later)
+      * * Set "Fully qualified Internet hostname" to the alias you are using for Lotus Quickr (the hostname you are using in the URL later). Do NOT use another host name or an IP address here.
     * Select "Internet Protocols > HTTP"
-      * * In the "Basics" section set the field "Host name" to the alias you are using for Lotus Quickr (the hostname you are using in the URL later)
+      * * In the "Basics" section set the field "Host name" to the alias you are using for Lotus Quickr (the hostname you are using in the URL later). Do NOT use another host name or an IP address here.
       * * In the "Basics" section set the field "Number active threads" to "80".
       * * In the "Mapping" section set "Home URL" to "/LotusQuickr"
@@ Line 36: / Line 41: @@
       * * In the "Character Set" section, select "Yes" in the "Use UTF-8 for output" field.
       * * In the "Web Agents and Web Services" section set "Run web agents and web services concurrently" to "Enabled"
-      * * In the "Web Agents and Web Services" section set "Web agents and web services timeout" to "1800" (or whatever number of seconds the longest running web agents need).
+      * * In the "Web Agents and Web Services" section set "Web agents and web services timeout" to "180" (or whatever number of seconds the longest running web agents need).
 \\
-**Install Quickr**
+===== Install Quickr =====
     * Start the EXE file (part number: CZ2M2EN for English version, CZ34VML for West European Language (French, German, Italian, Portuguese Brazilian, Spanish) version (could be AH10ZML if downloading via Partnerworld), see also [[http://www-1.ibm.com/support/docview.wss?uid=swg24022917|here]] for a complete list) and extract the files to a temporary directory (be sure you remember the directory name)
@@ Line 69: / Line 76: @@
 \\
-**Configure Single Sign On**
+===== Configure Single Sign On =====
-For detailed information how to do this see [[http://publib.boulder.ibm.com/infocenter/lqkrdom/v8/topic/com.ibm.lotus.quickr.dominov82.doc/security/qp_adm_sec_ss_t.html|this chapter]] in the administrators guide.
+For detailed information how to do this see [[http://publib.boulder.ibm.com/infocenter/lqkrdom/v8/topic/com.ibm.lotus.quickr.dominov82.doc/security/qp_adm_sec_ss_t.html|this chapter]] in the administrators guide or check this article: [[http://www-01.ibm.com/support/docview.wss?rs=899&uid=swg21104931]].
 **Important:** You should configure multi-server SSO even if you only have one server! If you do NOT configure MSSO you will see strange behaviours of Quickr (e.g. you will have to re-authenticate when switching pages, you appear to be logged off (although you are not.., you do not see the small arrows where you can choose context sensitive menu options etc.) So this step really has to be done even if you only working with one server.
 \\
 \\
-** Configuring cross-place searching **
+===== Configuring cross-place searching =====
 If you want your users to be able to search all places instead of just the place you have opened you must configure cross-place searching. See [[http://publib.boulder.ibm.com/infocenter/lqkrhelp/v8r0/topic/com.ibm.lotus.quickr.dominov81.doc/config/qp_adm_search_steps_t.html|this chapter]] in admin guide for more detailed information about how to do this.
 \\
 \\
-** Enabling Domino Off-Line Services **
+===== Enabling Domino Off-Line Services =====
 For more detailed information refer to [[http://publib.boulder.ibm.com/infocenter/lqkrhelp/v8r0/topic/com.ibm.lotus.quickr.dominov81.doc/config/qp_inst_off_over_t.html|this chapter]] in the admin guide.
@@ Line 90: / Line 100: @@
 \\
 \\
-** Configure the maximum size for file uploads **
+===== Configure the maximum size for file uploads =====
 See here [[qfaq:tips_tricks_bugs:how_to_configure_the_maximum_file_size_for_uploads|here]] for more details.
 \\
 \\
-** Configure Place Catalog database properties **
+===== Configure Place Catalog database properties =====
 See here [[http://www-10.lotus.com/ldd/lqwiki.nsf/dx/performance-updates-in-quickr-for-domino-placecatalog|for more details]].
@@ Line 102: / Line 114: @@
 \\
 \\
-**Create and edit QPCONFIG.XML in the Domino data directory**
+===== Create and edit QPCONFIG.XML in the Domino data directory =====
 See more detailed information about what can be configured in the QPCONFIG_SAMPLE.XML file located in the Domino data directory. You need to create your own QPCONFIG.XML in the Domino data directory as by default this file does not exist.
@@ Line 109: / Line 122: @@
 \\
 \\
-**Modify NOTES.INI**
+===== Modify NOTES.INI =====
 Add the following entries to the NOTES.INI of your server. Check that you do not have duplicate entries!
@@ Line 167: / Line 181: @@
 ; QuickPlaceWebCacheDir=X:\NEW_CACHE_DIRECTORY
-; Delete old cache entires after 1440 minutes (24h)
+; Delete old cache entires after 60 minutes
-QuickPlaceWebCacheGCIntervalInMIN=1440
+QuickPlaceWebCacheGCIntervalInMIN=60
 ; Increase the size of the cache directory (you can increase that up to 4096 MB if you have enough space on the drive available
@@ Line 192: / Line 206: @@
 ; Increase number of update tasks (a number equal to or one less than your number of CPUs))
 ; UPDATERS=4
+; Use a separate thread to do full text indexing so that long full text indexes don't delay view updates.
+Update_Fulltext_Thread=1
 ; Disable the user/pwd prompts during the create place process
@@ Line 198: / Line 215: @@
 ; QuickPlaceUseDSAPIDNs=1
 ; QuickPlaceNormalizeMemberAliasToLDAP=1
+; For uploading very large files via the Quickr connectors you may need to set the following parameters.
+; Files will then be buffered on disk during upload instead held in memory. Do only use this if really needed.
+; The specified directory should be on a low used drive.
+; You may also need to increase the timeout values on the user workstations.
+; See http://www-01.ibm.com/support/docview.wss?rs=3264&uid=swg21304758 for more details
+; QuickPlaceLargeRequestOnFile=1
+; QuickPlaceLargeRequestDir=X:\BufferDirectory
+; RELS7KNUHE - With versioning enabled, searching for content returns all versions of any document that matches the search criteria.
+h_DisplayNoVersions=1
+; ESEO7XMKW6 - Under certain circumstances when going through a proxy, the download file servlet tries to download via http instead of https
+; h_ServletDownloadForceSSL=1
+; GALI83LL7G - Using a theme that supports expandable folders in the table of contents does not sort according to the selected sort order from the folder options
+LotusQuickrFolderResequence=1
+; Servlet Host - When using a proxy, ip sprayer or load balancer the Quickr servlet may not use the correct host name
+; causing slowness in downloading from the Library or errors while displaying a place.
+; If your Domino Server’s “Fully qualified Internet host name” as specified on the basics tab of the Domino Server’s
+; config is the correct host to access this server, set the following in your notes.ini
+QuickPlaceServletUseDominoHTTPURL=1
+; If your Domino Server’s “Fully qualified Internet host name” is not the host name of this server,
+; you can specify the host name or the ip address in the notes.ini file as follows:
+; QuickPlaceServletForceHostname=https://quickr.server.com
+; QuickPlaceServletForceHostname=http://127.0.0.1
 </code>
@@ Line 206: / Line 253: @@
 \\
 \\
-** Modify the following TCP/IP registry settings on Windows servers**
+===== Modify the following TCP/IP registry settings on Windows servers =====
 <code>
@@ Line 222: / Line 271: @@
 \\
 \\
-** Reboot your Domino server now to activate all the changes**
+===== Reboot your server now to activate all the changes. =====
 \\
 \\
-** Configure Lotus Quickr via the Web UI**
+===== Configure Lotus Quickr via the Web UI =====
   *  Login with the local admin user you specified during installation.
-  *  Define your directory (LDAP / Domino)
+  *  Define your directory (LDAP / Domino). **If you are using LDAP do always use authenticated LDAP.** Even if you think anonymous access should have all the rights it needs: Create a user with read-only access to the LDAP and use authenticated access!
   *  Define who can create places and administer the server
@@ Line 236: / Line 287: @@
 \\
 \\
-**Create program documents for scheduled Domino and Quickr server tasks**
+===== Create program documents for scheduled Domino and Quickr server tasks =====
 By default some QPTOOL commands are scheduled via NOTES.INI entries ("ServertasksAtx="). As each QPTOOL command starts a Java process it needs much resources and you should make sure that only one QPTOOL program runs at a time.
@@ Line 268: / Line 321: @@
 \\
 \\
-** Optional things to do **
+===== Optional things to do =====
   * Configure SMTP mail routing so that notifications from Lotus Quickr can reach the recipients and that mails can be sent to Lotus Quickr places