Configuring application settings

Use the Internet Information Services (IIS) Manager application to edit general application settings.

Editing the application settings will automatically restart the eShare server.

Do the following:

  1. Log in to the eShare server computer with administrative privileges, and open the Internet Information Services (IIS) Manager application.

  2. In the Connections pane, browse to Sites > eShare.

  3. In the main view, open Application Settings. Edit the settings as appropriate. We recommend that you do not change settings that are not described in the following table.

    Setting Description

    Cadmatic.Auth.RedirectWhitelist

    Used by third party integrations that want to utilize the eShare web login.

    The value is formatted as a space separated list ("https://address1 https://address2").

    Cadmatic.AutoCadFontsFolderName

    AutoCAD fonts might be necessary for correct displaying of documents. This setting specifies the path to the AutoCAD fonts folder. Alternatively, copy the font files from AutoCAD to %ProgramData%\Cadmatic\eShare\AutoCadFonts.

    Cadmatic.AutomatedClientUpdates

    Specifies whether automated updates to the latest client version are allowed.

    • False – The automated updates are not allowed.

    • True – The automated updates are allowed.

    Cadmatic.AzureAD.ClientId

    Specifies the client ID for Azure AD authentication.

    Cadmatic.AzureADSecurity must be first set to true to use Azure AD authentication.

    Cadmatic.AzureAD.ClientSecret

    Not needed for Azure AD/Entra ID authentication. Used for some internal integrations.

    Cadmatic.AzureAD.Domain

    Specifies the domain used for Azure AD authentication.

    Cadmatic.AzureADSecurity must be first set to true to use Azure AD authentication.

    Cadmatic.AzureAD.TenantId

    Specifies the tenant ID for Azure AD authentication.

    Cadmatic.AzureADSecurity must be first set to true to use Azure AD authentication.

    Cadmatic.AzureADSecurity

    Specifies if Microsoft Azure Active Directory authentication is used.

    • False – Azure AD authentication is not used.

    • True – Azure AD authentication is used.

    If set to true, note that all other authentication methods must be turned off.

    After setting to true, set Cadmatic.AzureAD.Domain, Cadmatic.AzureAD.ClientId, and Cadmatic.AzureAD.TenantId settings to values necessary for your Azure AD.

    Cadmatic.CacheFolderName

    Specifies the location of the submodel cache.

    Important: eShare may permanently delete any files and folders from this path, so it should not be used by users or applications for any other purpose. Changing the path after initial installation may break existing projects.

    Cadmatic.DatabaseCommandTimeoutSeconds

    Specifies the default database command timeout in seconds. The default value is 900.

    Cadmatic.DocumentFolderName

    Specifies the location of stored documents published from CADMATIC design applications.

    Important: eShare may permanently delete any files and folders from this path, so it should not be used by users or applications for any other purpose. Changing the path after initial installation may break existing projects.

    Cadmatic.DownloadedDocumentLinksToApp

    Specifies the link target of the links in downloaded documents.

    • False – The link target is the eShare web site.
    • True – The link target is eShare App.

    Cadmatic.DziFolderName

    Specifies the location of document viewer cache.

    Important: eShare may permanently delete any files and folders from this path, so it should not be used by users or applications for any other purpose. Changing the path after initial installation may break existing projects.

    Cadmatic.DziMaxDpi

    Specifies the maximum quality of a document that is displayed in the document viewer. The value can be between 150-1200 dpi, the default being 400 dpi. However, if the document is very large, the document viewer might lower the quality.

    Cadmatic.DziMaxNumberOfPages

    Specifies how many pages of a multi-page document to show in the built-in document viewer. If the user is opening a document that has more pages, the user is prompted that only the specified number of pages are shown, and to see the whole document the user should download it and open it in a separate viewer application.

    Cadmatic.DziMinDpi

    Specifies the minimum quality of a document that is displayed in the document viewer. The value can be between 150-1200 dpi, the default being 200 dpi.

    Cadmatic.EbmFolderName

    Specifies the location of internal model files.

    Important: eShare may permanently delete any files and folders from this path, so it should not be used by users or applications for any other purpose. Changing the path after initial installation may break existing projects.

    Cadmatic.EnableModelDownloadButton

    Specifies whether normal users, admins, or anyone is able to see the link to download the project model file.

    • All – The download link is visible for every user.

    • Admin – The download link is visible only for project and system admins.

    • None – The download link is not visible to anyone.

    Cadmatic.ExcelLinksToApp

    Specifies the link target of the Excel object IDs exported by search.

    • False – The link target is the eShare web site.

    • True – The link target is eShare App.

    Cadmatic.FloatingLicenseTimeout

    Specifies the time after which floating licenses can be taken from idle users if someone else needs the license.

    The value is set in minutes and the minimum value is 15. If set to 0, floating licenses cannot be taken from idle users. The default value is 45.

    Cadmatic.IsAttributeStagingTableUsed

    Determines whether eShare uses a faster method for publishing.

    • True – Publishing is faster but eShare requires execute permissions on its stored procedures.

    • False – Publishing is slower and eShare does not require any additional permissions.

    Cadmatic.IsOnlyLocalHelpUsed

    Determines whether eShare uses only the local help and does not try to reach http://docs.cadmatic.com.

    • True – Only local help is used.

    • False (default) – eShare attempts to first reach https://docs.cadmatic.com, but if the site is not reachable, the local help is used.

    Cadmatic.JsonWebToken.DefaultExpirationPeriod

    Specifies the expiration time of JSON Web Token or cookie in eShare. The value is set in seconds and it can range from 3 minutes to 365 days. Default is 180 days.

    To override the expiration time set by the authentication provider, Cadmatic.JsonWebToken.ForceDefaultExpirationPeriod must be set to true.

    Cadmatic.JsonWebToken.ForceDefaultExpirationPeriod

    Specifies if the expiration time of JSON Web Token or cookie set in Cadmatic.JsonWebToken.DefaultExpirationPeriod overrides the expiration time set by the authentication provider.

    Cadmatic.LicenseServer

    Specifies the server address in the format server:port, or just server if the port is the default port.

    For example, if the license server is running on port 2989 on a server named ‘license’, set the value to ‘license:2989’.

    Cadmatic.LogsFolderName

    Specifies the location of stored server log files.

    Cadmatic.MapsFolderName

    Specifies the location of stored maps.

    Important: eShare may permanently delete any files and folders from this path, so it should not be used by users or applications for any other purpose. Changing the path after initial installation may break existing projects.

    Cadmatic.MaxExcelObjectsCount

    Specifies the maximum number of objects that can be exported from eShare search results to a Microsoft Excel file. The value must be between 20,000 and 1,048,576; the default is 50,000. If the search function finds more objects, the export file will only contain the first objects, in no specific order.

    Excel export can have a significant impact on computer's memory consumption. For example, exporting 1,000,000 objects might consume up to 10 GB of RAM, and several simultaneous exports of that size would require the server to have at least 64 GB – 128 GB of RAM. If the value is set too high for the amount of available RAM, the server application will run out of memory and the export crashes.

    Cadmatic.MaxMultiSelectCount

    Specifies how many objects the user can select at a time. The default value is 20,000. If the user attempts to select more objects than specified here, eShare does not show the objects' details.

    Cadmatic.MaxNumberOfDocumentIndexingThreads

    Specifies the maximum number of threads that the eShare server can use when indexing. This affects the combined load generated by all the data sources doing indexing in all of the projects on the eShare server. If left empty, a default value is used, which uses most of the cores available on the server computer.

    The value can be a whole number OR a decimal number, and the default value is the logical processor count – 1.

    • If using a whole number, it directly defines the maximum number of threads to use. The value can be between 1 and n where n is the logical processor count of the server * 2.

    • If using a decimal number, the maximum number of threads is obtained with the following formula:

      logical processor count * the decimal number, rounded down

    Cadmatic.MaxNumberOfInitializationThreads

    Specifies the maximum number of threads that the eShare server can use when starting up. This affects the loading time of enabled adapters and data sources.

    The value can be a whole number OR a decimal number, and the default value is the logical processor count – 1.

    • If using a whole number, it directly defines the maximum number of threads to use. The value can be between 1 and n where n is the logical processor count of the server * 2.

    • If using a decimal number, the maximum number of threads is obtained with the following formula:

      logical processor count * the decimal number, rounded down

    Cadmatic.MaxNumberOfModelImportingThreads

    Specifies the maximum number of threads that the eShare server can use when importing models. This affects the combined load generated by all model importers and models.

    The value can be a whole number OR a decimal number, and the default value is the logical processor count – 1.

    • If using a whole number, it directly defines the maximum number of threads to use. The value can be between 1 and n where n is the logical processor count of the server * 2.

    • If using a decimal number, the maximum number of threads is obtained with the following formula:

      logical processor count * the decimal number, rounded down

    Cadmatic.MaxNumberOfModelPublishingThreads

    Specifies the maximum number of threads that the eShare server can use when publishing models. This affects the combined load generated by all models published on the eShare server.

    The value can be a whole number OR a decimal number, and the default value is the logical processor count – 1.

    • If using a whole number, it directly defines the maximum number of threads to use. The value can be between 1 and n where n is the logical processor count of the server * 2.

    • If using a decimal number, the maximum number of threads is obtained with the following formula:

      logical processor count * the decimal number, rounded down

    Cadmatic.MaxNumberOfUserLicenses

    Specifies the maximum number of user licenses that eShare server is allowed to allocate. This can be used to specify how many users can log in to a single eShare server when multiple eShare servers use the same license server. Or, it can be used to temporarily reduce the number of simultaneous users on a single eShare server, for example if needing to troubleshoot performance issues.

    Supported value range: 1-999.

    If the parameter is missing or its value is outside the valid range, the maximum number of users that can log in is the same as the total number of available user licenses. In a multi-server scenario this can result in one eShare server being allowed to allocate all available licenses.

    Cadmatic.PointCloudFolderName

    Specifies the folder eShare uses to store point clouds. Point cloud files can be manually added to the project folders under it, and once added they will be processed and shown by eShare automatically.

    Important: eShare may permanently delete any files and folders from this path, so it should not be used by users or applications for any other purpose. Changing the path after initial installation may break existing projects.

    Cadmatic.PdfLegendFontOrFileName

    Specifies the PDF stock font name (for example, Times-Bold, or Helvetica), or the full path to a Unicode TrueType font that will be used for the document legend (for example, C:\data\code2003.ttf).

    If the setting is empty, Helvetica is used by default.

    Allowed stock font names are listed in the PDF Reference 1.7, pages 1109-1110, Table H.3. https://wwwimages2.adobe.com/content/dam/acom/en/devnet/pdf/pdfs/pdf_reference_1-7.pdf

    Cadmatic.RemovePointCloudSourceFilesAfterSync

    Specifies if eShare should automatically remove point cloud source files when point clouds are added (to save space).

    • False (default) – The point cloud source files are not automatically removed.

    • True – The point cloud source files are removed automatically.

    If Cadmatic.RemovePointCloudsWithoutSourceFiles is set to true, it overrides this setting.

    Cadmatic.RemovePointCloudsWithoutSourceFiles

    Specifies if eShare should remove point clouds without source files.

    • False (default) – The point clouds without source files are not removed.

    • True – The point clouds without source files are removed automatically.

    If set to true, this overrides RemovePointCloudSourceFilesAfterSync setting.

    Cadmatic.SharedFolderRootPath

    Specifies the folders where the user can select Excel files and adds the Browse to the Excel data source adapter. The setting includes the folder's subfolders.

    Enter first Shared Folder Display Name| and then the folder path, for example: Shared Folder Display Name|C:\Excel_files.

    Cadmatic.TempFolderName

    Specifies the generic temporary folder used by eShare.

    Important: eShare may permanently delete any files and folders from this path, so it should not be used by users or applications for any other purpose. Changing the path after initial installation may break existing projects.

    Cadmatic.UserLicenseType

    Specifies whether to use named licenses or floating licenses. Make sure that the license file contains licenses that match the selected licensing type.

    Supported values:

    • 0 – Use named licenses. License server must contain licenses of type 'eShare User'.
    • 1 – Use floating licenses. License server must contain licenses of type 'eShare Client'.

    If the parameter is missing or its value is outside the valid range, the system uses named licenses by default.

  4. After making the last change, wait for the server to restart and changes to take effect.