Articles in this section

New Self-Hosted KOTS Installation FAQ

Avatar
Amanda Jennewein
Updated
Issue Solution
I ran into a problem setting up my new Jama Connect KOTS environment. What should I do? If you run into issues during installation, stop what you're doing, and follow these steps:

1. Review the system requirements and supported software to ensure you're meeting the requirements.

2. Review the database server requirements to ensure you set up and configured the databases correctly.

3. Ensure your database server and application server can access each other.

If these components are configured correctly, contact Jama Software Customer Support for help.
I ran into a problem while installing KOTS and I have Security-Enhanced Linux (SELinux) enabled. Is that okay? 

When you install Jama Connect, you must disable SELinux. 

To see if SELinux is enabled:

getenforce

If SE Linux is in enforcing mode, you must disable it (permissive mode is okay): 

setenforce 0
I ran into a problem while installing KOTS and I have my firewall enabled. Is that okay?

When you install Jama Connect, you must disable the firewall. 

To see if your firewall is enabled:

systemctl status firewalld
How do I know my databases are set up and configured correctly? 

If you followed the database configuration requirements, you'll have three databases.  

To confirm the list of databases:

show databases;

To ensure permissions are configured correctly for the database users that were previously created, follow the database configuration requirements to regrant those permissions.
When I run commands from the CLI, I see the message "Error: permission denied." How can I fix this?  Use the sudo command during installation to ensure you are running commands as an admin. 
I used an IP address during installation for my servers and I encountered problems. Is this supported?  No; only fully-qualified domain names are supported in KOTS. 
I see the message "Problem: provisioning is in an unexpected state: error.”  How can I fix this?  Confirm that your Elasticsearch variables are correctly set in the etc/sysctl.conf file:

sudo sysctl -a | grep max_map_count

If you don't get a result, set the variables:

sudo echo vm.max_map_count = 262144" >> /etc/sysctl.conf
sudo sysctl -w vm.max_map_count=262144
Provisioning my tenant failed, and the KOTS Admin Console shows my application is unavailable. How can I fix this? 

In most cases, an error indicating failure to provision a tenant means you need to perform a new installation. 

1. From a command line, run this command:

kubectl get pods


2. If Elasticsearch restarts or crashes, confirm that your Elasticsearch variables are correctly set in the etc/sysctl.conf file:

sudo sysctl -a | grep max_map_count

If you don’t get a result, set the variables:

sudo echo vm.max_map_count = 262144" >> /etc/sysctl.conf
sudo sysctl -w vm.max_map_count=262144

3. Delete all Kubernetes pods:

kubectl delete pvc/tenantfs pvc/volume-core-ingress-
0 pvc/volume-core-jobs-0 pvc/volume-core-reports-0
pvc/volume-core-0 pvc/volume-activemq-0 pvc/volume-diff-0

kubectl delete pvc/volume-elasticsearch-0
pvc/volume-hazelcast-0 pvc/volume-
nginx-0 pvc/volume-oauth-0
pvc/volume-saml-0 pvc/volume-search-0

kubectl delete sts/elasticsearchjobs/tenant-manager
jobs/tenant-manager-for-cluster

kubectl delete pvc/volume-elasticsearch-0
pvc/volume-elasticsearch-1
pvc/volume-elasticsearch-2

kubectl delete svc/core svc/activemq svc/core-
ingress svc/core-jobs svc/core-reports
svc/elasticsearch svc/elasticsearch-discovery
svc/search svc/diff svc/hazelcast svc/oauth svc/saml
svc/nginx


4. In the console of your database, replace <database_name> with the name of the Jama Connect database created during the previous configuration:

DROP DATABASE <database_name>;
CREATE DATABASE <database_name> character set utf8mb4;


5. From the KOTS Admin Console, click Redeploy to set up your Kubernetes pods.
   

Related articles

Comments

0 comments

Please sign in to leave a comment.