Skip to content

Commit 04583de

Browse files
committed
Add notes about kpm username/password
1 parent 2618d0b commit 04583de

File tree

3 files changed

+15
-2
lines changed

3 files changed

+15
-2
lines changed

userguide/kaui/includes/plugin-manager.adoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,11 @@ image::../assets/img/kaui/kpm_install.png[width=850,align="center"]
1616
. Click on the download icon next to the plugin that you wish to install.
1717
. Wait a few minutes, then refresh the web page.
1818

19+
[NOTE]
20+
====
21+
If you have changed the default admin username or password in your `shiro.ini` file as explained https://docs.killbill.io/latest/user_management#_kill_bill_setup[here], you must also specify the corresponding values for `org.killbill.billing.plugin.kpm.adminUsername` and `org.killbill.billing.plugin.kpm.adminPassword` in your Kill Bill configuration (See https://docs.killbill.io/latest/userguide_configuration[docs]). Otherwise, plugin installation via Kaui will fail because the KPM plugin will not be able to authenticate with the correct credentials.
22+
====
23+
1924
Once the plugin download is complete, it will appear in Stopped status. To start the plugin, click on the *Start* button.
2025

2126
//COPIED FROM:

userguide/tutorials/plugin_installation.adoc

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,11 @@ A key identifies each entry in that repository, and that key is the `pluginKey`.
6161

6262
== Plugin Installation
6363

64+
[NOTE]
65+
====
66+
If you have changed the default admin username or password in your `shiro.ini` file, you must also specify the corresponding values for `org.killbill.billing.plugin.kpm.adminUsername` and `org.killbill.billing.plugin.kpm.adminPassword` in your Kill Bill configuration. Otherwise, plugin installation (including via Kaui, KPM, or the API) will fail because the KPM plugin will not be able to authenticate with the correct credentials.
67+
====
68+
6469
=== Installing via Kaui
6570

6671
In order to deploy a plugin via Kaui, you need to do the following:
@@ -274,5 +279,3 @@ curl -v \
274279
* https://docs.killbill.io/latest/plugin_management.html[_Plugin Management_]
275280

276281

277-
278-

userguide/tutorials/plugin_management.adoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,11 @@ The following APIs are supported:
4343

4444
=== Installation
4545

46+
[NOTE]
47+
====
48+
If you have changed the default admin username or password in your `shiro.ini` file as explained https://docs.killbill.io/latest/user_management#_kill_bill_setup[here], you must also specify the corresponding values for `org.killbill.billing.plugin.kpm.adminUsername` and `org.killbill.billing.plugin.kpm.adminPassword` in your Kill Bill configuration (See https://docs.killbill.io/latest/userguide_configuration[docs]). Otherwise, plugin installation (including via Kaui or the API) will fail because the KPM plugin will not be able to authenticate with the correct credentials.
49+
====
50+
4651
The installation of a plugin occurs through the KPM plugin (which itself relies on KPM) and consists of the following sequence:
4752

4853
* Download the binaries and install them on the filesystem at the right place

0 commit comments

Comments
 (0)