To configure UiPath Automation Suite hosted on Linux (without IIS) and ensure successful package uploads to Orchestrator, you’ll typically be using Nginx as the reverse proxy. Here’s a detailed step-by-step guide to address potential issues, especially with larger package uploads:
Steps to Configure Nginx for Larger File Uploads:
-
Locate Nginx Configuration File:
- The Nginx configuration file is usually located at:
/etc/nginx/nginx.conf(global configuration)/etc/nginx/sites-available/default(or specific site config file)
- The Nginx configuration file is usually located at:
-
Increase
client_max_body_size:-
This directive defines the maximum allowed size of the client request body. To handle larger file uploads (for instance, a 30MB package), you’ll need to increase this limit.
-
Open your Nginx configuration file for editing. For example:
sudo nano /etc/nginx/nginx.conf -
Look for the
httporserverblock and add theclient_max_body_sizedirective:http { ... client_max_body_size 100M; # This sets the upload size limit to 100MB ... } -
If you’re using a specific site configuration file, add the same directive in the appropriate
serverblock.
Example for a site-specific config:server { ... client_max_body_size 100M; ... }
-
-
Restart Nginx to Apply Changes:
- After modifying the Nginx configuration, restart the service to apply the changes:
sudo systemctl restart nginx
- After modifying the Nginx configuration, restart the service to apply the changes:
-
Verify Nginx Logs:
- Check the Nginx error logs to ensure no errors related to package uploads are being triggered:
sudo tail -f /var/log/nginx/error.log
- Check the Nginx error logs to ensure no errors related to package uploads are being triggered:
-
Check Orchestrator Logs:
- Orchestrator logs are also important to verify if there are any application-specific errors related to the upload. Logs can typically be found under:
/var/log/uipath/orchestrator/
- Orchestrator logs are also important to verify if there are any application-specific errors related to the upload. Logs can typically be found under:
-
Verify Other System Configurations:
- Ensure that the Linux system’s file upload and network configurations allow for larger files. Check for any other potential restrictions in place (e.g., firewalls, network timeouts).
- You might also need to verify any reverse proxy settings between Nginx and the Orchestrator server.
Steps to Troubleshoot Package Upload Issues:
-
Check the Upload Process:
- If the upload fails, examine the Orchestrator logs for any detailed error messages that indicate the cause of the failure.
-
Verify Orchestrator Configuration:
- Ensure that your Orchestrator settings do not impose a file size limit for package uploads. This is usually managed automatically by Orchestrator but can depend on your specific setup.
-
Check Available Disk Space:
- Verify that the Orchestrator server has enough disk space to handle large package uploads. If the server runs out of space, it will not be able to accept the uploads.
df -h
- Verify that the Orchestrator server has enough disk space to handle large package uploads. If the server runs out of space, it will not be able to accept the uploads.
-
Test Package Uploads via the Orchestrator Web UI:
- Try uploading a smaller package via the Orchestrator web UI to check if it’s a general upload issue or specific to certain package sizes.
-
Check the Network:
- Ensure there are no network issues or firewalls blocking the upload process, particularly if you’re using reverse proxies or VPNs.
Example of Nginx Configuration Changes:
Here’s an example of how your Nginx config might look after applying the changes:
http {
...
client_max_body_size 100M; # Increase to allow larger uploads
...
}
server {
listen 80;
server_name orchestrator.example.com;
location / {
proxy_pass http://127.0.0.1:5000; # Example proxy pass to Orchestrator
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
After making these changes and restarting Nginx, your Automation Suite should be able to handle larger package uploads to Orchestrator without issues.