AdamRemote Automation Tool

Question and Answer about AdamFrequently Asked Questions

FAQ


Here you can find frequently asked questions.
If you have any other question to ask, please send us your question to the contact page and we will back to you within 24 hours.

  • System Requirements
    - Windows XP SP3 or higher
    - Microsoft .NET Framework 4 [Download]
    - Microsoft Visual C++ 2010 Redistributable [Download]

  • How to install Adam Remote Automation Tool?
    1. Download the latest version of Adam Remote Automation Tool from here to temporary directory.
    2. Create Adam new directory, for example: "C:\Adam".
    3. Extract the files to the Adam's directory (Depending on the directory name you selected in section 2).
    4. License - Save/Copy the license key file that you received on your E-Mail (attach file) to the Adam's directory.

  • Where can I find the Adam's Documentations and Examples?
    - Please check the Online Help to learn more about Adam Remote Automation Tool

  • How to run command on local machine?
    - In task command "Connect" change the "remoteMachine" value to "localhost".
      Example:
      <Task command="Connect" remoteMachine="localhost" userName="${userName1}" userPassword="${userPassword1}" osType="windows" />

  • How to execute the Adam Tool on several machines (one after the other)?
    - You can connect and execute Adam's script on several remote machines by using
      the setting: 'remoteMachinesFile', For more information Click Here.
    - Another way, you can use batch file to do it, use the following steps:
      1. Download the file: 'RunAdamOnListOfRemoteMachines' with the script and examples,
      Save the file into the Adam's directory.
      2. Extract the zip file to the Adam's directory (The file includes examples).
      3. Edit the 'machines.txt' and add the host name/IP address of the machines.
      You can also type the Username and the Password for each machine.
      Example #1: 10.0.0.1 username password
      Example #2: 10.0.0.1
      4. Execute the script: RunAdamOnListOfRemoteMachines.bat,
      The script will run the Adam tool for each remote machine address.
      Note that, You can add extra parameters to the Adam executable.
      Example: RunAdamOnListOfRemoteMachines.bat -DosType=Windows


  • How to convert PEM to PPK file format:
    1. Download PuttyGen (click here).
    2. Open PuttyGen.
    3. Click on the button: "Load".
    4. Set the file type to "All Files (*.*)".
    5. Click on the button: "Save private key".
    6. Type the new PPK file name and click "Save".

  • How to parse the result output file?
    - When using the property "resultOutputToFile" (on any task), the output will save to text file.
      After the output file created you can easily parse the string(s) to value by using batch file.
      You can download the example of batch file from Here.

  • How to use the Greater and Less than symbols: '<>' in the script (XML) file
    - Whenever one of the XML element contains an '<' or '>' you will get
      the error message "There is an error in XML document".
      In order to solve this issue, use the following characters instead:
      &lt; = '<'
      &gt; = '>'
      Example:
      <Task command="WriteTextFile" file="c:\jetty.conf" text="&lt;Arg&gt;${jenkinsHome}&lt;/Arg&gt;" />

  • How to use the Inverted commas symbol: ' " ' in the script (XML) file
    - In order to add the symbol " to your XML file, you will need to add it between inverted commas (' ').
      Example: <Task command="Exec" shell='copy "C:\Program Files\AA\Uninstall.exe" c:\temp' waitForExit="true" />

  • How to use 'Sudo' command without enter the password?
    - Here is how to add user to Sudoers file without enter the password:
      1. Modify the sudoers file ("vi /etc/sudoers").
      2. Add your username to the sudoers users list by the following example:
          username ALL= NOPASSWD:ALL

    Comments:
    - You need root access to add these lines to the Sudoers file.
    - This solution is also good for the error: "sudo: no tty present and no askpass program specified".
    Warning: Don't forget to backup the "sudoers" file before edit!

  • Error Message: "you must have a tty to run sudo" when using Sudo command
    - It's because the option: "requiretty" is enabled on the remote Linux machine.
      1. Modify the sudoers file ("vi /etc/sudoers")
      2. Remove the setting (line): "Defaults requiretty".   
    Warning: Don't forget to backup the ""sudoer" file before edit!

  • How to install add-ons?
      1. Select and Download the Add-on you want to install from Here.
      2. Extract the add-on file (zip) into the Adam's directory.

  • Unable login to Windows machine using WMI
    - Try the following options on the remote machine, if no one help please contact us.
      1. Check the Service: Windows Management Instrumentation started.
      2. Add the WMI port to the Firewall or Disable Firewall
      3. Disable (Never notify) the UAC ("User Account Control").
      4. Give Administrators Permissions to Registry: "WBEM Scripting Locator"
      (Search for {76A64158-CB41-11D1-8B02-00600806D9B6})
      * After any change restart the remote machine and try again.

  • Adam's Crashes when I execute the script
    - Check if you are not running the Adam Tool simultaneously (multi-run) to the same remote machine, If so note that this option doesn't support by Adam Tool!
    Example: Let's take the feature: "Copy", if you execute simultaneously (Run Adam Tool twice) the feature "Copy" with target to the same location to the same remote machine, this can cause unexpected behavior and crashes. In this case you can solve this "Copy" issue by randomize the folder name or to execute it on different remote machine. For any other Crashes or Bugs please report to us by the contact page.