Open topic with navigation
The DIH configuration file contains several sections that represent different areas that you can configure. For details on all available configuration parameters, refer to the Distributed Index Handler Reference (see Display Online Help).
You can use the
[ACIEncryption] section to encrypt communications between ACI servers and any applications that use the HPE ACI API. For example:
[ACIEncryption] CommsEncryptionType=GSS ServiceName=Kerberos
[AuthorizationRoles] defines roles that enable a particular set of actions for particular clients, SSL identities, and GSS principals. You must create a subsection for each authorization role that you define in the
[AuthorizationRoles] configuration section.
[AuthorizationRoles] 0=AdminRole 1=UserRole [AdminRole] StandardRoles=Admin,Index,ServiceControl Clients=localhost SSLIdentities=admin.example.com [UserRole] StandardRoles=Query,ServiceStatus SSLIdentities=admin.example.com,userserver.example.com
[DistributionIDOLServers] section contains settings that determine the location of the IDOL Servers that the DIH communicates with, and the ports by which this communication takes place. There is a separate
[IDOLServerN] subsection for each child server. The child servers can be IDOL Servers, Content components, or child DIH servers.
If you use date-based indexing, you must also configure
[DateRangeN] subsections to specify the date ranges that each child server indexes.
[DistributionIDOLServers] Number=2 [IDOLServer0] Host=emerson Port=5502 [IDOLServer1] Host=thoreau Port=5602
For non-mirrored systems, you can also create child server groups by specifying more than one child server in a comma-separated list. Each child in the group receives the same data from the parent DIH. For example:
[DistributionIDOLServers] Number=2 [IDOLServer0] Host=DIH1.company.com,DIH2.company.com Port=5502,5702 [IDOLServer1] Host=DIH3.company.com Port=5602
In this example, the DIH distributes data between the three DIH child servers.
DIH2 receive the same data (they are mirrored copies of each other), and
DIH3 receives a different set of data. The child servers can then distribute data between their respective child servers.
If you configure DAH and DIH together in the IDOL Server configuration file, DAH can use the child server groups. However, you cannot also configure virtual databases in the DAH. Refer to the Distributed Action Handler Administration Guide.
[IndexNotify] section contains parameters that control and enable the automatic generation of index job information for a specified host. For example:
[IndexNotify] Host=10.1.1.10 ACIPort=9992 BatchSize=1 BatchTimeout=10000 ConnectRetries=1 ConnectTimeout=5000
[IndexQueue] section contains parameters that control the index queue. For example:
[IndexQueue] IndexQueueInitialSize=30000 IndexQueueMaxHistory=4000 IndexQueueMaxPendingItems=100
[License] section contains licensing details, which you must not change. For example:
[License] Holder=My Company Key=01234567890 Operations=803|87sdhsdf9n94nmsf7oasda987w4yriasunfaasd
[Logging] section lists the logging streams that you set up to create separate log files for different log message types (query, index, and application). It contains a section for each of the listed logging streams, in which you configure the settings that determine how to log each stream. For example:
[Logging] 0=INDEX_LOG_STREAM 1=QUERY_LOG_STREAM 2=APP_LOG_STREAM [INDEX_LOG_STREAM] LogFile=index.log LogDirectory=./logs/DIHIndexLogs LogHistorySize=55 LogTime=True LogEcho=True LogMaxSizeKbs=1024 LogTypeCSVs=index LogLevel=full LogExpireAction=datestamp [QUERY_LOG_STREAM] LogFile=query.log LogDirectory=./logs/DIHQueryLogs LogHistorySize=50 LogTime=True LogEcho=True LogMaxSizeKbs=1024 LogTypeCSVs=query LogLevel=full LogExpireAction=consecutive [APP_LOG_STREAM] LogFile=application.log LogDirectory=./logs/DIHAppLogs LogHistorySize=50 LogTime=True LogEcho=True LogMaxSizeKbs=1024 LogTypeCSVs=application LogLevel=full LogExpireAction=datestamp
The query logs truncate all queries to 4,000 characters.
[Paths] section contains settings that determine where to store index data and other files. For example:
[Paths] Main=./main Incoming=./incoming Archive=./archive Failed=./failedTasks
[RoundRobinMode] section contains settings that control data indexing when you use round robin mode. Use settings in
[DAHServerN] sections to configure the child servers for powerup and shutdown when round robin data indexing rollover occurs. For example:
[RoundRobinMode] ServerImmediateStart=2 NextServerStartTime=00:00 NextServerStartDate=2006/10/20 PeriodInSec=86400 RoundRobinMode=True [DAHServer0] Host=host1 Port=12000 ShutDownEnginePeriods=0,-1 [DAHServer1] Host=host2 Port=13000 StartUpEnginePeriods=-2
[Server] section contains general settings for indexing. For example:
[Server] DIHPort=9001 Port=9002 MirrorMode=True ArchiveMode=True ArchiveFailedTasks=True
[Service] section contains settings that determine which machines have permission to use and control the DIH service. For example:
[SSLOptionN] section contains settings that determine incoming or outgoing SSL connections between the DIH and other servers.
[SSLOption0] SSLMethod=TLSV1.2 SSLCertificate=host1.crt SSLPrivateKey=host1.key [SSLOption1] SSLMethod=TLSV1.2 SSLCertificate=host2.crt SSLPrivateKey=host2.key SSLPrivateKeyPassword=sample1XQ SSLCheckCommonName=True
You must create an
SSLOption section for each unique value set by the
SSLConfig parameter in the
[IDOLServerN] section, or the
[Service] ServicePort=16002 [Server] Port=16000 DIHPort=16001 MirrorMode=True [DistributionIDOLServers] Number=2 [IDOLServer0] Host=localhost Port=5502 [IDOLServer1] Host=localhost Port=5602 [Logging] 0=INDEX_LOG_STREAM 1=QUERY_LOG_STREAM 2=APP_LOG_STREAM [INDEX_LOG_STREAM] LogFile=index.log LogTypeCSVs=index LogHistorySize=50 LogTime=True LogEcho=True LogMaxSizeKbs=1024 LogExpireAction=datestamp [QUERY_LOG_STREAM] LogFile=query.log LogTypeCSVs=query LogEcho=True [APP_LOG_STREAM] LogFile=application.log LogTypeCSVs=application LogEcho=True [Paths] IncomingPath=./incoming LogPath=./logs