Store files on Tricentis File Service

No problem! Check out this topic instead. It explains how to attach and view files when Tricentis File Service is turned on.

You have just added a new project to the Tosca Administration Console.

This means that Tricentis File Service and auto-removal are turned on. Tosca automatically saves your files to Tricentis File Service and removes all execution log data that's older than 90 days.

Welcome to Tricentis File Service!

To complete the setup and use Tricentis File Service, take these steps:

1. Make sure that all Tosca workspaces are closed.

2. In Tosca Commander, go to Project->Settings->Tricentis Services and enter the endpoint of Tosca Gateway Service.

   You need to do this in every workspace that should store files on Tricentis File Service.

   Alternatively, you can create project settings for your repository. You only have to do this once as project settings apply to all workspaces connected to this repository.

3. Since auto-removal is turned on, Tricentis File Service automatically removes all execution log data that's older than 90 days.

   You can change the auto-removal settings, for instance if you want to change the number of days or how often Tricentis File Service checks for files to remove. You can also turn off auto-removal. In this case, we recommend that you regularly delete files yourself, to reduce the size of the Tricentis File Service file system.

   Never delete files directly from the Tricentis File Service file system. Doing so will break your project. Only use the delete tasks described in this topic.

4. Once you have a project in the Tosca Administration Console, Tricentis Tosca saves all new files that you create to Tricentis File Service. If you want to move files to Tricentis File Service that already exist in your project, you need to migrate them.

   Before you do so, check your auto-removal settings. It doesn't make sense to spend effort on migrating old execution logs if they'll be auto-removed 2 days later.

5. Some antivirus programs might interfere with Tricentis File Service. If that's the case, add Tricentis.FileService.WebApi.exe to the exclusion list. By default, this file is located at C:\Program Files (x86)\TRICENTIS\Tosca Server\FileService. If you can't exclude files, exclude the storage path you specified in the Tricentis Service Configuration.

We recommend that you back up Tricentis File Service regularly. You can use your backup if you migrate Tricentis Tosca to a new machine, or if you run into issues with your data.

You have an existing project in the Tosca Administration Console where you haven't enabled Tricentis File Service. This means that Tricentis File Service and auto-removal are turned off. Get started with Tricentis File Service!

To enable and use Tricentis File Service, take these steps:

1. Make sure that all Tosca workspaces are closed.

2. In Tosca Commander, go to Project->Settings->Tricentis Services and enter the endpoint of Tosca Gateway Service.

   You need to do this in every workspace that should store files on Tricentis File Service.

   Alternatively, you can create project settings for your repository. You only have to do this once as project settings apply to all workspaces connected to this repository.

3. Open the Tosca Administration Console.

4. Go to the project for which you want to enable Tricentis File Service and click on the Edit icon.

5. This opens the Project details dialog. In the File Service section, select the Enabled checkbox.

6. Click Yes in the confirmation dialog.

7. Decide whether you want to use auto-removal or not:

   • If you want to use it, leave the Auto-removal checkbox in the Project details dialog selected. In this case, Tricentis File Service automatically removes all execution log data that's older than 90 days. You can change the auto-removal settings, for instance if you want to change the number of days or how often Tricentis File Service checks for files to remove.

   • If you don't want to use auto-removal, clear the Auto-removal checkbox. In this case, Tricentis File Service keeps all execution log data indefinitely. We recommend that you regularly delete files yourself, to reduce the size of the Tricentis File Service file system.

   Never delete files directly from the Tricentis File Service file system. Doing so will break your project. Only use the delete tasks described in this topic.

8. Click Save.

9. Once you have enabled Tricentis File Service, Tricentis Tosca saves all new files that you create to Tricentis File Service. If you want to move files to Tricentis File Service that already exist in your project, you need to migrate them.

   Before you do so, check your auto-removal settings. It doesn't make sense to spend effort on migrating old execution logs if they'll be auto-removed 2 days later.

10. Some antivirus programs might interfere with Tricentis File Service. If that's the case, add Tricentis.FileService.WebApi.exe to the exclusion list. By default, this file is located at C:\Program Files (x86)\TRICENTIS\Tosca Server\FileService. If you can't exclude files, exclude the storage path you specified in the Tricentis Service Configuration.

We recommend that you back up Tricentis File Service regularly. You can use your backup if you migrate Tricentis Tosca to a new machine, or if you run into issues with your data.

You have an existing project in the Tosca Administration Console where you have already enabled Tricentis File Service. This means that Tricentis File Service is turned on, but auto-removal is turned off.

Click here for information on how to turn on auto-removal.

This is not mandatory. You can still use Tricentis File Service without auto-removal. In this case, we recommend that you regularly delete files yourself, to reduce the size of your Tricentis File Service file system.

Never delete files directly from the Tricentis File Service file system. Doing so will break your project. Only use the delete tasks described in this topic.