How to redirect iProcess log files to another location

How to redirect iProcess log files to another location

book

Article ID: KB0083223

calendar_today

Updated On:

Products Versions
TIBCO iProcess Engine (Oracle) 11.4.0 and above
TIBCO iProcess Engine (DB2) 11.4.0 and above

Description

I need to move the iProcess logs files to another location / filesystem. How can I configure iProcess to write logs to a new location?

Environment

TIBCO iProcess Engine (Oracle) 11.4.0 and above TIBCO iProcess Engine (SQL) 11.4.0 and above TIBCO iProcess Engine (DB2) 11.4.0 and above All platforms

Resolution

The TIBCO iProcess Engine creates different logs files, some for the Engine itself and others for additional (optional) plug-ins or Java components.

1). iProcess Engine
     The alternative log file location can be specified in line 19 of the iProcess configuration file SWDIR/etc/staffpms .
     If the line is blank then the default logs file location is used (SWDIR/logs).
     If you specify an alternative location then please ensure that the iProcess user and group has write access to the new location.


2). iProcess Business Studio Deployment JMX Server.
    The iProcess RPC_TCP_LI process starts a JMX Server (Java) for the Business Studio Deployment Server.

    The log file location is configured in the file SWDIR/etc/swjmx_log4j.properties .
    Amend the following line with the new log file path:
        log4j.appender.SWJMX.File=../logs/swjmx_java.log
    The location can be specified using an absolute or relative path.

3). iProcess IAPJMS.
    The IAPJMS process is optional. Only applies when the  IAPJMS process is enabled in the engine.
    The IAPJMS process uses Java code to publish messages to a JMS server.

    The log file location is configured in the file SWDIR/etc/iapjms_log4j.properties
    Amend the following line with the new log file path:
        log4j.appender.IAPJMS.File=../logs/iapjms_java.log
    The location can be specified using an absolute or relative path.

4). iProcess EAIJAVA logs.
    Optional. Only applies if the TIBCO iProcess Technology Plugins have been installed.
    The plugins utilizes Java code to run EAI_JAVA, EAI_BW and EAI_TRANSFORM steps.

    The log file location is configured in the file SWDIR/eaijava/log4j.properties
    Amend the following line with the new log file path:
        log4j.appender.EAIJAVA.File=/staffware/installs/ipe/phil1150/logs/eaijava.log
    The location can be specified using an absolute or relative path.

5) iProcess Web Services Plug-in.
    This is optional and only apples if the iProcess Web Services Server Plugin is installed.
    The plugin runs in a Jetty server that communicated with the iProcess Engine.
    The log file location is configured in the file WEBSERVICE_HOME/jetty-6.1.25/tibco/log4j.properties
    Amend the following line with the new log file path:
        log4j.appender.EAIJAVA.File=/staffware/installs/ipe/iPEWebServicesPlugIn1160web/jetty-6.1.25/tibco/log.txt

NOTE: On a Unix platform the stdout and stderr for each iProcess process is still written to files under SWDIR/logs/process.

Issue/Introduction

I need to move the iProcess logs files to another location / file system. How can I configure iProcess to write logs to a new location?