diff options
author | Ryan Mulligan <ryan@ryantm.com> | 2021-03-31 22:02:52 -0700 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-03-31 22:02:52 -0700 |
commit | 86eedf1785637d1f779f6127544864ad3162588a (patch) | |
tree | c2989102f8d96b35152e9842c8ffea01beec315c /doc | |
parent | d9b57bfc2c30baef234ddb61e501b4b1c33a0964 (diff) | |
parent | dd50188f4b0962d6e1f67c8076b1855a01538402 (diff) |
Merge pull request #108918 from bryanasdev000/doc-citrix
citrix: Update doc to use CommonMark
Diffstat (limited to 'doc')
-rw-r--r-- | doc/builders/packages/citrix.section.md | 32 | ||||
-rw-r--r-- | doc/builders/packages/index.xml | 2 |
2 files changed, 33 insertions, 1 deletions
diff --git a/doc/builders/packages/citrix.section.md b/doc/builders/packages/citrix.section.md new file mode 100644 index 000000000000..b25ecb0bdefc --- /dev/null +++ b/doc/builders/packages/citrix.section.md @@ -0,0 +1,32 @@ +# Citrix Workspace {#sec-citrix} + +The [Citrix Workspace App](https://www.citrix.com/products/workspace-app/) is a remote desktop viewer which provides access to [XenDesktop](https://www.citrix.com/products/xenapp-xendesktop/) installations. + +## Basic usage {#sec-citrix-base} + +The tarball archive needs to be downloaded manually as the license agreements of the vendor for [Citrix Workspace](https://www.citrix.de/downloads/workspace-app/linux/workspace-app-for-linux-latest.html) needs to be accepted first. Then run `nix-prefetch-url file://$PWD/linuxx64-$version.tar.gz`. With the archive available in the store the package can be built and installed with Nix. + +## Citrix Selfservice {#sec-citrix-selfservice} + +The [selfservice](https://support.citrix.com/article/CTX200337) is an application managing Citrix desktops and applications. Please note that this feature only works with at least citrix_workspace_20_06_0 and later versions. + +In order to set this up, you first have to [download the `.cr` file from the Netscaler Gateway](https://its.uiowa.edu/support/article/102186). After that you can configure the `selfservice` like this: + +```ShellSession +$ storebrowse -C ~/Downloads/receiverconfig.cr +$ selfservice +``` + +## Custom certificates {#sec-citrix-custom-certs} + +The `Citrix Workspace App` in `nixpkgs` trusts several certificates [from the Mozilla database](https://curl.haxx.se/docs/caextract.html) by default. However several companies using Citrix might require their own corporate certificate. On distros with imperative packaging these certs can be stored easily in [`$ICAROOT`](https://developer-docs.citrix.com/projects/receiver-for-linux-command-reference/en/13.7/), however this directory is a store path in `nixpkgs`. In order to work around this issue the package provides a simple mechanism to add custom certificates without rebuilding the entire package using `symlinkJoin`: + +```nix +with import <nixpkgs> { config.allowUnfree = true; }; +let + extraCerts = [ + ./custom-cert-1.pem + ./custom-cert-2.pem # ... + ]; +in citrix_workspace.override { inherit extraCerts; } +``` diff --git a/doc/builders/packages/index.xml b/doc/builders/packages/index.xml index 9653bae472d4..a2bcd4315311 100644 --- a/doc/builders/packages/index.xml +++ b/doc/builders/packages/index.xml @@ -5,7 +5,7 @@ <para> This chapter contains information about how to use and maintain the Nix expressions for a number of specific packages, such as the Linux kernel or X.org. </para> - <xi:include href="citrix.xml" /> + <xi:include href="citrix.section.xml" /> <xi:include href="dlib.xml" /> <xi:include href="eclipse.section.xml" /> <xi:include href="elm.section.xml" /> |