How Are Agents Used?

Configuring and Managing Agents 19-7

19.3.3.2 E-Mail Scheduler Configuration Settings That Affect Agents

CertificateFileNa me Specifies the SSL Certificate File Path. This setting supports SSL. NA CertPrivateKeyFil eName Specifies the SSL Certificate Private Key File. This setting supports SSL. NA PassphraseFileNa me Specifies the SSL File Containing Passphrase. This setting supports SSL. NA PassphraseProgra mName Specifies the SSL Program Producing Passphrase. This setting supports SSL. NA CertificateVerifyD epth Specifies the SSL Certificate Verification Depth. NA CACertificateDir Specifies the CA Certificate Directory. This setting supports SSL. NA CACertificateFile Specifies the CA Certificate File. This setting supports SSL. NA TrustedPeerDNs Specifies the SSL Trusted Peer DNs. NA VerifyPeer Specifies whether to verify the peer. This setting supports SSL. false CipherList Specifies the Cipher List. This setting supports SSL. NA ScriptRPCPort Specifies the port used for interprocess communication between the script processes and the Oracle BI Scheduler process. This port accepts connections only from the same computer on which Oracle BI Scheduler is running. 9707 Table 19–3 E-Mail Scheduler Configuration Settings That Affect Agents Element Description Default Value SmtpCipherList Specifies the list of ciphers that match the cipher suite name that the SMTP server supports. For example, RSA+RC4+SHA. For information, see Advanced SSL Configuration Options in Oracle Fusion Middleware Security Guide for Oracle Business Intelligence Enterprise Edition. NA UseStartTLS Ignored unless UseSSL is true. If UseStartTls is true, then use the STARTTLS option RFC 2487 for the SMTP session. Initial connection is through an unsecured link, usually port 25. The connection is then promoted to a secure link using the STARTTLS SMTP command. If UseStartTls is false, then a secured connection is created immediately, before the SMTP protocol is started. This is also known as SMTPS. SMTPS typically uses port 465. true Table 19–2 Cont. General Scheduler Configuration Settings That Affect Agents Element Description Default Value 19-8 System Administrators Guide for Oracle Business Intelligence Enterprise Edition

19.3.3.3 Agent Scheduler Configuration Settings

Agents are functionally a combination of data that is stored in Oracle BI Presentation Services and Oracle BI Scheduler. The elements in the Scheduler instanceconfig.xml file describe the behavior of all agents that run on a specific Oracle BI Scheduler. Table 19–4 describes each agent configuration element. Table 19–4 Agent Scheduler Configuration Settings Element Description Default Value Log_Dir Agents can create log files if exceptional error conditions occur. Log_Dir specifies the directory where these files are saved. The directory must be accessible to the Oracle BI Scheduler server. In Windows, the default installation runs the service as a system account, which prevents Oracle BI Scheduler from writing to or reading from network directories. If you put script files on network shares, or your scripts access network shares, then Oracle BI Scheduler must be run as a network user. For example: For information about log files, see Section 8.5.6, Diagnosing Issues with Agents. ibots LogPurgeDays Specifies the number of days after which old agent logs are deleted automatically. To prevent old logs from being deleted automatically, set the value to 0 zero. 7 NumGlobalRet ries A Web or mail server that has too many people logged on might reject new connections, including connections from Oracle BI Scheduler. To cope with such overload, an agent retries the connection. This element sets the maximum number of retries to obtain global information about what to deliver and to whom before the agent gives up. If you set this value to 0 zero, then no retries are attempted. 2 MinGlobalSlee pSecs Specifies the minimum number of seconds that the agent randomly sleeps after its connection is refused before it attempts to reconnect to the server to obtain global information about what to deliver and to whom. 3 MaxGlobalSlee pSecs Specifies the maximum number of seconds that the agent randomly sleeps after its connection is refused before it attempts to reconnect to the server to obtain global information about what to deliver and to whom. 10 NumRequestR etries After an agent has received the global information, it issues a series of unique requests to the server for each user. This element specifies the number of times Oracle BI Scheduler retries its attempts to connect to the server to issue these requests. If you set this value to 0 zero, then no retries are attempted. 3 MinRequestSle epSecs Specifies the minimum number of seconds that the agent randomly sleeps after its connection is refused before it attempts to reconnect to the server to issue requests. 2 MaxRequestSl eepSecs Specifies the maximum number of seconds that the agent randomly sleeps after its connection is refused before it attempts to reconnect to the server to issue requests. 10 NumDelivery Retries After a unique request has executed, the agent tries to deliver the results to specified devices. This specifies the number of times that Oracle BI Scheduler attempts to retry to connect to the server to deliver the results. If you set this value to 0 zero, then no retries are attempted. 4