cd /usr/local/appx/services
chown root appxAuditMgr
chgrp appxgrp appxAuditMgr
chmod 4775 appxAuditMgr

1. A configuration file (ini) is created
2. An environment file (env) is created
3. A service is created, including required init files and links. ( On Red Hat, /etc/init.d/ )

Method 2 - Text Editor

[root@500test services]# ./appxAuditMgr -status appxLog8070 
up and running (process 2390 servicing port 8070)

[root@500test services]# service appxLog8070 status 
up and running (process 2390 servicing port 8070)

The appxAuditMgr service configuration commands are used to create, configure, and remove an instance of an APPX Audit Log Service.

The -install command is used to configure a new instance of an APPX Audit Log Service. Either form of the install command may be used.

The -replace command is used to replace an existing Audit Log Service with a new Audit Log Service with the same name. The -replace command is effectively the same as a -remove command followed by an -install command. After updating the configuration files, the -replace command restarts the service. Note that when specifying variables on the command line, you must prefix them with a dash if you are referring to settings such as DisplayName, or without a dash if you are referring to environment variables.

The -remove command is used to remove an existing Audit Log Service. The -remove command will remove the configuration files (ini and env) and the corresponding operating system service. If the service is running when the -remove command is executed, the -remove command will first stop the service and then remove the service.

The ServiceName uniquely identifies an APPX Audit Log Service. When creating (installing) an Audit Log Service, the SERVICENAME value may be any string value that conforms to the rules for valid filenames on your server. If this option is omitted when an Audit Log Service is being created, the Audit Log Service will be created with a default ServiceName based on the following template: "appxd-" followed by the specified TCP/IP port number, e.g "appxd-8060".

When the service is started, two log files are created in the LOGDIR directory - an Audit Log Service log file (.log) and a status file (.stat). Both log files have the same name as the ServiceName but one has a file extension of .log and the other has a file extension of .stat. If the LogDirectory option is not specified, the log files are created in the /tmp directory.

The only valid value when configuring an Audit Log Service is "logmonitor". Note: This option must be specified.

This option can be used to temporarily disable or "turn off" the Audit Log Service. If set to true, the Audit Log Service will still run but it will not accept requests to log data from APPX sessions.

Used with -install option to specify the type of operating system that the service script is to be created for. If this option is not specified, appxAuditMgr will determine which type of service script to install.

The LogRotationInterval identifies the maximum time in seconds that an Audit Log file should be used before being closed and a new audit log file is created. The default value of 86400 is the number of seconds in one day so, by default, the Audit Log Service will create a new audit log file each day

The LogRotationSize is the maximum size that an Audit Log file is allowed to be. When an audit log file reaches the specified MAXSIZE, it will be closed and a new audit log file will be created.

Configure the service to listen for audit log requests on the specified TCP/IP PORT number. This option is required with the -install option. You may choose any TCP/IP PORT number that is not reserved or already being used on your system.

VARIABLE=VALUE

You can include a space-separated list of environment variables at the end of the command line when you use the -install option. These environment variables will be saved in the env file that is created. There is currently no reason to use this feature.

appxAuditMgr [-start | -stop | -restart | -status] {SERVICENAME | -serviceName=SERVICENAME}

-start | < blank >

Start an instance of the Audit Log Service using the configuration information in the SERVICENAME.ini and the SERVICENAME.env files.

Stop the instance of the Audit Log Service that was started with the SERVICENAME.ini file.

Restart (stop and then start) the instance of the Audit Log Service that was started with the SERVICENAME.ini file.

Report the status of the instance of the Audit Log Service that was started with the SERVICENAME.ini file.

[root@localhost services]# ./appxAuditMgr -install -name=appxLog8070 -port=8070 -ServiceType=logmonitor
Configuration written to:  appxLog8070.ini
Environment written to:    appxLog8070.env
Service script written to: /etc/init.d/appxLog8070
Configuration complete
Registering service
Starting appxLog8070: serviceName: appxLog8070
servicePath: /usr/local/appx500/services/
Looking for config file in appxLog8070.ini
Writing process ID to /var/run/appxLog8070.pid
running as process 12859 servicing port 8070
up and running (process 12859 servicing port 8070)
Installation Complete

The Configuration File (ini)

# Appx connection manager configuration file
#
#  You can change this file by hand, or
#  use the uappxd program for better results
#
#  blank lines are ignored
#
#  anything following a '#' is treated as a comment
#
#  case is not important on the left-hand side
#  properties whose descriptions end in a '?' are
#  boolean and should be set to true or false
# --------------------------------------------------
# AppxApplication           =                    #startup application for spawned engines
# AppxDatabase              =                    #startup database for spawned engines
AppxExecutable              = /usr/local/appx500/appx#pathname to Appx engine
# AppxProcessName           =                    #startup process name for spawned engines
# AppxProcessType           =                    #startup process type for spawned engines
# AuthenticationMethod      = OS-User            #authentication method (OS-User, Appx-User, HT-User(filename))
DisplayName                 = appxLog8070        #descriptive name
# ImpersonateGID            = true               #change effective grouo ID for spawned engines?
# ImpersonateGroup          = User               #[LogonUser, NamedGroup(groupname), ServiceOwner]
# ImpersonateUID            = true               #change effective user ID for spawned engines?
# ImpersonateUser           = LogonUser          #[LogonUser, NamedUser(username), ServiceOwner]
# LoadSystemEnvironment     = true               #load default system-defined environment variables into spawned engines?
# LogDirectory              = /tmp               #directory where log file should reside
# LogNamePattern            = /tmp/appxlog%N.xml #audit log filename pattern (see man strftime for details
# LogRotationInterval       = 86400              #number of seconds between audit log rotations
# LogRotationSize           = 1G                 #maximum audit log file size
# RequireSSL                = false              #Require SSL-secured connections?
# RequireSSLClientCertificates = false              #require SSL-client certificates?
# ServerCertificateFile     =                    #pathname of server's X509 certificate (leave blank for anonymous connections
# ServerPrivateKeyFile      =                    #pathname of server's private key file (unlocks the ServerCertificateFile)
# ServerPrivateKeyPassphrase =                    #passphrase that unlocks ServerPrivateKeyFile
# ServiceDisable            = false              #disable this service?
# ServiceDisableAppxKeys    = false              #disable keyboard mapping?
# ServiceDisableFMS         = false              #disable AppxNET connections?
# ServiceDisableLogins      = false              #disable interactive logins?
# ServiceEnableCmds         = true               #allow client-side startup options?
ServiceName                 = appxLog8070        #name of service
ServiceType                 = logmonitor         #service type (login or logmonitor)
SockPort                    = 8070               #port number to service
# SSLMode                   = Optional           #SSL connection type (optional, required, disabled)
# TCPEnableKeepAlive        = true               #Enable TCP dead-connection detection
# TCPKeepCount              = 8                  #Maximum number of keep-alive pings
# TCPKeepIdle               = 300                #Idle time before ping sent to client (in seconds)
# TCPKeepInterval           = 60                 #Interval between keep-alive pings
# TCPNoDelay                = true               #disable TCP packet filling delay?
# TrustedCAFile             =                    #determines which client certificates to trust
# Umask                     =                    #umask (file creation mask) given to spawned engines

The Environment File (env)

# Appx connection manager environment variables

The Status File (stat)

appxLog8070 running as process 8665

*Daemonize = true

Red Hat service command.

Usage (service)

Synopsis - service Command

service [serviceName] [start|stop|restart|status]

Examples:

Warnings:

Enhancement Suggestions

LogNamePattern = /tmp/appxlog%N.xml

/tmp/appx-11-Jun-08

kill -s SIGUSR1 <PID>

where PID is a process ID of the audit log listener. Existent log will be closed and rotated to the next one.

Microsoft XML Notepad

Web Browser

xslt

NOTES:

If log file is not closed/rotated properly, Internet Explorer will display your .xml file, but it will show an error at the end of the file saying "File not closed". Firefox, however, will throw an error and won't display file at all

In Linux, the way to close log and rotate it is to issue kill -s SIGUSR1 PID command.

How to close and rotate the log in Windows?