Skip to content
Permalink
Browse files

Merge pull request #65 from killbill/kpm-diagnostic-docker

debugging: document kpm diagnostic in Docker
  • Loading branch information...
pierre committed May 6, 2019
2 parents 6dc0f79 + 47dd274 commit 895057e1f436d6e77f78223a294ad76844f3e2e6
Showing with 15 additions and 16 deletions.
  1. +1 −12 userguide/platform/userguide_deployment.adoc
  2. +14 −4 userguide/tutorials/debugging.adoc
@@ -31,18 +31,7 @@ Kill Bill is fundamentally a backend system, so the following considerations sho
* Verify the integration with your payment gateway(s): very few payment transactions (if any) should be in an `UNKNOWN` state. Make sure to fix these manually via the Payment Admin API, if the plugin is unable to do it automatically.
* Have a monitoring system in place (we recommend https://github.com/killbill/killbill-cloud/tree/master/docker/compose[Elasticseach, Logstash, Kibana, InfluxDB and Grafana], which can be easily setup for Kill Bill) and watch your logs constantly: any `WARN` or `ERROR` entry should be reviewed, as well as stacktraces.
* Monitor metrics at `/1.0/metrics` and integrate the healthcheck at `/1.0/healthcheck` with your load balancer.
* Join our https://groups.google.com/forum/#!forum/killbilling-users[mailing-list] to get notified of new releases or ask questions. For inquiries regarding your specific setup, always attach a https://github.com/killbill/killbill-cloud/tree/master/kpm[KPM] diagnostic output:

[source,bash]
----
kpm diagnostic --killbill-api-credentials=bob lazar \
--killbill-credentials=admin password \
--killbill-url=http://127.0.0.1:8080 \
--killbill-web-path=/var/lib/tomcat7/webapps/ROOT/ \
--kaui-web-path=/var/lib/tomcat7/webapps/ROOT/ \
--log-dir=/var/lib/tomcat7/logs \
--account_export=ACCOUNT_ID
----
* Join our https://groups.google.com/forum/#!forum/killbilling-users[mailing-list] to get notified of new releases or ask questions.

== Deployment options

@@ -532,8 +532,18 @@ In your message, specify:
kpm diagnostic --killbill-api-credentials=bob lazar \
--killbill-credentials=admin password \
--killbill-url=http://127.0.0.1:8080 \
--killbill-web-path=/var/lib/tomcat7/webapps/ROOT/ \
--kaui-web-path=/var/lib/tomcat7/webapps/ROOT/ \
--log-dir=/var/lib/tomcat7/logs \
--account_export=ACCOUNT_ID
--killbill-web-path=/var/lib/tomcat/webapps/ROOT.war \
--log-dir=/var/lib/tomcat/logs \
--account-export=ACCOUNT_ID
----

If you are using our standard Docker images, you can simply run the following command in the Kill Bill container:

[source,bash]
----
$KPM_DIAGNOSTIC_CMD -e killbill_user=admin \
-e killbill_password=password \
-e killbill_api_key=bob \
-e killbill_api_secret=lazar \
-e killbill_account=ACCOUNT_ID
----

0 comments on commit 895057e

Please sign in to comment.
You can’t perform that action at this time.