Publishing Account Information
| PERMISSIONS REQUIRED |
| To use the publishers framework, you must be a provider account administrator. For more information, see the Overview. |
With the Nimbul publishers framework, you can create lists of instances and related information, such as cluster host lists, configuration files and server scripts. Use a publisher when you need to summarize your accounts and instances in a format that is viewable outside of Nimbul.
Topics covered on this page:
Publisher Types
Configuring a Publisher
Running a Publisher
Publisher Types
Nimbul supports three types of publishers. For each type, the files are published to the Amazon S3 bucket configured for that publisher.
- LDNS Publisher: Publishes DNS host files for the provider account overall and for each cluster within the account. The resulting files can be used in local
hostsfiles. This publisher type also creates a read-only environment variable for the provider account:HOSTS_FILE_URL, which is set to the URL of the published file for the overall provider account. - Nagios Publisher: Publishes a list of instances with DNS and role information, suitable for importing into Nagios as a configuration file.
- Server Script Publisher: Publishes a full set of Nimbul configuration scripts (start, stop, restart and list). The scripts are published in a tree structure:
S3://The server scripts publisher is based on the open-source project CloudMaster.Cluster 1 Server Profile 1 startup list reboot stop get-hosts put-hosts run-server-cmd Server Profile 2 … Cluster 2 …
Configuring a Publisher
The steps in this section refer to the Communication tab of a provider account. The Account Publishers area appears at the bottom of the tab.
Adding a New Publisher
To set up a new publisher, complete these steps:
- In the main Nimbul menu, click Provider Accounts. The provider accounts dashboard appears, showing basic information about the provider accounts to which you have access. Click the name of a provider account, and then click the Communication tab.
- From the drop-down list in the Account Publishers area at the bottom of the tab, select the type of publisher you want to add. (See image above.)
- Click the green plus sign next to the drop-down list. The New Publisher page appears.
- Specify an S3 Bucket Name and S3 Object Name for the publisher. (These do not have to already exist; Nimbul will create them.)
Editing an Existing Publisher
To edit the configuration of an existing publisher, complete these steps.
- In the main Nimbul menu, click Provider Accounts. A provider accounts dashboard appears, showing basic information about the provider accounts to which you have access. Click the name of a provider account, and then click the Communication tab.
- In the Account Publishers area, click the name of the publisher. A publisher summary page appears.
- Edit the S3 Bucket Name and S3 Object Name as necessary.
- Click Update. A confirmation message appears on the left side of the page.
Running a Publisher
To publish account information, complete these steps:
- In the main Nimbul menu, click Provider Accounts. The provider accounts dashboard appears, showing basic information about the provider accounts to which you have access. Click the name of a provider account, and then click the Communication tab.
- Find the appropriate publisher in the Account Publishers area at the bottom of the tab. If the type of publisher you want to run does not appear in the list, add a new publisher.
- [Optional] In the Actions column for the publisher you want to run, click the magnifying glass icon to verify that Nimbul can access the Amazon S3 bucket. (See image above.)
- Click the green arrow in the far right column. Links to the published files will appear in the Details column.
End of section. Next section: Clusters and Servers »