Reference Guide - Install CM4D Client v25.1

This guide contains the basic steps for installing and configuring a CM4D Client system from start to finish. This topic is intended for installing Clients that are part of a larger setup that includes at least one CM4D Server installation that would be installed before any client systems.

Prepare for Installation

Contact your ATS sales representative or ATS Support if you have questions or need assistance.

Gathering the following information is helpful before running the installer.

Download installers/files referenced in this guide.
		ATS CM4D Client installer.
Download and Install Prerequisites. This is only required if you plan to run the installer on a machine without an internet connection. With an internet connection, any prerequisites not present or require updates are downloaded automatically when needed during installation.
		Visual C++ Redistributable for Visual Studio 2012 Update 4 x64 - 11.0.61030
		Microsoft Visual C++ 2015-2019 Redistributable (x64) - 14.25.28508 or higher
		SQL Server OLE DB Driver 18 x64 - 18.2.2.0 or higher
		.NET Framework 4.7.2
Optional Files from CM4D Server. There are some configuration files that can be copied from the CM4D Server and put into the CM4D Client install folder after the Client installation is completed.
		ATSLicensingServer.Client.dll.config - Includes the licensing server information; do not use a copy if the CM4D Server is configured as 'localhost'.
		CM4D.4ds - This includes the Database Server and CM4D Site connection.
		Cm4d.ini - This includes runtime settings for CM4D. Your Server may use different startup options than the Clients.

Install CM4D Client

Before starting the CM4D installer, the 'Print Spooler' Windows service must be running. If the service is not running, the installation will fail.

Run the CM4D Client installer executable (as Administrator).
Install the Prerequisites (restart the machine if prompted; on restart, installer will resume automatically).
Set the Installation folder.
Select the Installation Type 'Quick Install'.
Enter the name of the ATS Licensing Server.
Finish the installation and restart the computer.

Configure Client (Post-Installation)

Complete the configuration using one of two methods:
1. Copy configured files from the CM4D Server:
  1. CM4D.4ds
  2. Cm4d.ini'
  3. ATSLicensingServer.Client.dll.config
2. Manually configure on the Client (you may need different options from the Server):
  1. Configure Site Connection in DbConnect. Run DbConnect (as Administrator).
    1. Connection Type - Change the dropdown to "Site Connection".
    2. Windows Authentication - Select one of the two available methods of authentication for connecting to the databases:
      1. Windows Authentication - Set the dropdown to 'True'.
      2. SQL Authentication - Set the dropdown to 'False'; enter the SQL username and password.
    3. Server Name - Enter the name of the database server. If using a Named Instance, include this in the server name.
    4. Database Name - Enter the name of the CM4D Site database.
  2. Configure the CM4D runtime options. Edit the Cm4d.ini file:
    1. In the [default] section find the parameter "PDFPRINTDRIVER".
    2. Set the value to "ATS CM4D Printer".
    3. Comment out (#) the other print driver options or delete the unused lines entirely.
    4. Configure any other initialization settings needed for the Client.
  3. Set the ATS Licensing Server (if not entered during the CM4D Client installation). Edit the ATSLicensingServer.Client.dll.config:
    1. <setting name="EndpointAddress" serializeAs="String"> <value>net.tcp://localhost:8001/ATSLicensingServer/</value>