SaaS - Frequently asked questions
This page provides answers to frequently asked questions and highlights common issues developers may encounter when developing projects for SaaS deployments.
What to do when starting with Xperience by Kentico SaaS?
You have just received an invitation to an Xperience by Kentico SaaS project. What steps should you take to get started with SaaS development? What materials about SaaS are available?
The following materials provide guidance for users who first encounter the Xperience by Kentico SaaS:
- SaaS guides will help you navigate the necessary steps to access your Xperience Portal project for the first time and enable your team to work on it.
- SaaS page in the documentation provides links to all documentation materials relating to SaaS.
- The following materials contain useful information. However, they are not part of the official documentation and therefore may contain information that is not up-to-date with the latest Xperience releases:
- Xperience by Kentico CI/CD developer scenarios blog post by Sean Wright
- Kentico’s Xperience Portal and SaaS: From Setup to Production article by Milan Lund
- Mastering serialization at Xperience by Kentico blog post by Lukasz Skowroński
- How to migrate content from PROD to QA within your SaaS Xperience by Kentico? blog post by Lukasz Skowroński
Why do you need to accept the Terms of Service?
After the SaaS Terms of Service (ToS) is updated by Kentico, all projects must accept the ToS within 30 days. Failure to do so may result in the project becoming unavailable for developers and DevOps personnel.
An updated version of the Terms of Service needs to be accepted by the primary contact. You can identify the primary contact by the crown icon in the Users listing in the Xperience Portal.
What can you do to troubleshoot your project?
Your application has encountered an unexpected issue. Where can you look to troubleshoot the issue and find the cause of the problem?
There are multiple tools to help you troubleshoot issues with the SaaS solution:
- Check the Event log in the Xperience administration interface.
- In the Xperience Portal:
- Check the Deployment history section in the Deployments application and download the deployment logs.
- Note that deployments take a moment to be listed in the deployment history from when they are started.
- Check the event log and exceptions for any unexpected issues.
- Check the performance metrics for any recent spikes in resource usage.
- You can restart the deployed application to see if this resolves the issue.
- Check the Deployment history section in the Deployments application and download the deployment logs.
Finally, you can check the current status of the Xperience SaaS infrastructure on the Xperience by Kentico Status page.
How can you troubleshoot performance issues of the live site?
Your live site has performance issues and you are trying to find out what is the bottleneck causing the issues.
In Xperience Portal, navigate to Monitoring → Project metrics, where you can see various information about the performance of your application in a specified time frame. You can identify which part of the application is causing the bottleneck and proceed accordingly. You can either optimize your project or, if the issue is the amount of traffic, upgrade your service plan.
Additionally, you can enable email notifications to alert you when performance metrics of your project are on the limit of your service plan. See Alerts for more information.
Finally, you can check the current status of the Xperience SaaS infrastructure on the Xperience by Kentico Status page.
How to resolve database inconsistencies on SaaS environments?
Database inconsistencies may be introduced for various reasons (custom development, integration and migration scenarios) to databases of SaaS projects, but developers do not have direct access to run SQL scripts on databases of applications deployed in SaaS environments.
You can use CD migration scripts to perform SQL queries on the database of applications deployed in SaaS environments. However, remember to always create a backup before modifying the database.
How to resolve broken deployment package in the Production environment?
You may encounter an issue where you deploy a package to the SaaS environment and promote it to the Production environment before realizing that the package is faulty and causes issues on your live site.
There are two options how to handle this situation:
- You can restore a previous backup of your application directly from the Xperience Portal interface. The system automatically creates backups before each deployment. Note that you may lose content created between the faulty deployment and the time when you choose to restore the backup.
- You can create a new deployment package that fixes the previous issue if possible. The advantage is that all recently created content is preserved. This approach works best when using smaller and more frequent deployments which enable you to identify the cause of the issue.
What is the user limit in Xperience Portal?
A common misunderstanding is that when using the Xperience SaaS there is a limit of 20 users for the entire solution, including the Xperience administration interface. The user limit only applies to the users in the Xperience Portal. The number of users in the administration interface of your Xperience application is not limited.
How to obtain license keys for local development?
Why can you not create license keys in the client portal and where should you create your license keys?
License keys for SaaS development are generated in the License key generator application in the Xperience Portal.
See Licenses for more information.