Troubleshooting
This topic contains suggested steps for resolving issues that may be encountered when installing, licensing, or configuring Server.
You may encounter this issue if the worker machine has not been configured to run scheduled workflows. Double-click the System Settings icon on your desktop to open the System Settings window and check the following settings:
In a single-machine deployment
Ensure the machine has been configured to have the Worker enabled. The Worker is enabled if any of the following options on the Environment Setup screen are checked:
Designer and Scheduler Only
Complete Alteryx Server
Custom: Enable Worker
Verify the machine is set up to execute scheduled workflows. On the Worker > General screen, ensure the Allow machine to run scheduled Alteryx workflows option is checked. Go to the Worker help page.
Verify the Quality of Service option on the Worker > General screen is set to 0. Go to the Worker help page.
Go to the Environment help page.
In a multi-node deployment
Ensure you have at least one machine in the deployment configured to act as a Worker.
If the worker is connecting to a remote controller, verify it is connecting to the correct controller. On the Controller Remote screen select Test to verify it can connect successfully. Go to the Controller help page.
Verify the worker machine is set up to execute scheduled workflows. On the Worker > General screen, ensure the Allow machine to run scheduled Alteryx workflows option is checked. Go to the Worker help page.
You may be encountering this issue if the worker machine has not been configured to render map tiles, or if the number of processes to be used for tile rendering needs to be increased. Double-click the System Settings icon on your desktop to open the System Settings window and check the following settings:
In a single-machine deployment
Ensure the machine has been configured to have the worker enabled. The worker is enabled if any of the following options on the Environment Setup screen are checked:
Designer and Scheduler Only
Complete Alteryx Server
Custom: Enable Worker
Verify the machine is set up to render map tiles. On the Worker > Mapping screen, verify that the Allow machine to render tiles for mapping option is checked. Go to the Worker help page.
Verify the Max number of render workers option on the Worker > Mapping screen is set to a value greater than 0. The default value is 2. Go to the Worker help page.
Go to the Environment help page.
In a multi-node deployment
Verify that you have at least one machine in the deployment configured to act as a worker.
If the worker is connecting to a remote controller, verify it is connecting to the correct controller. On the Controller Remote screen select Test to verify it can connect successfully. Go to the Controller help page.
Verify the worker machine is set up to render map tiles. On the Worker > Mapping screen, ensure the Allow machine to render tiles for mapping option is checked. Go to the Worker help page.
Verify the Max number of render workers option on the Worker > Mapping screen is set to a value greater than 0. The default value is 2. Go to the Worker help page.
On the controller machine, ensure the Enable map tile controller option is selected on the Controller Mapping screen. Go to the Controller help page.
You may encounter this issue if the worker machine that is configured to run the workflows as a specified user does not have the appropriate permissions in the workspace folder where files are stored. Double-click the System Settings icon on your desktop to open the System Settings window and check the following settings:
Identify the Workspace folder specified on the Worker > General screen. Go to the Worker help page.
Open Windows Explorer and navigate to that folder.
View the folder properties.
On the Security tab, verify that the user specified as the Run As user exists in the list of users. If it does not, add it.
On the same tab, highlight the specified user and ensure it has the following permissions: Modify / Read & Execute / Read / Write.
After Alteryx Server is installed, you can safely shut down the service by following these steps:
Select the Windows Start button.
Type ‘services.msc’ in the Search field and press Enter.
In the Services window, locate and select Alteryx Service in the list of services.
Select the Stop link to stop the service. The service will stop after the currently running jobs are completed.
You might need to refresh the list of services to confirm the Alteryx Service has stopped.
You can also use Server log files and the Server Usage Report to identify and troubleshoot issues. Visit the Configure and Use Server Logs and Install the Server Usage Report help pages for more info.