FCC and FSC Internal Socket Buffer Tuning

Advanced Technical Services White Paper

This document is intended to provide guidance on
achieving the best performance on a WAN
connection. This requires FMS to use dynamic TCP
Windowing.

The TCP window is the amount of data that can be in transient between the client
and the server. Data cannot be sent over the network until the receipt of the first
packet of data in the windows is received.

Issued by: Siemens PLM Software. © 2018. Siemens Product Lifecycle Management Software Inc. All rights reserved.
Unrestricted
White Paper | FCC and FSC Internal Socket Buffer Tuning 2

Issued by: Siemens PLM Software. © 2018. Siemens Product Lifecycle Management Software Inc. All rights reserved.
Unrestricted
White Paper | FCC and FSC Internal Socket Buffer Tuning 3

Software Copyright and Trademark Notices

© 2018 Siemens Product Lifecycle Management Software Inc. No part of this document
may be copied, reprinted, or distributed without the written permission of Siemens Product
Lifecycle Management Software Inc. (“Siemens PLM Software”), except that entities with
a Teamcenter® Maintenance Agreement in force may reproduce this document for their
internal use only.

Siemens is a registered trademark of Siemens AG. The Siemens logo is a registered trademark
of Siemens AG. Teamcenter® is a trademark or registered trademark of Siemens Product
Lifecycle Management Software Inc. or its subsidiaries in the United States and in other
countries. Siemens PLM Software Teamcenter® and Transforming the process of innovation are
trademarks or registered trademarks of Siemens PLM Software or its subsidiaries in the US and
in other countries. Adobe and Acrobat are either registered trademarks or trademarks of Adobe
Systems Incorporated in the United States and/or other countries. All other trademarks or
registered trademarks belong to their respective holders.

This software and related documentation are proprietary to Siemens PLM Software.

Note: The pages of this document are numbered consecutively 1…N without the usual
Roman numeral numbering of the front matter. This makes the document’s page
numbers consistent with the numbers displayed by the Adobe® Acrobat® viewer and
simplifies printing of page ranges from Acrobat.

For Teamcenter Customer Support, contact the Siemens PLMS Global Technical Access Center
at
800-955-0000 or http://support.ugs.com.

Printed in the United States of America. 7/20/18

Issued by: Siemens PLM Software. © 2018. Siemens Product Lifecycle Management Software Inc. All rights reserved.
Unrestricted
White Paper | FCC and FSC Internal Socket Buffer Tuning 4

Disclaimer

This document is intended to provide guidance on achieving the best performance on a WAN
connection. This requires FMS to use dynamic TCP Windowing. SIEMENS PLM
SOFTWARE hereby disclaims and assumes no responsibility or liability for any results
that occur due to the use of the information contained in this document.

Issued by: Siemens PLM Software. © 2018. Siemens Product Lifecycle Management Software Inc. All rights reserved.
Unrestricted
White Paper | FCC and FSC Internal Socket Buffer Tuning 5

DOCUMENT HISTORY

Version Date Author Description

4.1 D. Howe

4.2 03/21/2017 N. Saxton Update cover page and copyright

Update document template

4.3 7/20/2018 T. Goerdt Updated content and formatting

Issued by: Siemens PLM Software. © 2018. Siemens Product Lifecycle Management Software Inc. All rights reserved.
Unrestricted
White Paper | FCC and FSC Internal Socket Buffer Tuning 6

CONTRIBUTORS

T. Goerdt Principal Infrastructure Architect

P. Kessler Infrastructure Architect

REVIEWERS

T. Goerdt Principal Infrastructure Architect

P. Kessler Infrastructure Architect

Issued by: Siemens PLM Software. © 2018. Siemens Product Lifecycle Management Software Inc. All rights reserved.
Unrestricted
White Paper | FCC and FSC Internal Socket Buffer Tuning 7

Table of Contents

1 INTRODUCTION 8

2 CONFIGURATION AND TUNING 9

2.1 CONFIGURING CLIENT TCP STACKS 9

2.2 TUNING FMS BUFFERS 9
2.3 CONFIGURING TCCS/FCC BUFFERS 9
2.4 THE BUFFER SIZE SETTING. 10
2.5 CONFIGURING FSC BUFFERS 10
2.6 EXAMPLE FCC LOG FILE 11

3 FREQUENTLY ASKED QUESTIONS (FAQ) 12

3.1 HOW CAN I TELL WHAT BUFFER SIZE IS BEING USED BY THE FSC? 12
3.2 WHAT VERSIONS OF TEAMCENTER SUPPORT BUFFER TUNING? 12

Issued by: Siemens PLM Software. © 2018. Siemens Product Lifecycle Management Software Inc. All rights reserved.
Unrestricted
White Paper | FCC and FSC Internal Socket Buffer Tuning 8

1 Introduction
To get best performance on a WAN connection FMS need to make use of dynamic TCP
Windowing.

The TCP window is the amount of data that can be in transient between the client and the server.
Data cannot be sent over the network until the receipt of the first packet of data in the windows is
received. The diagram below show the basic principal. The result of the wait for
acknowledgement is a reduction in the throughput of the network.

Time to Transfer window at zero latency

Transit
Time
Acknowledgment Time

Round Trip Latency

In order to reduce the delay in acknowledgement the windows size needs to be as large as
possible. Ideally data in transit would fill the connection between the client and the server. The
data in transit is known as the Bandwidth Delay Product (BDP).

Bandwidth Delay Product is defined as capacity of a pipe = bandwidth (bits/ sec) * Round Trip
Latency (s) where capacity as discussed is specific to TCP and is a byproduct of how the
protocol itself operates.

BDP in Bytes = (Bandwidth in bits per second) x (RTL in seconds)

8

For example if we have a 15Mbit/s pipe with 100 ms of latency. The BW delay product in bytes
(15000000 x 0.1)1/8 = 187500 bytes or 187.5 KB

When calculating the BDP use the bandwidth you want FMS to use rather than the total network
bandwidth if you do not want FMS to use all the available bandwidth.

Issued by: Siemens PLM Software. © 2018. Siemens Product Lifecycle Management Software Inc. All rights reserved.
Unrestricted
White Paper | FCC and FSC Internal Socket Buffer Tuning 9

2 Configuration and Tuning

2.1 Configuring Client TCP Stacks

Windows Clients running Windows 7 or 8 you will need CTCP enabled to start dynamic
windows. CTCP can be enabled using the following command

netsh interface tcp set global congestionprovider=ctcp

Windows 8.1 onward as CTCP enabled by default

Windows Server 2008R2 requires CTCP to be enabled using the command above. Windows
Server 2012 onwards has CTCP enabled by default.

Linux has dynamic windows enabled by default.

2.2 Tuning FMS Buffers

In order to take advantage of the large windows, FMS must increase the size of the buffers used
to hold data being sent over the network. Two buffers have to be increased:

1. The FMS internal buffer used to hold data for transmission.

2. The operating system socket buffer which is used to hold data before it is sent.

2.3 Configuring TCCS/FCC Buffers

The buffers used by TCCS/FCC are configured in $FMS_HOME/fcc.properties on a client as

follows:

Note: If fcc.properties does not already exist make a copy from the fcc.properties.template file.

#
# FCC internal buffer size.
# Default value is 64K.
# Value should be in 16K increments.
# Minimum is 16K.
# (The setting name you see here is correct; this information
# is internally associated with the FMS server cache (FSC)
Issued by: Siemens PLM Software. © 2018. Siemens Product Lifecycle Management Software Inc. All rights reserved.
Unrestricted
White Paper | FCC and FSC Internal Socket Buffer Tuning 10

# connections.)
#
com.teamcenter.fms.servercache.FSCConstants.buffSize=64K
#
# Socket buffer size override.
# Default value is
# (com.teamcenter.fms.servercache.FSCConstants.buffSize * 2) +
# 1024.
# The value 0 disables setting the socket buffer sizes (uses
# system default).
# Minimum value is 8K (excluding the 0 case).
# (The setting name you see here is correct; this information
# is internally associated with the FMS server cache (FSC)
# connections.)
#
com.teamcenter.fms.servercache.FSCConstants.sockBuffSize=129K

The values in the example above are for a network with a maximum Bandwidth Delay Product
(BDP) of approximately 64KB.

2.4 The buffer size setting.

(com.teamcenter.fms.servercache.FSCConstants.buffSizebuffer), should
be slightly larger than your network's maximum Bandwidth Delay Product (BDP). The socket
buffer size,
(com.teamcenter.fms.servercache.FSCConstants.sockBuffSize), is slightly
larger than twice the buffer size setting.

Note: the properties are FSC not FCC as you would expect.

2.5 Configuring FSC Buffers

The buffers used by FSC are configured in $FMS_HOME/fsc.properties on a server as follows:

# FSC internal buffer size.

# Default value is 64K.
# Value should be in 16K increments.
# Minimum is 16K.
#
com.teamcenter.fms.servercache.FSCConstants.buffSize=64K
#
# Socket buffer size override.
Issued by: Siemens PLM Software. © 2018. Siemens Product Lifecycle Management Software Inc. All rights reserved.
Unrestricted
White Paper | FCC and FSC Internal Socket Buffer Tuning 11

# Default value is #
# (com.teamcenter.fms.servercache.FSCConstants.buffSize * 2) +
# 1024.
# The value 0 disables setting the socket buffer sizes (uses #
# system default).
# Minimum value is 8K (excluding the 0 case).
#
com.teamcenter.fms.servercache.FSCConstants.sockBuffSize=129K

Note: If fsc.properties does not already exist make a copy from the fsc.properties.template file.

As in the FCC example the values are for a network with a maximum Bandwidth Delay Product
(BDP) of approximately 64KB. The properties have the same name in both FCC and FSC.

The buffer size setting

(com.teamcenter.fms.servercache.FSCConstants.buffSizebuffer) should
be slightly larger than the network's maximum Bandwidth Delay Product (BDP), and the socket
buffer (com.teamcenter.fms.servercache.FSCConstants.sockBuffSize)
size is slightly larger than twice the buffer size setting.

2.6 Example FCC log file

DEBUG - 2018/07/19-14:34:24,067 UTC - win2k12 - PERF: Local whole file binary download
(00000000000046b25b4ef8719009da68/splm_s2_ugp_na602j87loua3.prt) (0.101 / 0.634)[1] *
0.16 MB/s, requestedRoute: null
[com.teamcenter.fms.servercache.FMSWebHandlerRoot.handleLocalReadBinary(FMSWebHan
dlerRoot.java:4140):Thread[SharedThreadPool-68,5,main]]
DEBUG - 2018/07/19-14:34:28,138 UTC - win2k12 - PERF: Local whole file binary download
(00000000000044ba5b4ef8719009da68/splm_s1_ugp_aot02j87lou8j.prt) (0.087 / 0.51)[1] *
0.171 MB/s, requestedRoute: null
[com.teamcenter.fms.servercache.FMSWebHandlerRoot.handleLocalReadBinary(FMSWebHan
dlerRoot.java:4140):Thread[SharedThreadPool-26,5,main]]

Issued by: Siemens PLM Software. © 2018. Siemens Product Lifecycle Management Software Inc. All rights reserved.
Unrestricted
White Paper | FCC and FSC Internal Socket Buffer Tuning 12

3 Frequently Asked Questions (FAQ)

3.1 How can I tell what buffer size is being used by the FSC?

Stop and restart the FSC the use fscadmin to set the performance logger to debug.

fscadmin -s http://hostname:4544
./loglevel/com.teamcenter.fms.servercache.PerfLog/debug

Make a connection to the FSC. Repeating the last command would be sufficient.
In the log look for the log entry:

DEBUG - 2006/09/25-16:39:00,654 UTC {hostname} PERF: Socket

buffer sizes, recv: 8192, snd: 8192
[com.teamcenter.fms.servercache.FMSSocketListener.customizeReque
st(FMSSocketListener.java:76):SharedThreadPool-4]

This example shows the windows default of 8k send and receive buffer sizes.

3.2 What versions of Teamcenter support buffer tuning?

Buffer tuning is fully supported in Teamcenter 10.1.5 onwards and 11.2.1.

Issued by: Siemens PLM Software. © 2018. Siemens Product Lifecycle Management Software Inc. All rights reserved.
Unrestricted