Product Documentation

Customize a Receiver for Linux installation

Nov 04, 2013

You can customize Receiver configuration before installation by modifying the contents of the Receiver package and then repackaging the files. Your changes will be included in every Receiver installed using the modified package.

Important: Connecting from 64-bit user devices running the self-service user interface or storebrowse to StoreFront servers may cause issues that affect the user experience adversely. See the topic About this release in eDocs for more information, including workarounds, for specific issues. If you experience any of these, Citrix recommends using Receiver for Web instead of StoreFront to launch connections.

To customize a Receiver for Linux installation

  1. Expand the Receiver package file into an empty directory. The package file is called platform.major.minor.release.build.tar.gz (for example, linuxx86.13.0.0.nnnnnn.tar.gz for the Linux/x86 platform).
  2. Make the required changes to the Receiver package. For example, you might add a new SSL root certificate to the package if you want to use a certificate from a Certificate Authority that is not part of the standard Receiver installation. To add a new SSL root certificate to the package, see the topic Install root certificates on user devices in eDocs. For more information on built-in certificates, see the topic Configure and enable SSL and TLS in eDocs.
  3. Open the PkgID file.
  4. Add the following line to indicate that the package was modified: MODIFIED=traceinfo where traceinfo is information indicating who made the change and when. The exact format of this information is not important.
  5. Save and close the file.
  6. Open the package file list, platform/platform.psf (for example, linuxx86/linuxx86.psf for the Linux/x86 platform).
  7. Update the package file list to reflect the changes you made to the package. If you do not update this file, errors may occur when installing your new package. Changes could include updating the size of any files you modified, or adding new lines for any files you added to the package. The columns in the package file list are:
    • File type
    • Relative path
    • Sub-package (which should always be set to cor)
    • Permissions
    • Owner
    • Group
    • Size
  8. Save and close the file.
  9. Use the tar command to rebuild Receiver package file, for example: tar czf ../newpackage.tar.gz * where newpackage is the name of the new Receiver package file.