Troubleshooting

Version:
2019.3
Last modified: October 11, 2019

This topic contains suggested steps for resolving issues that may be encountered when installing, licensing, or configuring Alteryx Server. 

 

My workflows are always in a “Queued” state when scheduled or during validation.

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. See Worker.
  • Verify the Quality of Service option on the Worker General screen is set to 0. See Worker.

See Environment.

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 click Test to verify it can connect successfully. See Controller.
  • 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. See Worker.
Maps in the Map Input, Report Map, and Map Question tools don’t show up.

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. See Worker.
  • 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. See Worker.

See Environment.

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 click Test to verify it can connect successfully. See Controller.
  • 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. See Worker.
  • 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. See Worker.
  • On the controller machine, ensure the Enable map tile controller option is selected on the Controller Mapping screen. See Controller.
I have configured Alteryx Server to run workflows as a specified user, but they are failing.

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. See Worker.
  • 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.
I need to temporarily shut down Alteryx Server.

After Alteryx Server is installed, you can safely shut down the service by following these steps:

  1. Click the Windows Start button.
  2. Type ‘services.msc’ in the Search field and press Enter.
  3. In the Services window, locate and select Alteryx Service in the list of services.
  4. Click the Stop link to stop the service.

You may need to refresh the list of services to confirm the Alteryx Service has stopped and it may take up to 30 seconds for Alteryx Server to completely shut down.

You can also use Server log files and the Alteryx Server Usage Report to identify and troubleshoot issues. See Log FilesAlteryx Server Usage Report.

Was This Helpful?

Need something else? Visit the Alteryx Community or contact support.