Professional Documents
Culture Documents
IG 4 Directory Structure Manual r1.00
IG 4 Directory Structure Manual r1.00
This guide covers the directory structures, logs and other files found in IG 4
gateway’s SSH-accessible directory. It is intended for administrators who
need to view the logged events occurring in IG 4 to determine operational
status, generate usage reports or make low-level configuration changes to
some of the installed modules.
DISCLAIMER
No part of this manual may be copied, distributed, transmitted,
transcribed, stored in a retrieval system or translated into any human
or computer language, in any form or by any means, electronic or
otherwise, without the express written permission of ANTlabs.
RELATED DOCUMENTATION
Also, please include the chapter, section and/or page number when referring
to specific portions of the document.
1.1 Overview
IG 4 maintains a directory containing various logs, reports and configuration
files used and generated by the gateway. Administrators with valid credentials
can login to the IG 4 gateway’s SSH server and download the files available.
backup
config
reports
log
acc
ftp
login
mail
php
pms
smpp
system
patch
user
web
login
messages
templates
resources
Be sure that the SSH program and text editor do not change the Unix-
formatted text file and line endings. Avoid using text editors like
Notepad that support only Windows line endings.
2.1 backup/config
These configuration backup files can be downloaded from this directory for
archival. In addition, configuration backup files can be uploaded into this
directory for restoring the configuration via the web admin GUI.
2.2 backup/reports
2.2.1 admin_audit_log.csv
This is a log containing details of admin audit entries.
Header row:
"29/09/2015 02:39PM","root",Success,Remote
Access,"Modify Remote Access configuration","1: SSH
Enabled"
"29/09/2015 02:39PM","root",Success,Remote
Access,"Modify Remote Access configuration","1: SSH
Enabled"
Header row:
00:13:E0:F8:D2:FB,10.46.0.101,"location","30/09/2015
23:49PM","30/09/2015 23:53PM","30/09/2015
23:51PM","30/09/2015 23:53PM","1 mins 37 secs"
00:18:41:5D:3E:F6,10.46.0.93,"location","30/09/2015
23:47PM","30/09/2015 23:57PM","30/09/2015
23:48PM","30/09/2015 23:57PM","8 mins 32 secs"
00:1C:A4:70:35:DD,10.46.0.90,"location","30/09/2015
23:46PM","30/09/2015 23:57PM","30/09/2015
23:50PM","30/09/2015 23:57PM","7 mins 30 secs"
2.2.3 session_log.csv
Logs details of successful login attempts made by users.
Header row:
Header row:
2.4 cc_status.csv
Logs Credit card billing status generated for guests’ network access.
Header row:
"13/05/2015
02:09PM","22","V19A1D1F9A73","00:0E:35:E5:4E:D4","10.10.1.
241","210 (VLAN 210)","Fixed Duration 6 hours","Paypal
Payflow Pro","Transaction Completed",""
"13/05/2015
11:49AM","20","","00:0E:35:E5:4E:D4","10.10.1.241","210
(VLAN 210)","Fixed Duration 6 hours","Paypal Payflow
Pro","Transaction Error",""
"13/05/2015
11:45AM","18","","00:0E:35:E5:4E:D4","10.10.1.241","210
(VLAN 210)","Fixed Duration 6 hours","Paypal Payflow
Pro","Transaction Started",""
"13/05/2015
11:28AM","12","0","00:0E:35:E5:4E:D4","10.10.1.241","210
(VLAN 210)","Fixed Duration 6 hours","Authorize.Net
SIM","Transaction Completed",""
"13/05/2015
11:25AM","11","V78A1BD863E8","00:0E:35:E5:4E:D4","10.10.1.
241","210 (VLAN 210)","Fixed Duration 6 hours","Paypal
Payflow Link","Transaction Completed",""
"12/05/2015
06:27PM","3","","00:30:1B:3A:3F:E3","10.10.1.250","10
(VLAN 10)","Fixed Duration 6 hours","Worldpay Select
Junior","Transaction Started",""
3.1 acc/acc.log
Logs events generated by the account printer module.
Sample entries:
3.2 ftp/xferlog
Contains logging information from the FTP server daemon, each server entry
is composed of a single line of the following form, with all fields being
separated by spaces:
current-time transfer-time remote-host file-size filename transfer-
type special-action-flag direction access-mode username service-
name authentication-method authenticated-user-id completion-status
3.3 login/tcpd.log
Logs the time and IP address of logins to the IG 4 gateway’s ssh remote
access services.
Sample entries:
3.4 mail/maillog
Logs generated by the qmail SMTP daemon running in IG 4.
3.7 system/ant_ha_auto_sync.log
Logs generated by high availability synchronizations between the primary and
secondary gateways. Only applicable when two IG 4 gateways are paired for
high availability.
Sample entries:
3.9 system/dhcp_events.log
Logs generated by IG 4 for the following DHCP events:
DHCPDISCOVER
DHCPOFFER
DHCPREQUEST
DHCPACK
DHCPRELEASE
DHCPINFORM
DHCPNAK
3.10 system/events.log
Logs generated by downstream client events.
Sample entries:
Sample entries:
3.12 user/user_maintenance.log
Logs generated by IG 4 when user account purging is activated. User details
such as the plan, user ID, validity and login limit are listed.
Sample entries:
Sample entry:
The messages directory contains the various message files that can be
customized in the system.
4.1 blocked.ant
Customizable html/php file displayed to user who are denied access to the
network.
4.2 ph41l.ant
Customizable html/php file displayed when there is an unexpected
configuration error with the gateway.
4.3 location.ant
Customizable html/php file displayed when the location policies are not
configured.
4.4 svc_failure.ant
Customizable html/php file displayed when the user’s login policies cannot be
applied. The possible reasons for this error are database issues or high
system load.
5.1 account-receipt-template.php
This is a non-modifiable default template file for the account receipt that is
displayed when invoking the print function after generating user accounts in
the web admin.
<html>
<head>
<title>Receipt</title>
<style type="text/css">
body, th, td {
font-family: Helvetica, Arial, sans-serif;
font-size: 80%;
}
table {
border-collapse: collapse;
margin: 1em 0;
}
th, td {
border: 1px solid grey;
padding: 0.3em;
}
</style>
</head>
<body onload="print()">
<h1>Receipt</h1>
<p>The following user accounts have been created:</p>
<?php printHeaders(); ?>
<?php printUseridTable(); ?>
<?php printCodeTable(); ?>
</body>
</html>
5.2 account-receipt.php
This html/php file is fully customizable. The 3 items to include in the file are: