Common issues with Administration Console and how to resolve them
this article is valid for Tosca version 12.3 - 13.1
- One of the services fails during setup
- Certificate not available from the SSL Certificate drop-down in IIS
- ClientSecrets are missing
- Error: "Please enter a valid certificate" in ServiceConfiguration
- Error: while doing the requested operation for project "<project name>". undefined
- Firefox shows the certificate as invalid and not trusted
- AdminConsole page stays blank only in Chrome because of CORS violation
- Missing Icons in the Tosca Server with Internet Explorer
- AdminConsole is stuck at verifying Tosca installation
- .NET Core error. "An error occurred while starting the application. "
- run as administrator
- start services.msc to open the Services Manager and select the corresponding service. Change the user from LocalSystem to the currently logged in user during the setup and click on "Retry". You can also try other suggestions from stackoverflow.
- check if the runtime is properly installed (is the following folder available "C:\Program Files\dotnet\shared\Microsoft.NETCore.App\2.2.3"? If not, install the runtime manually) https://dotnet.microsoft.com/download/dotnet-core/thank-you/runtime-aspnetcore-2.2.3-windows-hosting-bundle-installer
- check the logs of the corresponding service and windows EventViewer logs. It might give you some hints on what else has gone wrong
Certificate requirements are not met. Verify ALL requirements: SSL Certificate requirments, especially the following:
- The certificate needs to be under Local Computer\Personal\Certificates certificate store for IIS to use it.
- The root certificate for the Certificate Authority needs to be in Local Computer\Trusted Root Certification Authorities.
- SSL certificate is missing the private key
source: IIS forum: https://forums.iis.net/t/1239928.aspx?
Do not unselect the checkbox "Open ServiceConfigurator" after setup is finished.
If someone already skipped this step i would recommend to copy the secrets manually, reinstall, or starting from Tosca 13.0 you can simply open ServiceConfiguration.exe at least once to generate the secrets automatically!
- certificate location/store field in ServiceConfiguration needs to be changed to reflect the correct location
- thumprint has a typo or is invalid
- invisible character is being inserted in the field as a result of copy/paste from Microsoft Management Console (MMC). See if the message disappears if you click on the begging of the thumbprint and press DEL at least two times.
- If you see the following failed request in browser console:
PUT http://localhost:81/AdministrationConsole/api/projects 405 (Method Not Allowed)
Disable WebDAV Publishing in IIS or remove webDav module and handler by adding the following snippet to the AdminConsole web.config
<system.webServer> <modules> <remove name="WebDAVModule" /> </modules> <handlers> <remove name="WebDAV" /> </handlers> </system.webServer>
go to "about:config" in FF, set "security.enterprise_roots.enabled" to "true" and refresh your browser
- Check the browser dev console. If you see the following:
The page’s settings blocked the loading of a resource at https://<yourhostname.domain>:5000/.well-known/openid-configuration (“connect-src”).
Most probably the access to the page is blocked by CORS policy.
Open the web.config file of AdminConsole. Add a more flexibile origin in the Content-Security-Policy header to frame-src and connect-src using wildcards e.g. *.tricentis.com:*
- select Settings -> Compatibility View -> "Display intranet pages in comp. view"
- try other doc. modes (F12 -> Emulation -> Document Mode).
- Check the browser dev console. If the following request returns an 500 Internal Server Error: https://<hostname>/AdministrationConsole/api/projects/IsCommanderAvailable than you probably have to install Tosca Commander client of the same version as your Tosca Server.
- ClientSecret from AuthenticationService appsetting.json is not matching with the one from ServiceDiscovery appsetting.json
- Make sure that the BaseUrl in C:\Program Files (x86)\TRICENTIS\Tosca Server\ToscaAdministrationConsole\appsettings.json is set to a valid DNS alternative name (hostname, hostname.domain).
- ToscaCommanderClient of the same version as ToscaServer is not installed on the machine (missing assemblies)
- machine is slow - Services hosted in iis start earlier than the windows services (ServiceDiscovery, Auth, Project). In this case, simple iisreset helps after all windows services are up and running. (You can simply reproduce this issue e.g. by restating your machine and preventing servicediscovery from starting. After startup navigate to the admin console to see the error.)
- wrong configuration, verify especially the appsetting.json of MigrationService and AdminConsole.
- check if the runtime is properly installed