Solution

There are several options to adjust the installation of the CSD-System to your needs.

Installing the CSD data and CSD-System software separately

It is possible to install the CSD data and the CSD-System software to different locations. This can be useful to, for example, have a single data installation on a network accessible location that multiple software-only installations can use. This will allow you to save space on the systems where the software is installed.

Using the standard graphical installation interface, you will have the option to install both data and software (the default), only the data, or only the software. To install the data to a different location, it is highly suggested to perform the data-only install first. If this is done, you can supply the path to the location of the data during installation of the software and have this location automatically used when running the software.

Running the installer at the command line

More advanced use of the CSD System installers usually involves running via the command line, which allows various arguments to be added that changes the installer's behaviour or provides information normally entered via installer dialogs.

Windows:

Ensure you are in the same directory as the .exe installer file and then just type it's name, e.g.

csds-windows.exe

Linux:

You will normally need to specify the location of the installer executable to run it - this is most easily done by being in the same working directory as the .run installer exectutable and prepending ./ (which means "in this directory"), e.g.

./csds-linux-x64.run

MacOS:

To run the installer application at the command line, ensure you are in the same working directory and use the open command, e.g.:

open csds-osx.app

Installing without GUI access

If you do not have graphical access to the machine where you are installing, the installation program can be run using a text-only interface. This can be useful for cases when running over slow connections or as a simplified interface. This interface should automatically be invoked if it senses there is not a graphical interface, but can also be manually specified if desired by adding the --mode text argument when running the CSDS installer at the command line, for example:

./csds-linux-x64.run --mode text

You will be walked through the same installation procedure as in the graphical interface and have the same options.

Silent install using the command line

The technology used by the CSD installers allows all data normally entered in the graphical installer interface to instead be specified directly via command line arguments when running the installer in a terminal window. This enables silent and unattended installation, which can be useful for mass deployments of the software in an automated fashion.

Running the installation program in a terminal/shell with the --help option will provide a complete list of the command-line options available. For example:

csds-windows.exe --help

Below are some of the more common options or scenarios.

  • --mode unattended will force the installer to operate in batch/unattended mode. There are several associated options that are required for automated installations:
    • --prefix give the root directory of the installation. On Linux, it will default to $HOME/CCDC, on Windows to C:\Program Files (x86)\CCDC and /Applications/CCDC on MacOS.
    • --uattendedmodeui can take the values:
      • none for an unnattended silent install
      • minimal  for limited feedback
      • minimalWithDialogs for dialog driven feedback if possible
    • --Licensing can take the values of:
      • NotNow to skip registration. Registration will need to be completed manually later
      • RegisterAfterInstall to attempt to register the software automatically immedially after the installation process. Will additionally require the site id, confirmation code and email to be specified (see below). This registration mode requires the machine to have access to the internet as it will contact the CCDC licensing server.
      • SelectLicenseFile will use a specified existing license file.Requires use of --SelectLicenceFile to identify the required licence file (see below)
    • --site_id <site id> --conf_code <confirmation code> --email <email> are used to in conjunction with --Licensing RegisterAfterInstall to register the software during the installation process.
    • --SelectLicenceFile <license file> is used in conjunction with --Licensing SelectLicenceFile to provide the location of the existing license file.
    • --enable-components and --disable-components will enable and disable the installation of the data (datagroup) and the software (softwaregroup) components of the CSD-System. Allows the values:
      • datagroup installs the data component
      • vcredist (Windows only) installs the Microsoft Visual Studio runtime libraries required by the CSD software.
      • softwaregroup installs the software component. This option additionally allows the specification of the location of your data install:
        • --csdsoftwareonly
          • true enables definition of the data directory via --csdsoftwareonlydatadir
          • false no link to a data directory will be carried out (default)
        • --csdsoftwareonlydatadir <data directory> should be set to the location of the main CSD database files, for example on Windows: "C:\Program Files (x86)\CCDC\CSD_2018\CSD_539"

Note that if an argument contains a space you will need to enclose it in double quotes. This is most common with Windows paths that contain elements like "Program Files (x86)".

The two most common scenarios are for batch mode installations with registration during installation:

  • Windows
    • csds-windows.exe --prefix "C:\Program Files (x86)\CCDC\csds2018" --mode unattended --unattendedmodeui none --Licensing RegisterAfterInstall --site_id 1234 --conf_code ABCDEF --email user@company.com
  • Linux
    • ./csds-linux-x64.run --prefix /soft/ccdc/csds2018 --mode unattended --unattendedmodeui none --Licensing RegisterAfterInstall --site_id 1234 --conf_code ABCDEF --email user@company.com
  • MacOS
    • open csds-osx.app --prefix /Applications/CCDC/csds2018 --mode unattended --unattendedmodeui none --Licensing RegisterAfterInstall --site_id 1234 --conf_code ABCDEF --email user@company.com

or with an existing license file:

  • Windows
    • csds-windows.exe --prefix "C:\Program Files (x86)\CCDC\csds2018" --mode unattended --unattendedmodeui none --Licensing SelectLicenceFile --SelectLicenceFile "C:\my files\csd_licence.dat"
  • Linux
    • ./csds-linux-x64.run --prefix /soft/ccdc/csds2018 --mode unattended --unattendedmodeui none --Licensing SelectLicenceFile --SelectLicenceFile /home/user/csd_licence.dat
  • MacOS
    • open csds-osx.app --prefix /Applications/CCDC/csds2018 --mode unattended --unattendedmodeui none --Licensing SelectLicenceFile --SelectLicenceFile /home/user/csd_licence.dat

Uninstallation using the command line

In much the same way as the installer executable, the uninstaller that is created in the CSD_2018 installation folder can also be run either interactively via a GUI, or at the command line. Like the installer executable, you can view the options available with the uninstaller by using the --help argument, e.g.

uninstall.exe --help

To perform a silent uninstall with no further user prompts, use:

csds-windows.exe --mode unattended

Note that it can take some time for the uninstall to complete.

MSI Installers

The standard CSD System installers are not MSI based on Windows (MicroSoft Installer). If such an installer would be useful for your organisation we do have MSI installers for the main CSD System installer available as an alternative. Please contact us at support@ccdc.cam.ac.uk to obtain details on how to obtain this.

Further Help

For more information on CSD-System requirements and installation, please see the CSDS 2018 Release and Installation guide. For more help with more specialised install scenarios not covered above, please contact support@ccdc.cam.ac.uk for further assistance.


« Return to search results