FAQ for new Samanage agent

Document created by Yuval Pecht Administrator on Jul 5, 2016Last modified by Yum Darling on Jun 27, 2017
Version 14Show Document
  • View in full screen mode
  • What are the customer benefits of the new agent?
    • Samanage owns code base:
      • Easier to fix and support
      • Easier to add new features - endpoint management roadmap
    • Automatic updates
      • Easier, targeted updates - per account/per machine
      • Better targeted supportability
    • Better overall security
      • Each customer is encrypted in silo with own private key
      • Stronger overall encryption using latest TLS standard
    • Easier install process
      • No need to enter account details
    • Better and more complete data collection
    • Better scalability
  • What operating systems are supported by the new agent?
    • Windows
      • Windows 7.x
      • Windows 8.x
      • Windows 10
    • OSX - 10.6 and above
  • Will there be a new agent for Linux/Unix machines?
    • Not currently planned.
  • What are the options for deploying the agent?
    • Same as before - see setup -> deployment
  • Will there be a MSI file?
  • What ports/services/URLs should be enabled?
    • AWS S3 - must have for the agent to able to post data to samanage
    • opendns.com - should be open to get the machine’s external ip
  • How does the customer uninstall the old agent? Can they mass uninstall?
    • As any other Windows or Mac application
    • Mass uninstall can be scripted - contact our support for details.
  • What happens if the customer doesn’t uninstall the old agent?
    • No issue - they can run in parallel. We will eventually ignore the data from the old agent; however, this is not planned for the near future.
  • What procedure should customers follow if there is problem with the new agent?
  • Do auto updates require user interaction?
    • No. No user interaction is required. The process is entirely automatic.
  • Can a user disable the auto updates?
    • This is possible but not recommended. Please contact support for this issue.
  • How to install with proxy?
    • Extract the downloaded setup using 7zip (or similar)
    • CD into the extracted folder -> SamanageAgent
    • Execute setup.exe --mode unattended --enable_proxy 1 --proxy_address [address] --proxy_port [port]  --proxy_username [username] --proxy_password [password]
      • Note: The username / password parameters are optional
  • What are the command line options?
    • Running agent from command line in Windows:
      • “c:\Program Files\Samanage Agent\agent\ruby\bin\ruby.exe” “c:\Program Files\Samanage Agent\agent\src\mini_kernel\cmd.rb” --h
        Usage: cmd.rb [options]
            -w, --download  execute the downloader
            -f, --force    force packages execution
            -l, --local    generate local report
    • Running agent from command line in Mac:
      • The following steps must be executed with root privileges.
      • /Applications/SamanageAgent.app/Contents/Resources/agent/ruby/bin/ruby  /Applications/SamanageAgent.app/Contents/Resources/agent/src/mini_kernel/cmd.rb --h
        Usage: cmd.rb [options]
            -w, --download  execute the downloader
            -f, --force    force packages execution
            -l, --local    generate local report
  • How do I force a manual update?
    • In some cases you may wish to force the agent on a certain machine to manually push an update. To do this, run the following commands:
    • In Windows: c:\Program Files\Samanage Agent\agent>ruby\bin\ruby.exe src\mini_kernel\cmd.rb --h
      Usage: cmd.rb [options]
          -f, --force    force packages execution
    • In Mac: /Applications/SamanageAgent.app/Contents/Resources/agent/ruby/bin/ruby  src/mini_kernel/cmd.rb --h
      Usage: cmd.rb [options]
          -f, --force    force packages execution
  • What is are the domains in need to whitelist in my network?
    • US:
      • s3.amazonaws.com
      • agt.samanage.com (from version 1.1.303 (Windows) and 1.1.65 (OS/X))
    • EU:
      • s3.amazonaws.com
      • s3-eu-west-1.amazonaws.com
      • agteu.samanage.com (from version 1.1.303 (Windows) and 1.1.65 (OS/X))
  • Are there any antivirus issues?
    • Currently no known issues. The Samanage agent code is signed with the Samanage certificate to avoid such problems. But there may be cases where we can have an issue with Antivirus software. If such issues occur - please contact our support.
  • How do I know I am running the new agent?
    • For windows you will have 2 services:
      • SamanageAgentService
      • SamanageAgentWatchdog
    • For mac under the application you will have an app called “SamanageAgent” (old OCS app was called “Samanage Agent” with a space)
  • When we say 24 hours reporting period - what does it really mean?
    • The agent reports once in 24 hours. If it fail to report it will retry till it can report.
  • What happens if I don’t install the new agent?
    • Nothing will happen. The old agent will continue to report until such time we decide to phase it out which will of course be preceded by the proper announcements in community.

 

At your service,

 

The Samanage Team

9 people found this helpful

Attachments

    Outcomes