Login to the GeoDict Cloud and manage the GeoDict Cloud Projects.
GeoDict Cloud Menu
You can find all dialogs for managing the GeoDict Cloud under the Cloud & Queue entry in the menu bar.
The Login to GeoDict Cloud option is only active if you are not currently logged in. Click it to open the Login to GeoDict Cloud Service dialog, where you can enter your Username, Password, and the currently valid One-time Code from your authenticator to log in.
Clicking the Logout from GeoDict Cloud option, directly logs you out from the GeoDict Cloud. If you are not logged in, this option and the GeoDict Cloud Projects are inactive.
The GeoDict Cloud Projects dialog is explained below.
GeoDict Cloud Projects
The GeoDict Cloud Projects option in the Cloud & Queue menu brings you to the corresponding dialog, where you can see all your jobs in the cloud and their associated status.
You can use the Filter field to only show jobs with specific text associated with them. This could be the Project name, part of the Project name, the command used in the Job name (e.g., FiberGeo), or the date the job was created.
Simulation Starting: The cloud machine for this job is currently starting.
Simulation Running: The simulation for this job is currently running on the cloud machine.
Completed: The simulation for this job has been completed. The cloud machine has been shut down.
Downloaded: The results from this job have been downloaded. You can download the results as often as you like, as long as the job has not been deleted.
Error: The simulation for this job has not finished and is not running anymore. This could be due to termination, the simulation failing, or running into the defined timeout.
Click the Refresh button or press F5 to reload the status of all jobs. The dialog does not automatically update, so click this button if you have left the dialog open for a while to check the status of your cloud jobs.
Important! Results for multiple jobs where both Project and Job Name (e.g., MyFirstGeoDictProject and FiberGeoCreate) are identical should not be downloaded simultaneously since this will result in the same file names and overwriting of files. We recommend to define different Job Names to avoid this problem.
When the simulation is completed successfully, the status of the job changes to Completed in the GeoDict Cloud Projects dialog. Select the job (or multiple) and click on Download Results. The Select Files to Download dialog opens. Here you can only choose to download all files in the Result Data. Note that for failed simulations (in the Error state) partial results might stillbe available for download, depending on the cause of the error.
Click OK and select a location where the result files should be stored. The files are downloaded and unpacked automatically to the selected location. A sub-folder is created for each Project Name. Within this folder, another sub-folder for each Job Nameis created. Thus, the results of multiple simulations are automatically grouped into your different projects when downloading. Inside the Job Name folders, you can find the GeoDict results (*.gdr, result folder), the input python scripts to run the command (macro.py, runme.py), and the log file of the cloud machine (geodict.log). A message will inform you that the download and unpacking has successfully finished, and where you can find the data.
Click Show Log to see the current GeoDict log output for this simulation. This information can help you to observe the progress of the computation or identify potential errors. The dialog shows the last 50 lines of the log output. For running simulations, you can update the log by closing the dialog and clicking the Show Log button again.
Select one or more running simulations in the GeoDict Cloud Projects dialog and click Terminate Simulation(s) to cancel them. Only running simulations can be terminated. Before a simulation is terminated, a warning message is shown asking you to confirm that you want to terminate all listed simulations. Note that currently no partial results will be available for terminated simulations.
Click the Delete Job(s) button to delete the currently selected job(s) and all associated results. This will remove all generated files for these jobs from the Cloud Data section. Before a job is deleted, a warning message is shown asking you to confirm that you want to delete the selected jobs. After deleting, the results will not be available anymore. Thus, ensure that you have downloaded all results beforehand. Note that running jobs can not be deleted. They have to be terminated first.
View Cloud Simulations in the Cloud Web Interface
You can also view all your simulations submitted from GeoDict to the cloud in the cloud web interface. Follow the same link that you received for your first login and log in using your credentials. In the Cloud Dashboard you can see information on the currently Running Cloud Machines, all available Jobs, and the stored Cloud Data. The cloud web interface is the same as the Math2Market Cloud.
In the Running Cloud Machines panel, you can see all currently running cloud machines. The User is always your username for the GeoDict Cloud. In contrast to machines started manually from the web dashboard, machines started for GeoDict Cloud simulations are automatically terminated once the simulation is finished, has failed, or the timeout has been reached. Click here for more details on the Running Cloud Machines panel.
In the Jobs panel, you can see all jobs submitted to the GeoDict Cloud. They can be identified by their Project and Job Name. You can see when the job was Created and has Finished. The Finished date is only available when a simulation is completed, failed, or the timeout has expired.
Click on the Input Data button to download all input data files. These contain the python scripts to run the simulation (macro.py, runme.py) and the settings from your local GeoDict that are automatically uploaded to ensure the same settings between local and cloud machine (e.g., your material database). If you chose to upload the structure or project folder, these are contained as well.
When results are available for download, the Results button becomes active. Click it to download all result files in a zipped archive. The name of this archive is an automatically generated sequence of numbers and letters. Therefore, make sure to rename the folder for identification, if you download results from the cloud web interface. The results contain the same files as described for directly downloading from GeoDict.
The Cloud Data panel lists all input and result ZIP files. They are named by an automatically generated sequence of numbers and letters. Therefore, you cannot identify if the ZIP file contains inputs or results and to which job these files belong. If you want to download input or result files, either do so directly from GeoDict or from the Jobs panel.