Troubleshooting
Problem
This problem was active until the v247-2 (fix provided) of the Docker-based backend, but naturally, it can still be found as many clients still use versions prior to v247-2. The problem arises when the client tries to install the backend by running the instana init command:
[root@vuk-vm yum.repos.d]# instana init
Setup host environment ✓
? [Please choose Instana installation type] single
? [What is your tenant name?] <redacted>
? [What is your unit name?] <redacted>
? [Insert your agent key (optional). If none is specified, one is generated which does not allow downloads.] <redacted>
? [Insert your download key or official agent key (optional).] <redacted>
? [Insert your sales key] <redacted>
? [Insert the FQDN of the host] vuk-vm
? [Where should your data be stored?] /instana/data
? [Where should your trace data be stored?] /instana/traces
? [Where should your metric data be stored?] /instana/metrics
? [Where should your logs be stored?] /var/log/instana
? [Path to your signed certificate file?] /instana/cert/tls.crt
? [Path to your private key file?] /instana/cert/tls.key
Handle certificates ✓
Ensure images ✓
Clean docker containers ✓
Check data directories ✓
Run datastores ✓
Create configurations ✓
Migrate data stores ✓
Run components ✓
Check components ✓
Setup environment urls ✗
Put "http://localhost:8481/admin/acceptorsForEnvironment/onprem": dial tcp [::1]:8481: connect: connection refused
Also, the following snippet is visible in the console.log:
2023-05-12T08:26:51.123 INFO ▶ start ui-backend
2023-05-12T08:26:51.570 INFO ▶ wait up to 600 seconds until components are healthy
2023-05-12T08:27:21.855 INFO ▶ Instana components are started for version (247-1)
2023-05-12T08:27:21.856 ERRO ▶ Fail: Setup environment urls
Resolving The Problem
Since we had a few issues with version 247-1, we recommended upgrading to the newest. With yum --showduplicates list instana-console you can find the last version.
For this part the following points have to be considered, ensure that instana-console 247-2 is installed:
yum install instana-console-247_2-1)
After that, run a new init over it with the new release:
instana init --force
Also, you can delete the previous version completely, with the following steps:
instana stop
apt-get remove instana-console or yum remove...
rm -rf /root/.instana
docker system prune -a
and clear the data directories that the customer has configured where our databases write to:
dir {
metrics = "/mnt/metrics"
traces = "/mnt/traces"
data = "/mnt/data"
logs = "/var/log/instana"
}
After that, you can perform a fresh installation of the previously mentioned instana-console 247-2.
Document Location
Worldwide
[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSE1JP5","label":"IBM Instana Observability"},"ARM Category":[{"code":"a8m3p000000UoUEAA0","label":"Backend On-Prem-\u003EBackend On-Prem Installation"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]
Was this topic helpful?
Document Information
Modified date:
08 August 2023
UID
ibm17009641