PTC Arbortext Content Delivery Deployment > Using the PTC Arbortext Content Delivery Deployment Configurator Utility > Editing Properties of the Configurator Entities
Editing Properties of the Configurator Entities
This section describes the properties of each of the entities of the Configurator utility. All the entities that you can configure are supported as Windows services. The names of these services are the same as the corresponding entity such as Core, CoreCMI, LoadBalancer, JBoss. Only administrator can create these services.
When you install PTC Arbortext Content Delivery and open the Configurator user interface, the entities are pre-populated with the data from the PTC Arbortext Content Delivery installation.
Configurator Entities and Topology
The top-level pane contains the following pre-defined servers that you cannot remove or move from the canvas. However, you can view and change their properties in the Properties pane:
• License Server
• Publisher
• Dynamic Data Database Server
• general settings (an entity for general settings that is applicable across environment)
You also cannot link these entities with any other entities.
For other entities such as Viewer, Core, Core CMI, Internal LDAP, and Database, you can drag and drop them from the left pane into the canvas area. The properties of the entities that you add in the canvas area are displayed in the Properties pane. Since PTC Arbortext Content Delivery is a multi-site environment, each entity that you manage is scoped by a site. By default, site1 tab is displayed. You can add multiple sites and add entities to each of them (you can modify the site name). You can also connect the logical entities in a site together using the connector button. If you connect more than one entities, you can also see an indentation tool bar. You can use this tool bar to indent and present entities in a desired way in the canvas area.
All the information related to the properties and the allowed relationships across entities is recorded in the InService_configurator_<Release>.<Build>.xml file that is stored in the …Data/Data/System/Config folder. The last action that you performed in the application is recorded in this file. For example, if you have changed the value of a property multiple times, the last modification to the value is stored in this file.
* 
• After you configure the entities on Windows, the services are created automatically for the respective entities.
• As an advanced option, you can configure the default path (…Data/Data/System/Config) for the InService_configurator_<Release>.<Build>.xml file using a property in the <HOME>/SW/SW/setup.properties file.
• Each time you make a change to the configurator properties, entities, or relationships, you must restart the relevant entity services, including the Monolithic/Publisher (on which the configurator resides). This applies to the first time deployment as well as later time updates.
• The orange exclamation mark sign indicates that some data for that entity has failed the verification from the configurator. This is only for validation purpose and is displayed only after you set up the actual entities.
• You can select and delete one or more entities from the canvas area. The system does not show any confirmation message while deleting, because you can undo and redo your actions using the corresponding buttons in the header area.
• The entity names must be lowercase and without spaces.
* 
For Viewer, and Core entities, the folder paths such as the PA Collection path, and for Publisher both the PA Collection and the Shared Data Folder path are validated only for the local path (Publisher host path) and shared network path. If you provide a non-local path, it is not validated and a "Not a Valid Path" warning is displayed. However, you can continue with the configuration.
Entity
Field
Description
License
License server configuration. This is a single setting for all the components in the environment.
License server properties are typically provided during the Publisher setup. In the Properties pane, you can modify the properties if you want to switch to a different License server. Enter the DNS hostname and port number for the License server.
Publisher
Java Home Path
You can change the Java Home Path for application server using the Configurator UI and click the Publish button to save the changes. Path change will take effect on next server restart.
Please note:
• You must set Java Home Path separately for the publisher and viewer. The path will be validated on next server restart and then come in effect.
• Ensure that the path is correct, and the new java version is supported by PTC Arbortext Content Delivery.
• After changing the Java Home Path, you must create and import the SSL certificates to KeyStore (Cacerts) of this new Java. SeeConfiguring SSL for the Web Application Server in the PTC Arbortext Content Delivery Deployment Guide for creating and importing certificates.
• If an incorrect or unsupported Java Home Path is provided, then on next server restart Jboss (Application server) will not boot. You can see the error details in the Configurator.Log.0 file in the SW/Log/System/Log/configurator_logs folder.
Host Name
Host name for the Publisher.
Port
Port number for the Publisher.
Shared Data Folder (Store Packets) Path
Store packets path shared between Publisher and all viewers in the environment. This is used to upload and download packets while data loading.
Distribute using FTP
Enter the following details:
• Shared location on Core server (value automatically populated from Publisher setup).
• FTP server host name and port.
• FTP user name and password.
• Transfer mode (Binary or ASCII).
Collect CoreTracer Information
Selecting this check box creates the core tracer log and populates with the core tracing information.
Auto-restart upon failure
Selecting this check box enables the system to automatically restart the Core servers upon failure.
Database
Database accounts user name and password. This applies to the E3C, TitanDB, TitanDB2, and CMI PTC Arbortext Content Delivery database accounts.
LDAP
LDAP server configuration details. You can configure different LDAPs for Publisher and Viewer.
Site Administrator User Name and Password
User name and password of PTC Arbortext Content Delivery administrator. This must be same across the environment (Publisher and all viewers).
Max Jboss Heap(MB)
You can set the Jboss heap size using the Configurator UI for both Publisher and Viewer.
Enable Performance Advisor
Selecting this check box allows you to enter the target collection path and collection frequency for Performance Advisor.
Dynamic Data DB
Dynamic data Mongo database details such as database name, host name, default port number, account name, user name, and password.Dynamic Data DB entity contains the default Dynamic Database details which get installed with Publisher. You can use this dynamic database as common database across deployment. For more information, see the Database entity section for separate dynamic database for viewers.
general settings
When you configure these settings, these are stored in an consolidated config file, where the following action happens:
• Property that holds the value for location of DC repo folder path D:\<HOME>\Data\Work\uploadPackets is enabled.
After configuring these settings, these are recorded in the consolidated ACD_configurator_<Release>.<Build>.xml file, and then sent and applied on the end-system (Publisher in this case).
For more details specification on those configuration points, see TAL Configuration.
TAL configurations for the Configurator utility.
* 
You must restart PTC Arbortext Content Delivery after you change any of the TAL settings. You may also need to re-load data or re-execute TAL.
For more details, see the Using Publishing and Loading section.
Enable content sharing mode
Selecting this check box, you can share data across contexts under the same segments.
You can update this value later only when you run the “clear environment” task to clear the system data.
Enable BOM Filtration
Before configuring TAL if this check box is selected, you can filter data according to the BOM in the user interface.
When you change this property, you must re-index all the existing collections by executing the Update Assets In Publication Manager and Deploy Assets tasks.
For more details, seeUsing Publishing and Loading.
Enable Offline Configuration
Selecting this check box enables the data packages creation for Offline viewers as well the use of the Download Center repository folder path that must be used for hosting the Offline packages. Enable this option only when you want to start deploying Offline systems.
Organization Names
List of organizations in the system.
Part Relationships
The default values are:
• supersession
• alternate
• x-ref
• supplementary
• kit
Please note:
• You cannot add or delete a pre-defined part relationship. Adding or removing a part relation causes errors in the system.
• A check box is available next to each part relation (Supersession, Alternate, X-ref, Supplementory, and Kit) and you can see these check boxes synced according to the value of the e3c property. You can select or clear these check boxes but cannot delete or update this list.
IMAN
Rename or change the sources loading priorities. The attributes are used to generate the IMAN ID. Changing the order changes the loading priority.
Email Notifications
You can configure all email notifications such as emails for TAL, Notes, Feedback, Carts, Forget Password, and Licensing using the Configurator UI. Manual modification in the wt.properties file is not needed.
Enter the following details:
• Enable SSL—Select this property to access mail servers over connections secured using SSL
• Enable TLS—Select this property to access mail servers over connections secured using TLS
• Email Server Host Name and Email Server Port—Name and port of the email server to connect the ACD application. For example, smtp.gmail.com and 587.
• Email Server Host Type—The email server connection protocol. For example, SMTP.
• Email Server User Name and Email Server Password—If the email server is password protected, you must configure the username and password of the mail server. If not, leave these fields blank.
• Email Sender Address—Email address of the account who should send the TAL notifications.
• TAL Notifications Email recipients—Email address of the account who should receive the TAL notifications
You can also configure Feedback Email recipients and Notes Email recipients here.
* 
These properties are no longer managed by xconfmanager and you must configure them through the Configurator.
Image Sorting Method
You can now specify the display order of Partlist images from the Configurator. By default, you could sort the images alphabetically. PTC Arbortext Content Delivery 7.1.4.0 uses a new property com.ptc.sc.imageSortingMethod to control the sorting behavior of images, using which you can selecteither alphabetic or bundle as the display order for Partlist images on the configurator UI.
Enable External LoadBalancer Configuration
If you have external load balancer (top-load balancer), then in order to use book print functionality you must add external load balancer host and port in the configurator UI.
Revert to defaults
Reverts the existing configuration to the default settings.
Part Service Effectivity Merging
You can apply effectivities for both Part and Part Line Item of Parts List for SIM bundles. You can select from the following options available on the Configurator UI to display Parts List on the PTC Arbortext Content Delivery UI:
• Intersection: The effectivity intersection for Part and Part Line Item is one (AND operation). This is selected by default.
• Union: The effectivity union for Part and Part Line Item is one (OR operation).
Viewer
Viewer configuration details such as host name, port, log level
Java Home Path
You can change the Java Home Path for application server using the Configurator UI and click the Publish button to save the changes. Path change will take effect on next server restart.
For more information, see the Java Home Path row in the Publisher section of this topic.
Log level
Log collection level (Error, Warning, Debug, Info).
Enable Performance Advisor
Selecting this check box allows you to enter the target collection path and collection frequency for Performance Advisor on the Viewer.
Max Jboss Heap(MB)
You can set the Jboss heap size using the Configurator UI for both Publisher and Viewer.
CoreCMI
Core
CoreCMI and Core server configurations.
* 
You can add only one CoreCMI entity for each site.
Log level
Log collection level (Error, Warning, Debug, Info).
Collect CoreTracer Information
Selecting this check box creates the core tracer log and populates with the core tracing information.
Auto-restart upon failure
Selecting this check box enables the system to automatically restart the Core servers upon failure.
Enable Performance Advisor
Selecting this check box allows you to enter the target collection path and collection frequency for Performance Advisor on the Core server.
Database
Database information such as host name, port, database type (Oracle, MSSQL Server, PostgreSQL), account name of the global database or service. Specify user name and password for each of these schemas accounts such as E3C, Titan, and CMI.
Along with the other databases, you can provide separate MongoDB instances and details for each site and its viewers. In the Deployment Configurator, the Use Default Dynamic Database check box is selected by default, which means that the default MongoDB instance that was installed with the Publisher is used.
You can do one of the following:
• Select the Use Default Dynamic Database check box to use the default database for all sites (details are shown in the ddata entity).
• Provide a separate MongoDB instance for each site in the Database entity. For this, clear the Use Default Dynamic Database check box.
* 
In a multi-site environment (cluster/split), the MongoDB instance must be the same for all the sites. If the MongoDB instance is not the same, then it is assumed that each site has separate users and profiles. Thus there is no synchronization between the sites.
LDAP
LDAP server configuration details.
* 
You can populate the Backup Host Name and Port fields for your LDAP to use as a secondary LDAP in case the primary LDAP is not accessible.
External LDAP/ADS Configuration
External LDAP/ADS Configuration details. The following options are available:
• None—Skip External LDAP/ADS Configuration
• External LDAP—Configure External/Corporate LDAP
• Active Directory Services—Configure Microsoft ADS
For more information about configuring external LDAP/ADS, see the Configuring to Use an External LDAP or ADS System topic.
Integrations
A new panel Integrations is available on the Configurator UI where you can provide the Ordering and Pricing and Availability (P&A) server details.
For more information, see Integrating Ordering and Pricing System
Ordering System
In the Ordering Server Connection Type field, you can select connection type such as REST, SOAP, or JDBC, and populate the following fields depending on the connection type selected.
• Ordering Server URL: The URL for the Ordering System server
• Ordering Server User: The username for Ordering server authentication. Leave it blank if authentication is not required.
• Ordering Server Password: The password for Ordering server authentication. Leave it blank if authentication is not required.
• SOAP Action: SOAP action name (if the request type selected is SOAP).
• Ordering Server Database User: Database server username.
• Ordering Server Database Password: Database server password.
• Ordering Server DB URL: Database server connection URL. It must be a complete URL such as: jdbc:oracle:thin:@localhost:1521:SC
Pricing and Availability System
In the Pricing Server Connection Type field, you can select a connection type such as REST, SOAP, or JDBC, and populate the following fields depending on the connection type selected.
• Pricing and Availability Server URL: The URL for the Pricing System server
• Pricing Server User: The username for Pricing server authentication. Leave it blank if authentication is not required.
• Pricing Server Password: The password for Pricing server authentication. Leave it blank if authentication is not required.
• SOAP Action: SOAP action name (if the request type selected is SOAP).
• Pricing Server Database User: Database server username.
• Pricing Server Database Password: Database server password.
• Pricing Server DB URL: Database server connection URL. It must be a complete URL such as: jdbc:oracle:thin:@localhost:1521:SC