Skip to main content

Preparing existing resource for processes

You want to execute processes on your resource or activate load balancing for it?

If there is no Gear-icon next to the name of your resource, it must first be prepared for process execution. To do this, follow the steps below.

For cloud resources preparing your resource for process execution usually happens during the creation process, unless you choose otherwise.

For Windows destinations, follow steps 1 and 2. For Linux destinations, follow the section Prepare a Linux destination instead. Steps 3 and 4 apply to both.

1. Install WinRM setup script on resource (Windows)​

For oneclick™ to be able to execute processes on your destination, Windows Remote Management (WinRM) must first be activated on the corresponding server. In addition, port 5986 in the Windows firewall (and all other firewalls used) should be enabled for the required IP addresses.

To simplify this process and thus make it more effective we have prepared a secure script to automate these tasks.

Proceed as follows to run the script:

  1. Download the script SetupWinRM from our website.

  2. Extract the downloaded file to any location. To do so, right-click and select Extract All…

  3. Open the unzipped folder and execute the “start” file by double-clicking on it.

  4. A warning message appears on your screen. In the window, click More info and then click Run anyway.

  5. Confirm the following message with Yes.

  6. After completion, a message  “Configuration completed successfully” appears, confirming that the process was successful.

    If an error message appears, follow the instructions in the WinRM troubleshooting.

 

2. Required whitelisting in the firewall (Windows, optional)​

If you have other firewalls in use, additionally to the Windows firewall, port 5986 must also be manually released for the oneclick™ core IP addresses.

 

Prepare a Linux destination​

For Linux destinations you do not need a script. oneclick™ logs in over SSH with user name and password and runs processes with sudo.

  1. Allow SSH login with a password. The SSH server (OpenSSH) must be installed and running. Set PasswordAuthentication yes in /etc/ssh/sshd_config and restart the SSH service, for example with sudo systemctl restart ssh. Many cloud images, such as Ubuntu, turn off SSH login with a password in a file under /etc/ssh/sshd_config.d/. That setting takes precedence, so change it there as well. oneclick™ does not support login with an SSH key.
  2. Have a user with sudo rights ready. You enter this user under Admin user in step 3. oneclick™ also uses this user’s password for sudo. A user who may use sudo without a password, or the user root, works as well.
  3. If you are using a firewall, open port 22 for the IP addresses of the oneclick™ core.

Then continue with step 3 and select Linux under Operating system. For Linux images, Linux is already preselected.

3. Prepare resource for processes in oneclick™​

In the next step, enter your admin credentials. This authorizes oneclick™ to apply changes, such as updates you want to execute through processes, on your resource.

  1. In the oneclick™ Admin, select the Resources tab  and then subitem Destinations. Select a connected destination.

  2. Go to Execute action in the upper right corner above the listing and select Prepare for process execution.

  3. Follow the instructions displayed in the displayed pop-up and continue here afterwards.

  4. Select your operating system and enter the administrator credentials here once. Click Save to complete the process.
    oneclick™ stores the password encrypted and uses it to log in for every process.

    You will now see a Gear-icon on the right, in the line of the edited destination.

 

4. Execute processes on your resource or activate load balancing​

Your system is now prepared for process execution. Now you can execute processes on your prepared resource or use the option to set up dynamic load balancing in oneclick™. Follow our instructions for this.