src/billing/cisco_h323_db_schema-postgres.sql

   1 /*
   2  * Id: postgresql.conf,v 1.8.2.11 2003/07/15 11:15:43 pnixon Exp $
   3  *
   4  * --- Peter Nixon [ codemonkey@peternixon.net ]
   5  * This is a custom SQL schema for doing H323 and SIP VoIP accounting with FreeRadius
   6  * and Cisco equipment. It is currently known to work with 3640, 5300 and 5350 series
   7  * as well as CSPS (Cisco SIP Proxy Server).
   8  * It will scale ALOT better than the default radius schema which is designed for
   9  * simple dialup installations of FreeRadius.
  10  *
  11  * For this schema to work properly you MUST replace raddb/postgresql.conf
  12  * with the contents of pgsql-voip.conf
  13  *
  14  * If you wish to do RADIUS Authentication using the same database, you must use
  15  * src/modules/rlm_sql/drivers/rlm_sql_postgresql/db_postgresql.sql as well as
  16  * this schema.
  17  *
  18  */
  19
  20 /*
  21  * Table structure for 'Start' tables
  22  */
  23
  24 CREATE TABLE StartVoIP (
  25         RadAcctId               BIGSERIAL PRIMARY KEY,
  26         AcctTime                TIMESTAMP with time zone NOT NULL,
  27         h323SetupTime           TIMESTAMP with time zone,
  28         H323ConnectTime         TIMESTAMP with time zone,
  29         UserName                VARCHAR(64),
  30         RadiusServerName        VARCHAR(32),
  31         NASIPAddress            INET NOT NULL,
  32         CalledStationId         VARCHAR(80),
  33         CallingStationId        VARCHAR(80),
  34         AcctDelayTime           INTEGER,
  35         H323GWID                VARCHAR(32),
  36         h323CallOrigin          VARCHAR(10),
  37         CallID                  VARCHAR(80) NOT NULL,
  38         processed               BOOLEAN DEFAULT false
  39 );
  40 create index startvoipcombo on startvoip (AcctTime, nasipaddress);
  41
  42
  43 CREATE TABLE StartTelephony (
  44         RadAcctId               BIGSERIAL PRIMARY KEY,
  45         AcctTime                TIMESTAMP with time zone NOT NULL,
  46         h323SetupTime           TIMESTAMP with time zone,
  47         H323ConnectTime         TIMESTAMP with time zone,
  48         UserName                VARCHAR(64),
  49         RadiusServerName        VARCHAR(32),
  50         NASIPAddress            INET NOT NULL,
  51         CalledStationId         VARCHAR(80),
  52         CallingStationId        VARCHAR(80),
  53         AcctDelayTime           INTEGER,
  54         H323GWID                VARCHAR(32),
  55         h323CallOrigin          VARCHAR(10),
  56         CallID                  VARCHAR(80) NOT NULL,
  57         processed               BOOLEAN DEFAULT false
  58 );
  59 create index starttelephonycombo on starttelephony (AcctTime, nasipaddress);
  60
  61
  62
  63 /*
  64  * Table structure for 'Stop' tables
  65  */
  66 CREATE TABLE StopVoIP (
  67         RadAcctId               BIGSERIAL PRIMARY KEY,
  68         AcctTime                TIMESTAMP with time zone NOT NULL,
  69         H323SetupTime           TIMESTAMP with time zone,
  70         H323ConnectTime         TIMESTAMP with time zone,
  71         H323DisconnectTime      TIMESTAMP with time zone,
  72         UserName                VARCHAR(32),
  73         RadiusServerName        VARCHAR(32),
  74         NASIPAddress            INET NOT NULL,
  75         AcctSessionTime         BIGINT,
  76         AcctInputOctets         BIGINT,
  77         AcctOutputOctets        BIGINT,
  78         CalledStationId         VARCHAR(80),
  79         CallingStationId        VARCHAR(80),
  80         AcctDelayTime           SMALLINT,
  81         CiscoNASPort            VARCHAR(1),
  82         H323GWID                VARCHAR(32),
  83         H323CallOrigin          VARCHAR(10),
  84         H323DisconnectCause     VARCHAR(20),
  85         H323RemoteAddress       INET,
  86         H323VoiceQuality        INTEGER,
  87         CallID                  VARCHAR(80) NOT NULL,
  88         processed               BOOLEAN DEFAULT false
  89 );
  90 create UNIQUE index stopvoipcombo on stopvoip (AcctTime, nasipaddress, CallID);
  91
  92
  93 CREATE TABLE StopTelephony (
  94         RadAcctId               BIGSERIAL PRIMARY KEY,
  95         AcctTime                TIMESTAMP with time zone NOT NULL,
  96         H323SetupTime           TIMESTAMP with time zone NOT NULL,
  97         H323ConnectTime         TIMESTAMP with time zone NOT NULL,
  98         H323DisconnectTime      TIMESTAMP with time zone NOT NULL,
  99         UserName                VARCHAR(32) DEFAULT '' NOT NULL,
 100         RadiusServerName        VARCHAR(32),
 101         NASIPAddress            INET NOT NULL,
 102         AcctSessionTime         BIGINT,
 103         AcctInputOctets         BIGINT,
 104         AcctOutputOctets        BIGINT,
 105         CalledStationId         VARCHAR(80),
 106         CallingStationId        VARCHAR(80),
 107         AcctDelayTime           SMALLINT,
 108         CiscoNASPort            VARCHAR(16),
 109         H323GWID                VARCHAR(32),
 110         H323CallOrigin          VARCHAR(10),
 111         H323DisconnectCause     VARCHAR(20),
 112         H323RemoteAddress       INET,
 113         H323VoiceQuality        INTEGER,
 114         CallID                  VARCHAR(80) NOT NULL,
 115         processed               BOOLEAN DEFAULT false
 116 );
 117 -- You can have more than one record that is identical except for CiscoNASPort if you have a dial peer hungroup
 118 -- configured for multiple PRIs.
 119 create UNIQUE index stoptelephonycombo on stoptelephony (AcctTime, nasipaddress, CallID, CiscoNASPort);
 120
 121 /*
 122  * Table structure for 'gateways'
 123  *
 124  * This table should list the IP addresses, names and locations of all your gateways
 125  * This can be used to make more useful reports.
 126  *
 127  * Note: This table should be removed in favour of using the "nas" table.
 128  */
 129
 130 CREATE TABLE gateways (
 131         gw_ip           INET NOT NULL,
 132         gw_name         VARCHAR(32) NOT NULL,
 133         gw_city         VARCHAR(32)
 134 );
 135
 136
 137 /*
 138  * Table structure for 'customers'
 139  *
 140  * This table should list your Customers names and company
 141  * This can be used to make more useful reports.
 142  */
 143
 144 CREATE TABLE customers (
 145         cust_id         SERIAL NOT NULL,
 146         company         VARCHAR(32),
 147         customer        VARCHAR(32)
 148 );
 149
 150 /*
 151  * Table structure for 'cust_gw'
 152  *
 153  * This table should list the IP addresses and Customer IDs of all your Customers gateways
 154  * This can be used to make more useful reports.
 155  */
 156
 157 CREATE TABLE cust_gw (
 158         cust_gw         INET PRIMARY KEY,
 159         cust_id         INTEGER NOT NULL,
 160         "location"      VARCHAR(32)
 161 );
 162
 163
 164 CREATE VIEW customerip AS
 165     SELECT gw.cust_gw AS ipaddr, cust.company, cust.customer, gw."location" FROM customers cust, cust_gw gw WHERE (cust.cust_id = gw.cust_id);
 166
 167
 168 -- create plpgsql language (You need to be a database superuser to be able to do this)
 169 CREATE FUNCTION "plpgsql_call_handler" () RETURNS LANGUAGE_HANDLER AS '$libdir/plpgsql' LANGUAGE C;
 170 CREATE TRUSTED LANGUAGE "plpgsql" HANDLER "plpgsql_call_handler";
 171
 172 /*
 173  * Function 'strip_dot'
 174  * removes "." from the start of cisco timestamps
 175  *
 176  * From the cisco website:
 177  * "A timestamp that is preceded by an asterisk (*) or a dot (.) may not be accurate.
 178  *  An asterisk (*) means that after a gateway reboot, the gateway clock was not manually set
 179  *  and the gateway has not synchronized with an NTP server yet. A dot (.) means the gateway
 180  *  NTP has lost synchronization with an NTP server."
 181  *
 182  * We therefore do not bother to strip asterisks (*) from timestamps, as you NEED ntp setup
 183  * unless you don't care about billing at all!
 184  *
 185  *  * Example useage:
 186  *      insert into mytable values (strip_dot('.16:46:02.356 EET Wed Dec 11 2002'));
 187  *
 188  */
 189
 190
 191 CREATE OR REPLACE FUNCTION strip_dot (VARCHAR) RETURNS TIMESTAMPTZ AS '
 192  DECLARE
 193         original_timestamp ALIAS FOR $1;
 194  BEGIN
 195         IF original_timestamp = '''' THEN
 196                 RETURN NULL;
 197         END IF;
 198         IF substring(original_timestamp from 1 for 1) = ''.'' THEN
 199                 RETURN substring(original_timestamp from 2);
 200         ELSE
 201                 RETURN original_timestamp;
 202         END IF;
 203  END;
 204 ' LANGUAGE 'plpgsql';
 205
 206
 207 CREATE OR REPLACE FUNCTION pick_id (VARCHAR, VARCHAR) RETURNS VARCHAR AS '
 208  DECLARE
 209         h323confid ALIAS FOR $1;
 210         callid ALIAS FOR $2;
 211  BEGIN
 212         IF h323confid <> '''' THEN
 213                 RETURN h323confid;
 214         END IF;
 215         IF callid <> '''' THEN
 216                 RETURN callid;
 217         END IF;
 218         RETURN NULL;
 219  END;
 220 ' LANGUAGE 'plpgsql';
 221
 222
 223
 224 /*
 225  * Table structure for 'isdn_error_codes' table
 226  *
 227  * Taken from cisco.com this data can be JOINED against h323DisconnectCause to
 228  * give human readable error reports.
 229  *
 230  */
 231
 232
 233 CREATE TABLE isdn_error_codes (
 234         error_code      VARCHAR(2) PRIMARY KEY,
 235         desc_short      VARCHAR(90),
 236         desc_long       TEXT
 237 );
 238
 239 /*
 240  * Data for 'isdn_error_codes' table
 241  */
 242
 243 INSERT INTO isdn_error_codes VALUES ('1', 'Unallocated (unassigned) number', 'The ISDN number was sent to the switch in the correct format; however, the number is not assigned to any destination equipment.');
 244 INSERT INTO isdn_error_codes VALUES ('10', 'Normal call clearing', 'Normal call clearing has occurred.');
 245 INSERT INTO isdn_error_codes VALUES ('11', 'User busy', 'The called system acknowledges the connection request but is unable to accept the call because all B channels are in use.');
 246 INSERT INTO isdn_error_codes VALUES ('12', 'No user responding', 'The connection cannot be completed because the destination does not respond to the call.');
 247 INSERT INTO isdn_error_codes VALUES ('13', 'No answer from user (user alerted)', 'The destination responds to the connection request but fails to complete the connection within the prescribed time. The problem is at the remote end of the connection.');
 248 INSERT INTO isdn_error_codes VALUES ('15', 'Call rejected', 'The destination is capable of accepting the call but rejected the call for an unknown reason.');
 249 INSERT INTO isdn_error_codes VALUES ('16', 'Number changed', 'The ISDN number used to set up the call is not assigned to any system.');
 250 INSERT INTO isdn_error_codes VALUES ('1A', 'Non-selected user clearing', 'The destination is capable of accepting the call but rejected the call because it was not assigned to the user.');
 251 INSERT INTO isdn_error_codes VALUES ('1B', 'Designation out of order', 'The destination cannot be reached because the interface is not functioning correctly, and a signaling message cannot be delivered. This might be a temporary condition, but it could last for an extended period of time. For example, the remote equipment might be turned off.');
 252 INSERT INTO isdn_error_codes VALUES ('1C', 'Invalid number format', 'The connection could be established because the destination address was presented in an unrecognizable format or because the destination address was incomplete.');
 253 INSERT INTO isdn_error_codes VALUES ('1D', 'Facility rejected', 'The facility requested by the user cannot be provided by the network.');
 254 INSERT INTO isdn_error_codes VALUES ('1E', 'Response to STATUS ENQUIRY', 'The status message was generated in direct response to the prior receipt of a status enquiry message.');
 255 INSERT INTO isdn_error_codes VALUES ('1F', 'Normal, unspecified', 'Reports the occurrence of a normal event when no standard cause applies. No action required.');
 256 INSERT INTO isdn_error_codes VALUES ('2', 'No route to specified transit network', 'The ISDN exchange is asked to route the call through an unrecognized intermediate network.');
 257 INSERT INTO isdn_error_codes VALUES ('22', 'No circuit/channel available', 'The connection cannot be established because no appropriate channel is available to take the call.');
 258 INSERT INTO isdn_error_codes VALUES ('26', 'Network out of order', 'The destination cannot be reached because the network is not functioning correctly, and the condition might last for an extended period of time. An immediate reconnect attempt will probably be unsuccessful.');
 259 INSERT INTO isdn_error_codes VALUES ('29', 'Temporary failure', 'An error occurred because the network is not functioning correctly. The problem will be resolved shortly.');
 260 INSERT INTO isdn_error_codes VALUES ('2A', 'Switching equipment congestion', 'The destination cannot be reached because the network switching equipment is temporarily overloaded.');
 261 INSERT INTO isdn_error_codes VALUES ('2B', 'Access information discarded', 'The network cannot provide the requested access information.');
 262 INSERT INTO isdn_error_codes VALUES ('2C', 'Requested circuit/channel not available', 'The remote equipment cannot provide the requested channel for an unknown reason. This might be a temporary problem.');
 263 INSERT INTO isdn_error_codes VALUES ('2F', 'Resources unavailable, unspecified', 'The requested channel or service is unavailable for an unknown reason. This might be a temporary problem.');
 264 INSERT INTO isdn_error_codes VALUES ('3', 'No route to destination', 'The call was routed through an intermediate network that does not serve the destination address.');
 265 INSERT INTO isdn_error_codes VALUES ('31', 'Quality of service unavailable', 'The requested quality of service cannot be provided by the network. This might be a subscription problem.');
 266 INSERT INTO isdn_error_codes VALUES ('32', 'Requested facility not subscribed', 'The remote equipment supports the requested supplementary service by subscription only.');
 267 INSERT INTO isdn_error_codes VALUES ('39', 'Bearer capability not authorized', 'The user requested a bearer capability that the network provides, but the user is not authorized to use it. This might be a subscription problem.');
 268 INSERT INTO isdn_error_codes VALUES ('3A', 'Bearer capability not presently available', 'The network normally provides the requested bearer capability, but it is unavailable at the present time. This might be due to a temporary network problem or to a subscription problem.');
 269 INSERT INTO isdn_error_codes VALUES ('3F', 'Service or option not available, unspecified', 'The network or remote equipment was unable to provide the requested service option for an unspecified reason. This might be a subscription problem.');
 270 INSERT INTO isdn_error_codes VALUES ('41', 'Bearer capability not implemented', 'The network cannot provide the bearer capability requested by the user.');
 271 INSERT INTO isdn_error_codes VALUES ('42', 'Channel type not implemented', 'The network or the destination equipment does not support the requested channel type.');
 272 INSERT INTO isdn_error_codes VALUES ('45', 'Requested facility not implemented', 'The remote equipment does not support the requested supplementary service.');
 273 INSERT INTO isdn_error_codes VALUES ('46', 'Only restricted digital information bearer capability is available', 'The network is unable to provide unrestricted digital information bearer capability.');
 274 INSERT INTO isdn_error_codes VALUES ('4F', 'Service or option not implemented, unspecified', 'The network or remote equipment is unable to provide the requested service option for an unspecified reason. This might be a subscription problem.');
 275 INSERT INTO isdn_error_codes VALUES ('51', 'Invalid call reference value', 'The remote equipment received a call with a call reference that is not currently in use on the user-network interface.');
 276 INSERT INTO isdn_error_codes VALUES ('52', 'Identified channel does not exist', 'The receiving equipment is requested to use a channel that is not activated on the interface for calls.');
 277 INSERT INTO isdn_error_codes VALUES ('53', 'A suspended call exists, but this call identity does not', 'The network received a call resume request. The call resume request contained a Call Identify information element that indicates that the call identity is being used for a suspended call.');
 278 INSERT INTO isdn_error_codes VALUES ('54', 'Call identity in use', 'The network received a call resume request. The call resume request contained a Call Identify information element that indicates that it is in use for a suspended call.');
 279 INSERT INTO isdn_error_codes VALUES ('55', 'No call suspended', 'The network received a call resume request when there was not a suspended call pending. This might be a transient error that will be resolved by successive call retries.');
 280 INSERT INTO isdn_error_codes VALUES ('56', 'Call having the requested call identity has been cleared', 'The network received a call resume request. The call resume request contained a Call Identity information element, which once indicated a suspended call. However, the suspended call was cleared either by timeout or by the remote user.');
 281 INSERT INTO isdn_error_codes VALUES ('58', 'Incompatible destination', 'Indicates that an attempt was made to connect to non-ISDN equipment. For example, to an analog line.');
 282 INSERT INTO isdn_error_codes VALUES ('5B', 'Invalid transit network selection', 'The ISDN exchange was asked to route the call through an unrecognized intermediate network.');
 283 INSERT INTO isdn_error_codes VALUES ('5F', 'Invalid message, unspecified', 'An invalid message was received, and no standard cause applies. This is usually due to a D-channel error. If this error occurs systematically, report it to your ISDN service provider.');
 284 INSERT INTO isdn_error_codes VALUES ('6', 'Channel unacceptable', 'The service quality of the specified channel is insufficient to accept the connection.');
 285 INSERT INTO isdn_error_codes VALUES ('60', 'Mandatory information element is missing', 'The receiving equipment received a message that did not include one of the mandatory information elements. This is usually due to a D-channel error. If this error occurs systematically, report it to your ISDN service provider.');
 286 INSERT INTO isdn_error_codes VALUES ('61', 'Message type non-existent or not implemented', 'The receiving equipment received an unrecognized message, either because the message type was invalid or because the message type was valid but not supported. The cause is due to either a problem with the remote configuration or a problem with the local D channel.');
 287 INSERT INTO isdn_error_codes VALUES ('62', 'Message not compatible with call state or message type non-existent or not implemented', 'The remote equipment received an invalid message, and no standard cause applies. This cause is due to a D-channel error. If this error occurs systematically, report it to your ISDN service provider.');
 288 INSERT INTO isdn_error_codes VALUES ('63', 'Information element non-existent or not implemented', 'The remote equipment received a message that includes information elements, which were not recognized. This is usually due to a D-channel error. If this error occurs systematically, report it to your ISDN service provider.');
 289 INSERT INTO isdn_error_codes VALUES ('64', 'Invalid information element contents', 'The remote equipment received a message that includes invalid information in the information element. This is usually due to a D-channel error.');
 290 INSERT INTO isdn_error_codes VALUES ('65', 'Message not compatible with call state', 'The remote equipment received an unexpected message that does not correspond to the current state of the connection. This is usually due to a D-channel error.');
 291 INSERT INTO isdn_error_codes VALUES ('66', 'Recovery on timer expires', 'An error-handling (recovery) procedure was initiated by a timer expiry. This is usually a temporary problem.');
 292 INSERT INTO isdn_error_codes VALUES ('6F', 'Protocol error, unspecified', 'An unspecified D-channel error when no other standard cause applies.');
 293 INSERT INTO isdn_error_codes VALUES ('7', 'Call awarded and being delivered in an established channel', 'The user is assigned an incoming call that is being connected to an already-established call channel.');
 294 INSERT INTO isdn_error_codes VALUES ('7F', 'Internetworking, unspecified', 'An event occurred, but the network does not provide causes for the action that it takes. The precise problem is unknown.');
 295