Troubleshooting

Refer to this section in order to resolve frequently encountered issues while using SNS CLI scripts.

  • Situation: When a script file is selected, an error message indicates that the script is too large.
  • Cause: The size of the file must not exceed 5 MB by default.
  • Solution: If necessary, increase the limit by adding the line below to the file /data/config/fwadmin-env.conf.local. Set the limit to 10 MB for example:
    SMC_SNS_CLI_SCRIPT_MAX_UPLOAD_SIZE_INT=$((10*1024*1024))
  • Situation: Certain accented or special characters do not display correctly in the script. The script could not be run.
  • Cause: The .script file was not encoded in UTF-8.
  • Solution: Change the encoding of the script to UTF-8.
  • Situation: The Execution tab in the SNS CLI scripts menu indicates errors.
  • Cause: The script calls up customized variables and/or attachments which are missing. The encoding of the script is wrong. Other problems may be the cause of the script's failure to run.
  • Solutions:
    • Look for the cause of the error which appears in the status bar when the script is run for a given firewall.
    • Look up the server's log file in /data/log/fwadmin-server/server.log for further detail.
    • Before running the script, you can view it for a given firewall in the Firewalls selection tab. Certain errors may be indicated.
  • Situation: Firewalls have been selected for the execution of a script but the execution button remains grayed out, or some firewalls cannot be selected.
  • Cause: A script is currently being executed or a configuration is being deployed or delayed on a firewall. Scripts therefore cannot be executed on this firewall for the moment.
  • Solution: Wait until the script execution or deployment ends, or until the firewall reconnects so that the deployment can complete.