PDXpert service configuration settings

Warnings

The default values of these settings are carefully chosen and optimized. Do not change these settings arbitrarily.

The service configuration file is reset or replaced during application upgrade. You must review and, if needed, re-apply your custom settings after each system upgrade.

How to edit the configuration file

  1. Ensure all users are logged out of the PDXpert client application.

  2. On the server computer, close the PDXpert application server window.

  3. In the Administrator Tools > Services window: Stop the PDXpert Server service. If prompted, stop the PDXpert Filter service.

  4. In the Program Files folder, go to the installed PDXpert application location. This is typically C:\Program Files\PDXpert\PDXpert PLM\Website\bin.

  5. Select Notepad, Notepad++ or other plain text editor (not Word or similar), right-click, and select Run as administrator.

  6. Using the text editor, find and open the PDXpert.Service.exe.config file in the installed PDXpert application location.

    Be careful not to edit the PDXpert.Server.exe.config file.

  7. Edit the setting, save the file, and close the text editor.

  8. In the Administrator Tools > Services window: Start the PDXpert Server service.

Values in <appSettings />

<add key="ServiceTcpPort" value="48084" />

The PDXpert client uses the default base value of 48084, unless it is directed to use a different value when the user logs into the client.

After setting a new ServiceTcpPort value, the PDXpert client log-in must include the same value in the Server computer's machine name textbox. For example, if the server's machine name is PLMSERVER and the ServiceTcpPort is set as 24042, then the client log-in value would be PLMSERVER:24042

Purpose: Specify the base TCP port number for client communications. Ports are defined as

  • BASE+0 is used to send software updates to PDXpert client application. The value is also used in the client download links as http://servername:{base port}/client/setup
  • BASE+1 is used for unencrypted communications, usually when local workstations connect to the server on a trusted network or VPN.
  • BASE+2 is used for encrypted communications, usually when remote workstations connect to the public IP address of the server.
  • BASE+3 is reserved for future use.

Expected values: Any available range of four sequential TCP ports.

Default value: 48084

<add key="ServiceHostName" value="" />

Purpose: Specify the binding IP address used to listen for client communications. For example, you can exclude all LAN/WAN IP addresses in favor of the server's VPN address.

Expected values: Any IP address assigned to server computer.

Default value: None - server listens on all available network connections when empty.

<add key="HostName" value="" />

Purpose: Specify the client installer's network location for copy link, save link and new user email. The value replaces the placeholder http://{location}:48084/client/setup For example, on location value of PLMSERVER, the link is http://PLMSERVER:48084/client/setup

Expected values: Any IP address or domain name that resolves to the server location.

Default value: None - the server computer's machine name is used when empty.

<add key="Culture" value="en-US" />

Purpose: Identify the PDXpert service's culture resources. (This setting is deprecated. Most service operations use InvariantCulture; database operations are generally fixed as en-US.)

Expected values: Any Microsoft Language Culture Name value. These are similar to the IETF language tag, and generally use a ISO 639 two-letter language code with a ISO 3166 two-letter country code.

Default value: en-US

<add key="JobFactor" value="1" />

Purpose: Service scheduled task processing rate, where a higher number represents a longer delay between scheduled events like indexing. Faster task processing (a smaller number) results in a heavier load on system resources.

Expected values: Numbers from 0.1 to 10

Default value: 1

 

Learn More
Install Guide Contents