Accounting CLI [Документация VAS Experts]
Документация VAS Experts Документация VAS Experts-mobile
in

Settings

  • Show page
  • Old revisions
  • Export to PDF
  • Backlinks
  • Show page
  • Old revisions
  • Export to PDF
  • Backlinks

    • Differences

    This shows you the differences between two versions of the page.

    Link to this comparison view

    Both sides previous revisionPrevious revision
    Next revision    		Previous revision
    en:dpi:bras_bng:cli:acct:start [2023/10/10 08:25] – внешнее изменение 127.0.0.1en:dpi:bras_bng:cli:acct:start [Unknown date] (current) – removed - external edit (Unknown date) 127.0.0.1
    Line 1: Line 1:
    -====== Accounting CLI ====== 
    -{{indexmenu_n>6}} 
      
    -View and management of fastpcrf accounting-sessions. 
    - 
    -This is a fastdpi command, so you have to specify the fastdpi address in the -r argument of the utility. 
    - 
    -==== pcrf acct show all ==== 
    -Output of fastpcrf accounting database. Note that the presence of an entry in the output of this command does not necessarily mean that there is an active accounting-session. If the entry does not have a session-id attribute, then such entry is not active. 
    -<code bash> 
    -fdpi_cli pcrf acct show all 
    -</code> 
    - 
    -==== pcrf acct show active ==== 
    -Output of fastpcrf accounting active sessions database. The output of this command includes active sessions and sessions terminated in the previous 5 minutes 
    -<code bash> 
    -fdpi_cli pcrf acct show active 
    -</code> 
    - 
    -==== pcrf acct show ==== 
    -Output of accounting-sessions by a specified key. 
    -<code bash> 
    -fdpi_cli pcrf acct show [ip=X | session=X | multi_session_id=X | login=X | uid=X] 
    -</code> 
    -You should set one of the keys: 
    -  * ''ip'' - subscriber's IPv4- or IPv6-address 
    -  * ''session'' - accounting session-id 
    -  * ''multi_session_id'' - accounting multi-session-id 
    -  * ''login'' - subscriber's login 
    -  * ''uid'' - internal unique identifier of the aggregation record. This id is assigned when the record is created and, unlike the session-id, never changes. 
    - 
    -Examples (10.20.98.78 - fastpcrf-server address): 
    -<code bash> 
    -fdpi_cli -r 10.20.98.78 pcrf acct show ip=192.168.0.25 
    -fdpi_cli -r 10.20.98.78 pcrf acct show ip=2001:5098:89::/64 
    -fdpi_cli -r 10.20.98.78 pcrf acct show session=67890978DAE00067 
    -fdpi_cli -r 10.20.98.78 pcrf acct show multi_session_id=M67890978DAE00067 
    -fdpi_cli -r 10.20.98.78 pcrf acct show login=JohnSmith 
    -fdpi_cli -r 10.20.98.78 pcrf acct show uid=1034 
    -</code> 
    - 
    -==== pcrf acct raw show ==== 
    -Output of raw data (raw-level by IP) of the accounting database. This is non-aggregated data coming from fastDPI. 
    -<code bash> 
    -fdpi_cli pcrf acct raw show [all | ip=X | session=X | multi_session_id=X | login=X | uid=X] 
    -</code> 
    -You should set one of the keys: 
    -  * ''all'' - output of complete raw DB 
    -  * ''ip'' - subscriber's IPv4- or IPv6-address 
    -  * ''session'' - accounting session-id 
    -  * ''multi_session_id'' - accounting multi-session-id 
    -  * ''login'' - subscriber's login 
    -  * ''uid'' - output of raw records included in the aggregation record with the specified internal unique identifier 
    - 
    -Examples: 
    -<code bash>            
    -   # output of all records 
    -fdpi_cli pcrf acct raw show all 
    - 
    -   # search by IP 
    -fdpi_cli pcrf acct raw show ip=192.168.0.25 
    -fdpi_cli pcrf acct raw show ip=2001:5098:89::/64 
    - 
    -   # search by session-id or multi-session-id: 
    -fdpi_cli pcrf acct raw show session=67890978DAE00067 
    -fdpi_cli pcrf acct raw show multi_session_id=M67890978DAE00067 
    - 
    -   # search by login: 
    -fdpi_cli pcrf acct raw show login=JohnSmith 
    - 
    -   # search by UID 
    -fdpi_cli pcrf acct raw show uid=34098 
    -</code> 
    - 
    -==== pcrf acct show stat ==== 
    -Output of internal statistics of fastpcrf accounting database 
    -<code bash> 
    -fdpi_cli pcrf acct show stat 
    -</code> 
    - 
    -==== pcrf acct [start | stop | idle | restart] ==== 
    -Accounting sessions management 
    -<code bash> 
    -fdpi_cli pcrf acct [start | stop | idle | restart] [ip=X | session=X | multi_session_id=X | login=X | uid=X] 
    -</code> 
    -Actions: 
    -  * ''start'' - starts the accounting-сессию for the specified subscriber. Valid arguments are ''ip'', ''login''. If the session is already active, the command is ignored. 
    -  * ''stop'' - stops the accounting-sessions. Such arguments as ''session'' and ''ip'' stop one session, others can stop multiple sessions. 
    -  * ''idle'' - stops the accounting-sessions in case of idle timeout. The difference from ''stop'' command is that a session terminated by a data immutability timeout starts automatically when subscriber traffic appears, unless the [[dpi:bras_bng:opt_bras_l3:radius_accounting:setup#acct_auth_sync|acct_auth_sync]] synchronization mode is enabled. Such arguments as ''session'' and ''ip'' stop one session, others can stop multiple sessions. 
    -  * ''restart'' - stops the current active session and starts a new one. Если сессия неактивна, она становится активной. If the session is inactive, it becomes active. If the session is active, it is stopped and a new session is started with a different session id. 
    - 
    -You should set one of the arguments: 
    -  * ''ip'' - subscriber's IPv4- or IPv6-address 
    -  * ''session'' - accounting session-id (relates to ''stop'', ''restrart'', ''idle'' commands) 
    -  * ''multi_session_id'' - accounting multi-session-id 
    -  * ''login'' - subscriber's login 
    -  * ''uid'' - internal unique identifier of the aggregation record. This id is assigned when the record is created and, unlike the session-id, never changes. 
    - 
    -Examples: 
    -<code bash> 
    -   # Start of accounting sessions for all login IP addresses 
    -fdpi_cli pcrf acct start login=JohnSmith 
    -   # Send Acct Stop for session 67890978DAE00067 
    -fdpi_cli pcrf acct stop pcrf acct stop session=67890978DAE00067 
    -   # Restart an acct-session for IP 
    -fdpi_cli pcrf acct restart ip=192.168.52.36 
    -fdpi_cli pcrf acct restart ip=2001:5098:89::/64 
    -   # Stop all multisessions by idle timeout 
    -fdpi_cli pcrf acct idle multi_session_id=M67890978DAE00067 
    -</code> 
    - 
    -==== pcrf acct interim ==== 
    -Sending interim update immediately for specified sessions. 
    -To send an interim update, the session must be active. 
    -<code bash> 
    -fdpi_cli pcrf acct interim [ip=X | session=X | multi_session_id=X | login=X | uid=X] 
    -</code> 
    - 
    -You should set one of the arguments: 
    -  * ''ip'' - subscriber's IPv4- or IPv6-address 
    -  * ''session'' - accounting session-id 
    -  * ''multi_session_id'' - accounting multi-session-id 
    -  * ''login'' - subscriber's login 
    -  * ''uid'' - internal unique identifier of the aggregation record. This id is assigned when the record is created and, unlike the session-id, never changes. 
    - 
    - 
    -Examples: 
    -<code bash> 
    -fdpi_cli pcrf acct interim ip=192.168.52.36 
    -fdpi_cli pcrf acct interim ip=2001:5098:89::/64 
    -fdpi_cli pcrf acct interim multi_session_id=M67890978DAE00067 
    -fdpi_cli pcrf acct interim session=67890978DAE00067 
    -fdpi_cli pcrf acct interim login=JohnSmith 
    -</code>