Verifying that files are not corrupted during transmission

You can verify that files are not corrupted during transmission to, from, and within Teamcenter by setting parameters in File Management System (FMS). This verification process computes message digests (complex checksums) of files before and after transmission, which are then compared to verify file integrity. Content verification must be done in FMS between any two endpoints that transmit files. For example, the system could verify a file’s content when uploading a file from a Teamcenter client to a Teamcenter volume. Endpoints can include FMS clients like the rich client, Lifecycle Visualization, NX, and volume server. There may even be more intermediate points like intermediate file cache servers. To enable file content verification, you must set parameters in FMS configuration files such as the fmsmaster_fscid.xml file and the fsc.properties file. Tip The fmsmaster_fscid.xml file and fsc.properties file are located in the FSC_HOME directory (for example, TC_ROOT\fsc). All the available parameters can be found in the corresponding template files, for example, fmsmaster.xml.template. To generate new file digests, run the generate_file_digests utility. Following are file content verification properties used by FMS server cache (FSC). These properties are set typically in the fmsmaster_fscid.xml file and possibly in the fsc.xml file for special cases. You can find these properties listed in the fsc.xml.template file located in the FSC_HOME directory (for example, TC_ROOT\fsc). Name Valid values Description FSC_EnableUploadValidation true Enables upload data validation. Uses whatever supported digest the client supplies. false Disables upload data validation. Digests sent by clients are ignored. This is the default value. FSC_EnableDownloadValidation true Enables download data validation. Uses the digest stored in the volume or cache. false Disables download data validation. Any digest stored in the volume or cache is ignored. This is the default value. FSC_TransferDigestAlgorithm None Disables transfer data validation. This is the default value. MD5 Requests MD5 digests on file transfers. Uses whatever digest is returned from file origin. SHA-1 Requests SHA-1 digests on file transfers. Uses whatever digest is returned from file origin. SHA-256 Requests SHA-256 digests on file transfers. Uses whatever digest is returned from file origin. FSC_TransferRemoteMetadataFile true Enables transferring metadata files used in the validation process. This is the default value. false Disables transferring metadata files. Following is an example of these properties used in an fmsmaster_fscid.xml file: Copy … … Following are file content verification properties used by the FMS client cache (FCC). These properties are set typically in the fmsmaster_fscid.xml file and possibly in the fcc.xml file for special cases. You can find these properties listed in the fcc.xml.template file located in the FCC_HOME directory (for example, TC_ROOT\fcc). Name Valid values Description FCC_UploadDigestAlgorithm None Disables upload data validation. This is the default value. MD5 Computes and sends MD5 digests on file uploads. SHA-1 Computes and sends SHA-1 digests on file uploads. SHA-256 Computes and sends SHA-256 digests on file uploads. FCC_DownloadDigestAlgorithm None Disables download data validation. This is the default value. MD5 Requests MD5 digests on file downloads. (Uses whatever supported digest the FSC supplies.) SHA-1 Requests SHA-1 digests on file downloads. (Uses whatever supported digest the FSC supplies.) SHA-256 Requests SHA-256 digests on file downloads. (Uses whatever supported digest the FSC supplies.) Following is an example of these properties used in an fmsmaster_fscid.xml file: Copy … … Following are file content verification properties used by FSCClientProxy, FSCJavaClientProxy and FSCNativeClientProxy. You can set these properties in the fsc.properties file (for JNI FSCClientProxy), the fsc.clientagent.properties file (for FSCNativeClientProxy or JNI FSCClientProxy), and in the System.getProperties() call (for FSCJavaClientProxy). (For JNI FSCClientProxy, the fsc.clientagent.properties file settings override those found in the fsc.properties file.) Name Valid values Description com.teamcenter.fms.digest.upload None Disables upload data validation. This is the default value. MD5 Computes and sends MD5 digests on file uploads. SHA-1 Computes and sends SHA-1 digests on file uploads. SHA-256 Computes and sends SHA-256 digests on file uploads. com.teamcenter.fms.digest.download None Disables download data validation. This is the default value. MD5 Requests MD5 digests on file downloads. (Uses whatever supported digest the FSC supplies.) SHA-1 Requests SHA-1 digests on file downloads. (Uses whatever supported digest the FSC supplies.) SHA-256 Requests SHA-256 digests on file downloads. (Uses whatever supported digest the FSC supplies.) com.teamcenter.fms.digest.transfer None Disables transfer data validation. This is the default value. MD5 Requests MD5 digests on file transfers. Uses whatever digest is returned from file origin. SHA-1 Requests SHA-1 digests on file transfers. Uses whatever digest is returned from file origin. Requests SHA-256 digests on file transfers. Uses whatever digest is returned from file origin. Following is an example of these properties used in an fsc.properties file: Copy com.teamcenter.fms.digest.upload=MD5 com.teamcenter.fms.digest.download=MD5 com.teamcenter.fms.digest.transfer=MD5 Following are file content verification properties used by FSCNetClientProxy and set in the FSCNetClientProxynn.dll.config file. NET-version represents a .NET version number. This file resides in the FSC_HOME\lib directory. Name Valid values Description com.teamcenter.fms.digest.upload None Disables upload data validation. This is the default value. MD5 Computes and sends MD5 digests on file uploads. SHA-1 Computes and sends SHA-1 digests on file uploads. SHA-256 Computes and sends SHA-256 digests on file uploads. com.teamcenter.fms.digest.download None Disables download data validation. This is the default value. MD5 Requests MD5 digests on file downloads. (Uses whatever supported digest the FSC supplies.) SHA-1 Requests SHA-1 digests on file downloads. (Uses whatever supported digest the FSC supplies.) SHA-256 Requests SHA-256 digests on file downloads. (Uses whatever supported digest the FSC supplies.) Following is an example of these properties used in an appSettings file section of the configuration file: Copy