A list of the most recent transactions are visible from within the transaction panel of the admin.
Full details on all transactions may be exported in spreadsheet format for accounting and research purposes following the article below.
Note: You may also securely download logs directly from the server. This is helpful in case an email provider blocks these log attachments. If so, please follow the instructions under the Direct tab.
Installing the log scripts
You may download and install the log scripts with the following command:
curl -sS https://raw.githubusercontent.com/lamassu/lamassu-patches/master/logs/download.sh | bash
Next follow the steps below with your prefered method.
Exporting the log files
In your server, run the command for the log you wish to export, followed by your email address.
If it's the command for an encrypted log, you'll need to import a PGP key and use the email address associated with your PGP key. (See the importing section below.)
Encrypted logs:
- cash-in-log – All cash-in transactions.
- cash-out-log – All cash-out transactions (if a two-way machine).
- cash-out-actions – All cash-out dispense and refill events.
- bills-log – Each individual bill inserted and their denomination.
- customers-log – Table of customers and their scanned ID information.
- sanctions-log – Instances of customers triggering sanctions.
- trades-log – Record of exchange trades.
Unencrypted logs:
- cash-in-unencrypted
- cash-out-unencrypted
- out-actions-unencrypted
- bills-log-unencrypted
- trades-log-unencrypted
- send-server-log – Emails lamassu-server logs for research. Unencrypted.
If the email doesn't appear, check your spam folder. Some email services may block such emails entirely, so if not in spam, try an email address with a different provider or download logs directly from the server.
Importing a PGP key
This is optional, though will allow you to export spreadsheets so that they are encrypted in transit, and thus not expose you or your customers' data.
Instructions for creating a PGP keypair and uploading to a public keyserver:
– Linux
– Mac
– Windows (creating, uploading)
Once uploaded to a keyserver, import your key to your Lamassu server by running:
gpg --search-keys --keyserver <keyserver> <key ID or email address>
Direct
Exporting the log files
The commands it adds are:
- export-cash-in
- export-cash-out
- export-bills
- export-out-actions
- export-customers
- export-sanctions-log
- export-trades
These will save the latest logs as a spreadsheet in your server's /tmp folder.
For example, to export cash-in transaction logs from the database, run:
root@wynand-building:~# export-cash-in
COPY 145
Saved to /tmp/cash_in_txs.csv
Downloading the log files
Linux / Mac OS Windows
Linux / Mac OS
If the computer you use to access your server is running Linux or Mac OS, you can use scp to download the logs directly.
Within your computer's terminal (not your server terminal), run, replacing 1.2.3.4 with the IP of your droplet, and replacing 'cash_in_txs.csv' with the name of the file you just exported :
scp root@1.2.3.4:/tmp/cash_in_txs.csv ~/cash_in_txs.csv
It will prompt for the same passphrase that you use to connect to your droplet via SSH. The command will download the log file to your home directory.
Run the above for each log you exported, replacing 'cash_in_txs.csv' above with the appropriate file name. Examples for cash-out and bills:
scp root@1.2.3.4:/tmp/cash_out_txs.csv ~/cash_out_txs.csv
scp root@1.2.3.4:/tmp/bills.csv ~/bills.csv
Windows
Download and install the program WinSCP. When it offers to copy your settings from PuTTY, say yes.
You should see your existing server(s) now listed in WinSCP. Highlight your next-gen server, click Edit, then select the method 'SCP', enter 'root' as your user, leave password as blank.
Click Advanced. Under SSH > Authentication, select the path to your private SSH key file (ending in .ppk).
Click OK, click Save, then Login.
On the right side, double click on the /tmp folder in your server, where you'll find each exported log file.
Download them to your computer by dragging them to the desired folder on the left side.
Comments
0 comments
Article is closed for comments.