Advanced Configuration Features
The configuration system includes features to cater for non-standard environments. Most CopiaFacts users will have no need to use these features, and they are not recommended for use unless no other solution can be found. We strongly recommend that you use (or convert to) the standard installation scheme, because it may not be possible to support the overrides described in this topic in future CopiaFacts releases or in new operating system versions.
The COPIACONNECT.INI file is located on each machine in a 'Copia' sub-folder under Documents and Settings, All Users, Application Data. This location may be described as for example C:\ProgramData in later operating system versions, and the folder name may also include 'Roaming'. This location is essential to allow access by all users, services and print drivers. When this file is created, its permissions are set to allow access by all users. In some cases, however, site policy will restrict access to this folder. If so, a Windows environment variable named CopiaConnectIniPath may be set to the full path name of a COPIACONNECT.INI file in an alternate position. Wherever you locate this file, it must be made accessible to all local network users and services.
COPIACONNECT.INI contains an entry in the following format:
The value of UNCname must be the UNC path name of a folder, typically in the form \\machine\COPIA, which contains the FAXFACTS and NETBIN folders. The requirement for this value to be a valid UNC path name is removed for Island installs as described below.
The COPIA share located from this INI entry normally contains the four items:
|FAXFACTS\||the Copia Application Data folder.|
|NETBIN\||a folder used to save network installer files|
|COPIACONNECT.EXE||the utility program which can be run from other machines running fax server software (such as COPIAFACTS and FFEXTERN) to set up the connection to this COPIA share|
|CF8REG.DLL||a support library for COPIACONNECT.|
The FAXFACTS folder must contain at least the FFCFG.INI file and the FAXCOUNT.HWL configuration and license file.
This optional file will override the FAXFACTS and NETBIN paths. For special purposes, the FAXFACTS and NETBIN folders may be located elsewhere or with different names, though this is not recommended. To do this, provide a file named CFLINK.INI in the root of the COPIA share (the folder named in COPIACONNECT.INI), which may contain one or both of the following entries, for example:
The value of UNCname must be the UNC path name of a folder which will replace paths of the FAXFACTS and NETBIN folders and which must contain the same content. The requirement for this value to be a valid UNC path name is removed for Island installs as described below.
The FFCFG.INI file must contain the entries
The value of ExpectedUNCpath must be the same as the value of the COPIACONNECT.INI UNCname. These entries will normally be initialized by the installer.
Some cloud servers are delivered with restricted network access, so that local shared folders cannot be accessed using a UNC path such as \\machine\copia. When COPIAINSTALL is run with an island command-line parameter, it creates a special 'island' configuration. This has the following differences from a normal install:
•It is identified by a registry key with a boolean value of True:
•The local folder of the COPIA share is saved in registry key:
•Various registry keys with names like UNCname are permitted to contain a path name on a local drive which is not a UNC path name.
•COPIACONNECT.exe is not installed and has no purpose.
•All CopiaFacts client and server software must be installed on the same machine.
The 'Island' configuration method may also be used for a site still running a legacy CopiaFacts version 7 configuration style, where common drive-letter mappings were used across multiple machines, instead of shared folders. This configuration method has been deprecated since the release of CopiaFacts 7.2 in 2005, and we can no longer guarantee that it will support all CopiaFacts components, especially in Operating System versions later than Windows XP and Server 2003. In this case the Island registry keys shown above will need to be set manually, because they are only set automatically when 'Island' conditions are detected in COPIAINSTALL.
Mapped Drive Letters
We strongly recommend not using mapped drive letters, especially with a modern OS (Server 2008 or Windows Vista or later), or when Copia applications are run as services or by members of the Administrators or Power Users groups.
Using paths based on @FFBASE ensures that you can, for example, switch servers by simply running COPIACONNECT from the backup server. This is generally easier than having to change drive mappings as was often done in older operating systems.
Mapped drive letters have the significant disadvantage that they are not shared across accounts, or between elevated and non-elevated sessions. Some of these issues can be avoided by using an EnableLinkedConnections registry value, added in:
We recommend that you search the Microsoft Technet and other sources for EnableLinkedConnections before you add this key.