How can I set up multiple hosts?¶

Required Conditions¶

1. You should be using databases which allows network connection from multiple hosts, like MySQL or PostgreSQL.
2. SQLite can't be used for multiple host configuration.

How to add a new host¶

Definitions¶

1. Host A = Existing host (Karesansui installed)
2. Host B = A new host to be added

Step 1. Check the version of exisiting Karesansui¶

Access Karesansui on host A, click "Options" which are in the header, and display "About Karesansui" screen. Take a memo of the version information.

Step 2. Install Karesansui in host B¶

Download the same version of the Karesansui you checked in Step 1, and install it into host B.

warning: While the install process, you will be asked about the database location. Specify the same location of host A, and DO NOT CHECK the "Initilize database" checkbox.

Step 3. Check the Karesansui unique key of host B¶

Look in /etc/opt/karesansui/application.conf of the host B, and find "application.uniqkey". The value is the unique key of host B. We use this in Step4, so take a memo of the unique key. example) application.uniqkey=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Step 4. Add host B to host A Karesansui¶

Access host A, and click "Add" at the top page to add a host. Input required fields and press "Add".

Some explaination:
- Host Name (required): The host name to display on Karesansui control panel. There are no restrictions for this name so choose the name you like.
           Example）Host B

- FQDN (required): FQDN of host B to access from the client. Input a FQDN or an IP address.
           Example）hostb.karesansui-project.info / 192.168.0.1

- UUID (required) : Input the Karesansui unique key of Host B you checked in Step 3.
- Note : Space for a memo.
- Tags : Tags to put on this host.

Step 5. Testing¶

Access host A Karesansui control panel, and click host B icon (usually the N/A icon are displayed) to display details. Find "Link to host" in "Other Information" and click to see the host B control panel. Basic authorization may be required at this step. 

If you see host B name in the control panel header, host was successfully added. *A

*A : Host name should appear in the right of this image.

P.S.: Host B icon can be changed on host B control panel.