...
Table of Contents | ||
---|---|---|
|
...
1 - Context
If you are getting a connection timeout error when attempting to access an app on Nex!™ it is likely that something wrong is going on with all the routing racks. When this issue occurs you are likely to observe the following error in Chrome:
2 - Checking Nginx on the routing racks
The following steps assume that you have installed the Nex!™ CLI
...
Nginx not starting is usually related to default SSL certificates not being setup properly. If the above command yields an error related to SSL, Private Key, Public Key then go to section 3.
3 - Fixing the default SSL certificates
If the default Nginx certificates are not properly setup - e.g. missing public or private key, keys not matching - Nginx will simply refuse to start. This problem typically indicates that the Nex!™ Orchestrator configuration is incorrect.
3.1 - Immediate resolution
The fastest way to resolve this issue is to manually re-setup the Nginx default SSL certificates. For that you will need access to:
...
After bringing Nginx back up and verifying that your web applications were accessible again proceed to section 3.2 to permanently resolve the issue.
3.2 - Permanent resolution
As we mentioned at the beginning of the section this kind of SSL issue is symptomatic of a configuration issue with the orchestrator itself. You should therefore review the SSL certificates configuration variables in Nex!™ to ensure they match your certificate keys.
a) Using Ansible
If you are using Maestrano's Ansible framework to deploy the Nex!™ orchestrator then you should review your ssl
configuration in the *_secret.yml file. See this example of configuration file to understand what to look for:
https://github.com/maestrano/mno-deploy-nexmin/blob/master/ansible/vars/nexmin_prd_secrets.yml#L111
The following variables must be set properly:
- cert_key_cube_default: your wildcard certificate private key with newline characters ("\n"). The content of the variable must be enclosed with single quotes
- cert_chained_cube_default: the concatenation of your certificate and your Certificate Authority bundle. The variable must be a single line with newline characters ("\n") and must be enclosed with single quotes
b) Using Rails configuration