The Automation Orchestrator allows you to run a local Django Web Application to administrate and orchestrate automation scripts such as Nintex RPA botflows but you may also orchestrate other automation such as Python scripts, batch files, and other RPA tools. The Automation Orchestrator is tested with and supports Nintex RPA version <= 15.1.
As described on the official Django project site, it "is a high-level Python Web framework that encourages rapid development and clean, pragmatic design. Built by experienced developers, it takes care of much of the hassle of Web development, so you can focus on writing your app without needing to reinvent the wheel. It’s free and open source."
Some of the biggest web platforms and brands like Instagram and Pinterest use the Django Framework due to its leading security features and ability to scale.
The purpose of the Automation Orchestrator is to offer a well-functioning, fully customizable web server application to trigger and schedule scripts. The Automation Orchestrator can run as a fully local server only available on the local host accessible via a browser or as a server available in your protected internal network accessible via a browser.
Feature highlights out-of-the-box:
We highly recommend that the Automation Orchestrator is installed and setup only by people experienced with both Python and Nintex RPA. You are always welcome to contact us for assistance via: robotics@basico.dk
Out-of-the-box, the Automation Orchestrator can trigger and schedule scripts on the same machine and user running the server. In case you wish to do either of the following two things, you need to utilize the Automation Orchestrator Executor add-on:
For the Automation Orchestrator to work, you need to install Python. Make sure to install the latest 64-bit version. If you are in any doubts on how to correctly install Python, follow this guide or contact us.
After installing Python, you are now ready to install the Automation Orchestrator. Follow these steps precisely:
Create a folder called "AutomationOrchestrator" on your machine, for example, directly on the C: drive or in the "Program Files" folder. So, your path should be similar to "C:\AutomationOrchestrator" or "C:\Program Files\AutomationOrchestrator".
Navigate to the list of releases and download the source code (ZIP) of the latest version.
Unzip the folder in your created "AutomationOrchestrator" folder. So, your path could be similar to "C:\AutomationOrchestrator\AutomationOrchestrator-0.3.0" or "C:\Program Files\AutomationOrchestrator\AutomationOrchestrator-0.3.0".
After unzipping the folder, run the "INSTALL.bat" file for an automated installation process. Remember to run the batch file (or commands manually) as an administrator.
The last command of the installation process will prompt you to create an account, a super user with full permissions to the Automation Orchestrator. After creating the super user, the installation process is complete.
After a successful installation, you are now ready to run the Automation Orchestrator, the web server. You can run the Automation Orchestrator either locally or in your protected internal network. Which of the two options to choose depends on whether you intend to use and access the Automation Orchestrator only on the host machine or not. You can always switch between the two options.
Run the "SETUP_RUN_SERVER.bat" file, which will create a scheduled job called AutomationOrchestratorRunServer in the Windows Task Scheduler. The created job will run every minute to make sure that the Automation Orchestrator is always running. Remember to run the batch file (or commands manually) as an administrator.
As long as you see this window running, the Automation Orchestrator is actively running on your machine. You can always minimize it.
IMPORTANT: If you wish to stop the server, you MUST click the shortcut ctrl+c in the server window to see the confirmation that the server is stopped before closing the window. Make sure to NOT close the server while any executions are running. Sometimes you need to hit the keys a couple of times before it is registered by the server. Also, remember to disable the job AutomationOrchestratorRunServer in the Windows Task Scheduler if you wish to make sure that it does not restart after one minute.
This section contains a list of common issues and a description on how to solve them. In case the explained solution does not solve the issue or you experience issues not listen below, please report it here.
After a successful installation (no errors during the process), if you experience that you are not able to access the Automation Orchestrator in the browser, make sure to restart the machine. In case that does not help, check the following point.
The Automation Orchestrator will fail to run if the user does not have permissions to execute Python. Make sure to allow the user to execute the global install of Python (python.exe and pythonw.exe) and hereafter the Python (python.exe and pythonw.exe) installed in the virtual environment of the Automation Orchestrator ("./venv/scripts/python.exe" and "./venv/scripts/pythonw.exe").
If you either experience that you are unable to access the Automation Orchestrator in the browser or you get a "OperationalError at /login/ - attempt to write a readonly database", make sure that the user has full read and write permissions to the folder where Automation Orchestrator is installed. Right-click on the main "AutomationOrchestrator" folder and give the specific if not all users full permissions.
If you have selected to run the Automation Orchestrator in your protected internal network but are unable to access the application in a browser from another computer in your domain, you need to make sure that your Python instance is allowed to communicate through the firewall of your domain. To fix this, you can go to "Allow an app through Windows Firewall" and click "Allow another app...". First, make sure to add the global install of Python (python.exe and pythonw.exe) and hereafter the Python (python.exe and pythonw.exe) installed in the virtual environment of the Automation Orchestrator ("./venv/scripts/python.exe" and "./venv/scripts/pythonw.exe").
You are now ready to access the Automation Orchestrator via a browser and get started. As long as the Automation Orchestrator is running, you can access it in your browser. The URL is specified in the window of the server running. Begin by signing in to the Automation Orchestrator using the super user that you created during the installation process. You should now see the home page.
After signing in, you can begin to set up the Automation Orchestrator. This is the order of the setup:
You have now set up the Automation Orchestrator!
The Automation Orchestrator runs with the "DEBUG" flag set to "True", which is not recommended in a cloud production environment, since the Automation Orchestrator should only be used to run fully locally or shared in your protected internal network. If you wish to deploy the Automation Orchestrator in the open cloud, there are many additional steps to consider and implement.
Starting from v0.0.17 Automation Orchestrator is distributed under the BSD 3-clause license. Automation Orchestrator v0.0.16 and before was distributed under the MIT license.
Copyright (c) 2019-2020, Basico P/S, Mathias Balsløw
For contact or support, please write to us at: robotics@basico.dk