Configuration

Configuration

Together Teamlösungen EDV-Dienstleistungen GmbH

Elmargasse 2-4
A-1190 Vienna
Austria
Phone: +43 (0) 5 04 04 - 122
Fax: +43 (0) 5 04 04 - 11 122
E-Mail: 
Web: http://www.together.at/together/index.html

All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, photocopying, recording or otherwise, without the prior written permission of the Together Teamlösungen EDV-Dienstleistungen GmbH.

Together Teamlösungen EDV-Dienstleistungen GmbH DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.


Table of Contents

Configuration

List of Tables

1. 'Together Search Server Admin' application configuration
2. 'Together Search Server' (search) application configuration
3. 'Together Document Viewer'application configuration

Table of Contents

Configuration

Configuration

'Together Document Viewer' and 'Together Search Server' are without database dependency. Configuration prooceess uses configuration files placed in 'tss-resources' directory to configure definition of 'Sites'. List of files placed in 'tss-resources' direcotry :

  1. 'configuration_shema.xsd', represent the schema of ‘siteConf.xml’configuration file.

  2. 'siteConf.xml', represent the shared configuration file that will configure applications. (Path to the configuration file is defined in ‘web.xml’file of the applications).

  3. 'documentGroupFile.xml', represent the default document group file list, that will be used by configuration process in case that ‘DOCUMENTGROUPLIST’ is not defined in configuration file(‘siteConf.xml’) for all sites.

This table contains the configuration options for the 'Together Search Server Admin' application. Values of 'Together Search Server Admin' configuration parameters are contained in XML documents (not in *.conf files).

Table 1. 'Together Search Server Admin' application configuration

AttributeDescription
IndexDirFolder where the indexes are stored (“C:\index” by default)
SearcherFactoryClassNameWrapper class used for searching
IndexerFactoryClassNameWrapper class used for indexing
LoggingManagerClassNameLogging implementation class
role-nameBy default, this value is set to 'admin'. It is defined in Tomcat's tomcat-users.xml file ('%together_application_server_root%/conf)'. In order to change this role(username/password), it has to be changed in tomcat-users.xml. Please refer to Tomcat's documentation to for more info.
MaxFieldLengthMaximal field length (in bytes) of the document contents field (being indexed) (10000 by default)
MaxIndexLengthSize (in bytes) of the index file after which a server issues a message: “INDEX GREATER THAN...” (1GB by default)
LogicalnameFromDatabase0/1 – If 1 the value from a metadata(if available) table will be used for document title
DocumentLogicalNameMetadata table’s key column’s value describing document title
DocumentUpdateMetadata table’s key column’s value describing document modification date.
DocumentUpdatePatternThis parameter represents tha pattern of the modification date in column value.
DBFetchSizeFetch size to be used during calls to metadata, include list and exclude list table queries
TempDirUsed in 'Together Search Server Admin' application. Temporary directory where zip files will be unpacked into temporary files, parsed and deleted. Default value is user home directory +/.snapperTemp directory.
RelativeIndexPathIf you want to use one index file on different server locations and/or operating systems (e.g. Windows/Linux) you should use index file which contains relative file paths for each Document (relative to index root). If you set this parameter to true, you can move your index files if you change index root path in database. Possible values:true/false. Default value: false
FileSeparatorPossible values for this parameter is system-dependent (default value), and unix. If unix value is set, 'Together Search Server Admin' and 'Together Search Server' will use / as a File separator for all paths in database and in index files.
Indexer.MountTitleInContentPossible values for this parameter is 'false'(default value) and 'true'. If value is 'true', 'Together Search Server Admin' will mount title of the document on the begining of the persed text (content).
Indexer.MountFilePathInContentPossible values for this parameter is 'false'(default value) and 'true'. If value is 'true', 'Together Search Server Admin' will mount File path of the document on the begining of the persed text (content).
Indexer.MountPropertiesInContentPossible values for this parameter is 'false'(default value) and 'true'. If value is 'true', 'Together Search Server Admin' will mount properties of the document on the begining of the persed text (content).
Indexer.MountMetaDataInContentPossible values for this parameter is 'false'(default value) and 'true'. If value is 'true', 'Together Search Server Admin' will mount meta data of the document on the begining of the persed text (content).
ForceIndexUnlockPossible values for this parameter is 'false'(default value) and 'true'. If value is 'true', 'Together Search Server Admin' will unlock index files before updating index. It is dangerous option if more users update index at the same time.
MaxPropertiesLengthMaximal properties length of the document that will be indexed in propertie field (5000 by default)
Indexer.ReIndexModePossible values for this parameter is 'true'(default value) and 'false'. If value is 'true', 'Together Search Server Admin' will continue with index process from last indexed file, or start from beginning if index process is finished before . If value is 'false' every click on index button will start index process from beginning(previously behavior).
DocumentGroupConfFileThis parameter represnt the path to the default definition of Document group list file . Default value of this parameter is '/tss-resources/documentGroupConf.xml', relative path to the <catalina.base> (<together_application_server_rootr>/multiserver). Note : DocumentGroupConfFile can be defined as absolut file path.
SiteConfFileThis parameter represent the path to the default definition of Sites . Default value of this parameter is '/tss-resource/siteConf.xml', relative path to the <catalina.base> (‘<Enhydra-7.0-dir>/multiserver). Note : SiteConfFile can be defined as absolute file path.
StatisticActivePossible values for this parameter is 'false'(default value) and 'true'. If value is 'true', 'Together Search Server Admin' will try to acces the StatisticDirectory to read and show statistc information.
StatisticDirectoryThis parameter represnt the path to the StatisticDirectory where statistic files are placed. Note : this parameter must have the same value as in 'Together Search Server'' application coniguration file.
IndexOSspecificPossible values for this parameter is 'false'(default value) and 'true'. If value is 'true', 'Together Search Server Admin' will access system specific resources through 'Java Native Interface' to collect additional information about the file (creation and last access time) . Note : Win32File.dll or libLinuxFile.so must be placed on the 'java.library.path'. By default they are placed in '<tas-dir>/multiserver/bin' directory.
Parser.Excel.ConverterClassNamePossible value for this parameter is 'org.enhydra.snapper.parsers.fileparsers.parsers.excelparser.ExcelToText' (default value) . 'Together Search Server Admin' will store pure text in index.
Parser.PowerPoint.ConverterClassNamePossible value for this parameter is 'org.enhydra.snapper.parsers.fileparsers.powerparser.PowerToText'. (default value) . 'Together Search Server Admin' will store pure text in index.
Parser.Word.ConverterClassNamePossible value for this parameter is 'org.enhydra.snapper.parsers.fileparsers.wordparser.WordToText'. (default value) . 'Together Search Server Admin' will store pure text in index.
SaveConvertedFilePossible values for this parameter is 'true'(default value) and 'false'. If value is 'true', 'Together Search Server Admin' will if Converter has ability to convert file to html form be saved to file sistem.
PathOfConvertedFilesFolder where the converted 'html' files will be stored.

Table 2. 'Together Search Server' (search) application configuration

AttributeDescription
IndexDirFolder where the indexes are stored (“C:\index” by default)
SearcherFactoryClassNameWrapper class used for searching
LoggingManagerClassNameLogging implementation class
Xsl.DirectoryFolder the xsl filed used for search result representation are stored
MaxRangeRestricts the maximum number of documents that can be displayed per results page. This parameter is used as assurance, in case of large number of search result per one page.
RelativeIndexPathIf you want to use one index file on different server locations and/or operating systems (e.g.Possible values for this parameter is 'true'(default value) and 'false'. If value is 'true', 'Together Search Server Admin' will continue with index process from last indexed file, or start from beginning if index process is finished before . If value is 'false' every click on index button will start index process from beginning(previously behavior). Windows/Linux) you should use index file which contains relative file paths for each Document (relative to index root). If you set this parameter to true, you can move your index files if you change index root path in database. Possible values:true/false. Default value: false. Use the same value as in admin application.
FileSeparatorPossible values for this parameter is system-dependent (default value), and unix. If unix value is set, 'Together Search Server Admin' and 'Together Search Server' will use / as a File separator for all paths in database and in index files. Use the same value as in admin application.
PreviewURLURL where 'Together Document Viewer' application where installed and where 'Together Document Viewer' request should be sent. Default is http://localhost:8080/tdv/ Preview.po. It is URL used for building preview link (previewURL + preview parameters)
GoogleSearcherURLThis parameter represent the url of the google web service.
GoogleSearcherKeyThis parameter represent the key that is used by the google web service to recognize the user. To access the Google Web APIs service, you must have a Google Account and obtain a license key. Your Google Account and license key entitle you to 1,000 automated queries per day.
GoogleResultLimitThis parameter represents the number of google search result displayed in result page. The maximum value is 10 result per page (Restriction by google web service).
SearchDatePatternThis parameter represents the pattern of 'Modified' input field (document attribute) in advanced search. Possible values are : 'yyyyMMdd', 'dd.MM.yyyy', 'yyyy.MM.dd', 'yyyy-MM-dd' and 'dd-MM-yyyy'. Default value is 'yyyyMMdd'!
ResultDatePatternThis parameter represent the pattern of 'Modified' date in search result. Posible values are : 'dd.MM.yyyy', 'yyyy.MM.dd', 'yyyy-MM-dd' and 'dd-MM-yyyy'. Default value is 'yyyy.MM.dd',
DocumentGroupConfFileThis parameter represent the path to the default definition of Document group list file . Default value of this parameter is '/resource/documentGroupConf.xml', relative path to the <catalina.base> (‘<Enhydra-7.0-dir>/multiserver). Note : DocumentGroupConfFile can be defined as absolute file path.
SiteConfFileThis parameter represent the path to the default definition of Sites . Default value of this parameter is '/resource/siteConf.xml', relative path to the <catalina.base> (‘<Enhydra-7.0-dir>/multiserver). Note : SiteConfFile can be defined as absolute file path.
StatisticActivePossible values for this parameter is 'false'(default value) and 'true'. If value is 'true', 'Together Search Server' will log statistic information.
StatisticDirectoryThis parameter represnt the path to the StatisticDirectory where statistic files are placed. Note : this parameter must have the same value as in 'Together Search Server Admin' application coniguration file.
ReReadConfigFilesEveryMinutesConfiguration files are rereaded by default every 5 minutes.

Table 3. 'Together Document Viewer'application configuration

AttributeDescription
SearcherFactoryClassNameWrapper class used for searching
LoggingManagerClassNameLogging implementation class
Xsl.DirectoryFolder the xsl filed used for search result representation are stored
ParserPageLimitThis parameter represent the number of pages in the document that will be parsed. Default value is '0'. If value of this parameter is '0' no limit will be performed (complete document will be parsed).
PageLimitForParserThis parameter represent the list of parsers that will use the parameter 'ParserPageLimit'. Default value is 'pdf'. Only PDF parser support parameter 'ParserPageLimit'.
ParserCharacterLimitThis parameter represent the limit of characters in the document that will be parsed. Default value is '0'. If value of this parameter is '0' no limit will be performed (complete document will be parsed).
CharacterLimitForParserThis parameter represent the list of parsers that will use the parameter 'ParserCharacterLimit'. Parsers that support parameter 'ParserPageLimit' are : Microsoft Excel parser ( value : 'xls') , Message parser ( value : 'msg'), Open office parser ( value : 'oo') , Microsoft Power Point parser ( value : 'ppt'), Rich text documents parser ( value : 'rtf') and Text parser ( value : 'txt').
DocumentGroupConfFileThis parameter represent the path to the default definition of Document group list file . Default value of this parameter is '/resource/documentGroupConf.xml', relative path to the <catalina.base> (‘<Enhydra-7.0-dir>/multiserver). Note : DocumentGroupConfFile can be defined as absolute file path.
SiteConfFileThis parameter represent the path to the default definition of Sites . Default value of this parameter is '/resource/siteConf.xml', relative path to the <catalina.base> (‘<Enhydra-7.0-dir>/multiserver). Note : SiteConfFile can be defined as absolute file path.
ReReadConfigFilesEveryMinutesConfiguration files are rereaded by default every 5 minutes.
PathOfConvertedFilesFolder where the converted 'html' files are stored.
ReadConvertedFilePreview of 'Excel' files can be done from index (pure text) (parameter value 'false'), or if the Excel file is converted during index proces then converted (HTML file from file system) will be displayed.
Parser.Excel.ConverterClassNamePossible value for this parameter is 'org.enhydra.snapper.parsers.fileparsers.parsers.excelparser.ExcelToText' (default value) .
Parser.PowerPoint.ConverterClassNamePossible value for this parameter is 'org.enhydra.snapper.parsers.fileparsers.parsers.powerparser.PowerToText'. (default value) .
Parser.Word.ConverterClassNamePossible value for this parameter is 'org.enhydra.snapper.parsers.fileparsers.parsers.wordparser.WordToText'. (default value) .