Automate Joe Setup Guide
    • 22 Jan 2023
    • PDF

    Automate Joe Setup Guide

    • PDF

    Article summary

    Introduction to Automate Joe

    SysAid's Automate Joe embedded service is a service desk orchestration tool that allows admins to free up a significant percentage of their workload by automatically running a script-based processes from SysAid, using CA Automic. These processes can include password resets, setting up a VM, employee onboarding/offboarding, granting access to network folders, software deployments, start/stop services, and more.

    Requirements and Prerequisites

    Only an admin with SysAid Administrator permissions can set up this integration.

    For the service to run:

    • You must be running the latest version of SysAid and the SysAid agent.
    • Ensure that ports 2217-2220 are open from the machines where the Automate Joe agents are installed
    • The relevant Automate Joe workstation must be able to access the following addresses at ports 8443 and 443:
      • https://gateway.sysaid.com
      • https://teamviewer.gateway.sysaid.com
      • teamviewer.gateway-eu.sysaid.com
      • data.gateway-eu.sysaid.com
      • gateway-eu.sysaid.com

    We also recommend using a machine that is already running the RDS.

    Enable the Automate Joe Add-On

    Activate Automate Joe

    1. Obtain the Automate Joe add-on from the SysAid Marketplace.
    2. On the main My Apps page, in the Automate Joe icon, click image.png.
    3. Click the slider.
    4. Click Save Changes.

    License Information

    Once Automate Joe is enabled, the following license information is displayed on the setup page:

    image.png

    Added Permissions

    Once Automate Joe is enabled, you can configure two additional permissions for admins and/or groups.

    image.png

    Deploy Automate Joe Agents

    Automate Joe works by deploying specific agents on the target machines or services. You do not need to deploy the Automate Joe agents on every machine in the organization. You only need to deploy them on a single machine that has access to the machines you want to integrate with the relevant Automate Joe processes. If any single machine has access to your entire network, that's an ideal host for the Automate Joe agents.

    Once an agent is enabled, the SysAid agent deploys it on the relevant machines and automatically generates a unique ID for each deployed Automate Joe agent.

    To deploy an Automate Joe agent

    1. Navigate to Asset Management > Asset List.
    2. Select the asset you want to deploy an agent on.
    3. In the asset form, select the Embedded Services tab.
    4. Select Enable from the drop-down for the agent(s) you want to deploy.
    5. Click OK.

    Import Content Packs

    Sync SysAid Credentials with Automate Joe

    Automate Joe uses SysAid's credentials management to access the various applications and services in your network by automatically and securely syncing them to a secure repository in the Automic Orchestration Server.

    To prepare a credentials set for an Automate Joe process

    1. From the Credentials list, open the credentials you want to use.
    2. Ensure that the user name includes the domain name. For example: "domain\administrator"
    3. Select the Valid for Automate Joe check box.
    4. Click OK.

    You can now select this credentials set in the parameter mapping of an Automate Joe process. It's important that any credentials you select have access and permissions to the service on which you want to execute the automated process.

    Process mMapping

    New Action Item Control

    The new Automate Joe action item control allows you to launch an automation process from an action item in a request, change, or problem template. Once this is configured, the moment an Automate Joe action item is activated, Automate Joe executes the process and completes the action item when the defined process is complete.

    To add an Automate Joe process from an action item

    1. Navigate to Settings > Service Desk Templates.
    2. Select the template you want to configure and navigate to the action item you want to automate.
    3. Click image.png.
    4. Click Edit.
    5. Add the Launch Automation Process field to the Visible fields area.
    6. (Optional ) We recommend removing all other fields from this action item.
    7. Click Save.
    8. In the action item, click .image.png
      image.png
    9. If it's the first time accessing the Automate Joe Parameter Mapping screen, click Reload Processes to populate the list of available processes.
    10. From the Automation Process drop-down list, select the process you want to configure.
    11. Provide parameter mapping for this process.
    12. Select if you want the parameter to be populated from an SR field, an action item field, credential set, Automate Joe agent, group field, or a manual Velocity command.
      image.png
    13. In the Set Value column, select a field, or type input with the variable name of the field you want to populate.
    14. Select Get Text if you want to output the field value's caption instead of the its key.
    15. Click OK.
      image.png
    16. Back in the workflow template, click OK.

    You can access a record for each process run by Automate Joe in Settings > Automate Joe > Process Monitor.


    What's Next