diff --git a/generator/_config.yml b/generator/_config.yml index fbbba3437..1093b24b5 100644 --- a/generator/_config.yml +++ b/generator/_config.yml @@ -4,7 +4,7 @@ safe: false plugins: ./_plugins/ # baseurl: /docs/master/ git-repository: github.com/cfengine/documentation -git-branch: "3.23" +git-branch: "3.26" #source: ./pages/ #destination: #layouts: ./_layouts/ @@ -17,24 +17,24 @@ CFE_OUTPUT: true #CFE_DIR - output folder if CFE_OUTPUT turned on CFE_DIR: _site #to create correct links in sitemap -CFE_manuals_version: "master" +CFE_manuals_version: "3.26" cfengine: - branch: "master" - core_branch: "master" + branch: "3.26" + core_branch: "3.26.0" latest_patch_release: 0 - latest_package_build: 1a + latest_package_build: 1 vagrant_package_build: 1 - masterfiles_branch: "master" + masterfiles_branch: "3.26.0" Template: parse: line_numbers: true vagrant: - version: "2.2.19" + version: "2.4.5" virtualbox: - version: "6.1.38" + version: "7.0.16" paginate: 500 @@ -46,5 +46,5 @@ asset_pipeline: bundle: true # Default = true compress: true # Default = true output_path: assets # Default = assets - display_path: docs/master/assets # Default = nil + display_path: docs/3.26/assets # Default = nil gzip: false # Default = false diff --git a/reference/functions/getbundlemetatags.markdown b/reference/functions/getbundlemetatags.markdown index d30d1b677..d509d1658 100644 --- a/reference/functions/getbundlemetatags.markdown +++ b/reference/functions/getbundlemetatags.markdown @@ -10,15 +10,22 @@ published: true [%CFEngine_function_attributes(bundlename, optional_tag)%] -The `optional_tag` can be used to look up a specific tag's value. If you have +The `optional_tag` can be used to look up a specific tag's value. +If you have: + ```cf3 bundle agent example { meta: "tags" - slist => { "mykey=myvalue1", "mykey=myvalue2", "yourkey=yourvalue1" }; + slist => { + "mykey=myvalue1", + "mykey=myvalue2", + "yourkey=yourvalue1", + }; } ``` + then `getbundlemetatags( "example", "mykey" )` will return a list with two entries, `{ "myvalue1", "myvalue2" }`. diff --git a/reference/functions/hostswithgroup.markdown b/reference/functions/hostswithgroup.markdown index 14f8e56d9..dbf9024f4 100644 --- a/reference/functions/hostswithgroup.markdown +++ b/reference/functions/hostswithgroup.markdown @@ -19,16 +19,16 @@ On CFEngine Enterprise, this hub function can be used to return a list of hostna ```cf3 bundle agent debian_hosts { -vars: - - am_policy_hub:: - "host_list" slist => hostswithgroup( "Linux", "name" ); - -files: - am_policy_hub:: - "/tmp/master_config.cfg" - edit_line => insert_lines("host=$(host_list)"), - create => "true"; + vars: + am_policy_hub:: + "host_list" + slist => hostswithgroup( "Linux", "name" ); + + files: + am_policy_hub:: + "/tmp/master_config.cfg" + edit_line => insert_lines("host=$(host_list)"), + create => "true"; } ``` diff --git a/reference/functions/isconnectable.markdown b/reference/functions/isconnectable.markdown index 282c50e46..fe993a7d9 100644 --- a/reference/functions/isconnectable.markdown +++ b/reference/functions/isconnectable.markdown @@ -14,7 +14,7 @@ This function checks whether a `hostname`:`port` is connectable within `timeout` **Example:** -[%CFEngine_include_snippet(isconnectable.cf, #\+begin_src cfengine3, .*end_src)%] +[%CFEngine_include_example(isconnectable.cf)%] **History:** diff --git a/reference/functions/useringroup.markdown b/reference/functions/useringroup.markdown new file mode 100644 index 000000000..2b3f82c7e --- /dev/null +++ b/reference/functions/useringroup.markdown @@ -0,0 +1,25 @@ +--- +layout: default +title: useringroup +published: true +--- + +[%CFEngine_function_prototype(user)%] + +**Description:** Return whether a `user` is a member of a given `group` + +Looks up the group `"group_name"` in the group database located in /etc/group and checks whether `"user_name"` is one of its members. This function is not available on Windows. + +[%CFEngine_function_attributes(user_name, group_name)%] + +**Example:** + +[%CFEngine_include_snippet(useringroup.cf, #\+begin_src cfengine3, .*end_src)%] + +Output: + +[%CFEngine_include_snippet(useringroup.cf, #\+begin_src\s+example_output\s*, .*end_src)%] + +**History:** + +- Added in CFEngine 3.26.0 diff --git a/release-notes/known-issues.markdown b/release-notes/known-issues.markdown index bc401b94f..85ba51b5c 100644 --- a/release-notes/known-issues.markdown +++ b/release-notes/known-issues.markdown @@ -5,9 +5,30 @@ sorting: 50 published: true --- -CFEngine defects are managed in our [bug tracker][bug tracker]. Please report -bugs or unexpected behavior there, following the documented guideline for new -bug reports. +CFEngine defects are managed in our [bug tracker][bug tracker]. +Please report bugs or unexpected behavior there, following the documented guideline for new bug reports. -* Issues [affecting {{site.CFE_manuals_version}}](https://northerntech.atlassian.net/issues/?jql=project+in+%28ENT%2C+CFE%29+AND+affectedVersion+%7E+%22{{site.CFE_manuals_version}}.*%22+AND+status+not+in+%28+%22Rejected%22%29) -* Issues [fixed in {{site.CFE_manuals_version}}](https://northerntech.atlassian.net/issues/?jql=project+in+%28ENT%2C+CFE%29+AND+fixVersion+%7E+%22{{site.CFE_manuals_version}}.*%22) +- Issues [affecting {{site.CFE_manuals_version}}](https://northerntech.atlassian.net/issues/?jql=project+in+%28ENT%2C+CFE%29+AND+affectedVersion+%7E+%22{{site.CFE_manuals_version}}.*%22+AND+status+not+in+%28+%22Rejected%22%29) +- Issues [fixed in {{site.CFE_manuals_version}}](https://northerntech.atlassian.net/issues/?jql=project+in+%28ENT%2C+CFE%29+AND+fixVersion+%7E+%22{{site.CFE_manuals_version}}.*%22) + +On this page (below) we will only mention a subset of known issues, which are very severe or noticeable, which we'd like to communicate with users. + +## 3.26.0 Hub package installation hangs with cf-remote on Ubuntu + +**Ticket:** [CFE-4528](https://northerntech.atlassian.net/browse/CFE-4528) + +The `dpkg -i` command seems to cause cf-remote to hang forever in this particular case. +Issue is specific to 3.26.0, hub, and Ubuntu. +Client packages work, other OSes work, and previous versions also work. +We will fix this issue before 3.27.0 LTS. + +**Workarounds:** + +- If you've already ran the command and see it hanging: + - Open another terminal and connect with SSH. + - Look at the installation log (`sudo less /var/log/CFEngineInstall.log`). + - You should see that installation completed successfully and there is a setup code. + - Interrupt (Ctrl-c) the hanging `cf-remote` command. + - Run bootstrap manually. + - Use the setup code from the install log to set up Mission Portal for the first time. +- Otherwise, just download and install CFEngine manually, without cf-remote, or use a different platform, like RHEL, for your hub.