Searching...

Matching results

    Uploadlog Tool

    The purpose of the uploadlog tool is to upload log files from ALEOS devices to the AMM so these log files are visible from the Browse log files menu. This tool is useful because logs from ALEOS devices are not uploaded in real time.

    • In AMM 2.16.1 and below, ALEOS logs are uploaded to the AMM in plain text.

    • From AMM 2.16.2 onwards, support for a management tunnel for ALEOS devices was added.

    • In order to enable secure encrypted uploads, the uploadlog app must be updated on the devices.

    • uploadlog 1.0.2 (available in AMM 2.16.2) allows logs to be sent over the management tunnel if it is established. If it is not available, the logs are sent in plain text.

    • uploadlog 1.0.3 (available in AMM 2.17.2+) added the ability (enabled by default) to inhibit the transfer of logs outside the management tunnel. If the management tunnel is down, the ALEOS logs will be held at the device, subject to a maximum accumulation of log data (oldest data will be deleted first to keep data storage under the threshold) until the management tunnel is re-established. The configuration setting is set to secureTransfer=true by default.

    It is highly recommended that this setting be left enabled, otherwise device logs will be sent in clear text instead of going through a secure channel. If the devices are not upgraded to uploadlog 1.0.3, then they will continue to use the currently installed version of uploadlog and will not enforce the new secure transfer option using the management tunnel.

    • In AMM 2.17.2 or later, if using uploadlog without the management tunnel, then a new setting, FTPFirewallRulesEnabled in amm.cfg must be configured. This must be set to yes (default is no) in order to transfer logs outside of the tunnel, as logs are transferred via FTP. Please contact Sierra Wireless support for assistance in changing this setting.

    Obtaining and Installing the Tool

    Obtaining and Installing the Tool

    To obtain the tool:

    1. Navigate to Admin -> Software -> Repository.
    2. Select the version of uploadlog from the list.
    3. Click Download.
    4. Navigate to Admin -> Software -> Distribution.
    5. Select an ALEOS device in the gateway tree to apply the tool to.
    6. Click Upgrade Application(s).
    7. Select uploadlog-ALEOS-Generic in the Upgrade Applications wizard and complete the subsequent wizard screens. Note that you can only install one ALEOS app at a time.
    8. Navigate to Config -> Deploy -> Deploy and click uploadlog config to complete the configuration.

    Additional Configuration Recommendations

    Additional Configuration Recommendations

    There are three settings related to this tool in the uploadlogconfig file. To access this file:

    1. Select the gateway in the gateway tree.
    2. Navigate to Config -> Deploy -> Deploy.
    3. Click on Click to display files under the Files column to expand the list of files.
    4. Click on uploadlogconfig.

    The following settings in this file should be set as described here:

    • avoidCellLinkTranmission: it is recommended that this be set to true to prevent the log files from being uploaded over expensive cellular links.
    • maxArchiveSize: specifies the cache size to use for temporary log files before purging to make room for new log data. It is recommended that this be left at the default size of 4MB.
    • secureTranfer: it is recommended that this be left at the default value of true, so that sending log files outside the management tunnel is inhibited.

      Note: The setting secureTransfer should be disabled, if uploadlog 1.0.3 is used but the management tunnel is not being used (e.g. with older AMM versions or closed secure networks), otherwise log transfer will not be possible.

    TOP