Project Editing and Execution Management -> Execute project logic
Execute project logic
Summary
This page is your central hub for overseeing project execution. It provides a live view of all operations as they happen, showing you exactly what commands are being run in the background through a terminal, along with dynamic screenshots to give you visual feedback. You'll also see a running log of all activities, ensuring you're always aware of your project's progress and status.
Page Access
You can access this page by navigating to: /automization
Page Functionalities
Display Areas
- Terminal Output: A main area that shows the commands being executed and their results in real-time. This is like looking directly at the computer's operations.
- Status Message: Located above the terminal, this message provides a quick update on the current phase of your project's execution, like "Setting up the project now - will take a while" or "Project was (re) - created".
- Live Screenshot: An optional window in the top-right corner displays real-time images of your project's execution. This helps you visually confirm that tasks are proceeding as expected. You can hide, show, or expand this screenshot to full screen for a closer look.
- Gemini Execution Log: Below the terminal, this section lists important events and messages generated by the system, helping you track the detailed history of your project's operations.
Interactive Elements
- Close Button (AppBar): In the top-left corner, this button allows you to exit the project execution page. If a process is still running, it will ask for confirmation to stop the execution before closing.
- Show Execution Result Button: Appears when the project is not actively updating. Clicking this will take you to a dedicated screen to view the final results of your project's execution.
- Stop Execution Button: Appears when a project is actively updating. This red button allows you to immediately halt any ongoing processes, useful if you need to intervene or correct a mistake.
- Retry Button: If an error occurs during the initial loading of project data, this button will appear, allowing you to try loading the data again.
- Screenshot Controls (Hide/Show/Expand): Small buttons next to the live screenshot allow you to manage its visibility and size.
Scenario Executions
Possible usage steps within this page
-
Starting a New Project Execution
When you initiate a new project, you will be brought to this page. You'll see initial messages about loading project data, followed by a series of commands appearing in the terminal. The status message will update, for example, to "Setting up the project now - will take a while".
During this setup, you might see a live screenshot pop up, showing you a visual representation of the actions being performed on the remote system. Keep an eye on the Gemini Execution Log below for detailed progress updates. Once the setup is complete, the status message will change to "Project was (re) - created", and a "Show execution result" button will appear, allowing you to review the outcome.
-
Monitoring an Ongoing Project
If you've started a project and returned to this page, you'll immediately see the current terminal output, status message, and potentially the latest screenshot. This allows you to pick up where you left off and understand its progress.
-
Stopping an Execution
If you realize an execution is going wrong or you need to stop it for any reason, click the red "Stop" button next to the status message. The system will attempt to gracefully halt the process, update the status to "Execution stopped by user", and then close the window.
-
Viewing the Execution Result
After a project has successfully completed (or been stopped), the "Show execution result" button becomes available. Click this button to navigate to a dedicated page where you can see a summary and details of the execution's outcome.
-
Managing the Screenshot View
While the screenshot is visible, you can click the small "Close" icon next to it to hide it. If it's hidden, a "Maximize" icon will appear, allowing you to bring it back. For a more detailed view, click the "Expand to Fullscreen" icon to open the screenshot in a full-screen pop-up.
Possible errors which may occur on this page
-
Failed to Load Project Data
Error: Instead of seeing the terminal and status updates, you might encounter a red error icon and a message like "Failed to get main execution folder" or "Error loading data: [technical error message]".
Why it happens: This typically occurs if there's an issue connecting to the remote system via SSH, or if the initial setup scripts on the remote system cannot be located or executed properly. It prevents the system from preparing the environment for your project.
What to do: Click the "Retry" button. If the error persists, ensure your device is properly configured for SSH access and that the remote server is reachable and correctly set up for project automation.
-
Project Setup Fails or Times Out
Error: During the "Setting up the project now" phase, the terminal output might show error messages, or the process might simply hang for an extended period, eventually leading to a status message like "Failed to setup the project" after a long wait.
Why it happens: The script being run on the remote system (`./setupProjectById.sh`) might encounter issues, such as missing dependencies, incorrect permissions, or other configuration problems on the server. A timeout can occur if the script takes too long to respond or if the SSH connection becomes unstable.
What to do: If you see specific error messages in the terminal, these can provide clues. You might need to contact support or a technical administrator to investigate the remote server's setup. You can also try stopping the execution and restarting it.
-
Session Expired
Error: You might receive a notification that "Your session will soon expire!" or a full "Session Expired" message, which then closes the project execution page.
Why it happens: For security reasons, your connection to the system has a time limit. If you're inactive for too long, or if there's a network interruption, your session will automatically expire.
What to do: If your session is about to expire, try to complete your current task quickly. If it has expired, you will be redirected to log in again. Ensure you have a stable internet connection.
-
Connection Disconnected
Error: The page unexpectedly closes and returns you to a previous screen without a clear error message on this page itself.
Why it happens: The underlying SSH connection to the remote device was lost. This could be due to network issues, the remote device becoming unavailable, or your session being terminated for other reasons.
What to do: Check your internet connection and the status of the remote device. You will likely need to re-establish the connection to the device and restart your project execution from the beginning.
