fwpush

Description

Sends command interrupts to the fwpushd process on the Mobile AccessClosed Check Point Software Blade on a Security Gateway that provides a Remote Access VPN access for managed and unmanaged clients. Acronym: MAB. Gateway.

Note - Users get the push notifications only while they are logged in.

Syntax

fwpush

      debug <options>

      del <options>

      info

      print

      send <options>

      unsub <options>

Important:

Parameters

Parameter

Description

debug {off | on | reset | set all all | stat}

Controls the debug of the Mobile Access Push Notifications daemon.

For more information, see sk109039.

del {-token <Token> | -uid <User-UID>}

Deletes a specified token, or all tokens for a specified user.

The available options are:

  • Delete the specified token for all users:

    fwpush del -token <Token>

  • Delete all tokens for a specified user:

    fwpush del -uid <User-UID>

info

Gets data on notifications in the push queue:

  • Number of items in queues

  • Number of seconds the oldest item is in the queue

  • Number of seconds the newest item is in the queue

  • Number of seconds a batch waits in the queue

  • Number of seconds to the sending of the next batch

  • Number of batch errors and authentication request timeouts

print

Shows the push notifications queue and the pending batches.

send -token <Token> -os {iPhone | Android} -msg "<Notification Message>"

send {-user <Username> | -uid <User-UID>} -msg "<Notification Message>"

Sends an on-demand push notification message from a command line.

Important - Before you use the "fwpush send" command, make sure the user is: (A) registered on the Exchange Server, (B) connected.

unsub {<Token> | -user <Username> | -uid <User-UID> | -all}

Unsubscribes a user from push notifications.

The available options are:

  • Unsubscribe all users from the specified token:

    fwpush unsub <Token>

  • Unsubscribe the specified user from all tokens:

    fwpush unsub -user <Username>

    or

    fwpush unsub -uid <User-UID>

  • Unsubscribe all users from all tokens:

    fwpush unsub -all

Viewing the details of connected users

UserSettingsUtil show_exchange_registered_users

Example output:

[Expert@MyGW:0]# UserSettingsUtil show_exchange_registered_users
User Name: CN=JohnD,OU=USERS,OU=RND,OU=PO,OU=USA,DC=AD,DC=CHECKPOINT,DC=COM User Settings id: c4b6c6fbb0c4xxxxxxxx265e93e0e372
Push Token: xxxxxxxxxxxxx65b48e424023ebxxxxxxxxca22ea788cfb3cxxxxxxxxxx Device id: 46c5XXXXcc1d10b4e18cf5a1xxxxxxxx
[Expert@MyGW:0]#

Notes:

  • To use the "<Token>" parameter in the "fwpush" commands, use the value of the Push Token attribute.

    In the above example: xxxxxxxxxxxxx65b48e424023ebxxxxxxxxca22ea788cfb3cxxxxxxxxxx

  • To use the "<Username>" parameter in the "fwpush" commands, use the value of the CN attribute.

    In the above example: JohnD

  • To use the "<User-UID>" parameter in the "fwpush" commands, use the value of the User Settings id attribute.

    In the above example: c4b6c6fbb0c4xxxxxxxx265e93e0e372

Example

[Expert@MyGW:0]# fwpush send -uid JohnD -msg "Hello - push"