aboutsummaryrefslogtreecommitdiffstats
path: root/resources/libraries/python/tcp.py
blob: f3a24cbd06e7bbd5ab11f2e964f229f1dea15fc7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
# Copyright (c) 2019 Cisco and/or its affiliates.
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at:
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

"""TCP util library.
"""

from resources.libraries.python.PapiExecutor import PapiSocketExecutor
from resources.libraries.python.Constants import Constants


class TCPUtils(object):
    """Implementation of the TCP utilities.
    """
    www_root_dir = '{rmt_fw_dir}/{wrk_www}'\
        .format(rmt_fw_dir=Constants.REMOTE_FW_DIR,
                wrk_www=Constants.RESOURCES_TP_WRK_WWW)

    def __init__(self):
        pass

    @classmethod
    def start_vpp_http_server_params(cls, node, http_static_plugin,
                                     prealloc_fifos, fifo_size,
                                     private_segment_size):
        """Start the test HTTP server internal application or
           the HTTP static server plugin internal applicatoin on the given node.

        http static server www-root <www-root-dir> prealloc-fifos <N>
        fifo-size <size in kB>
        private-segment-size <seg_size expressed as number + unit, e.g. 100m>
                                -- or --
        test http server static prealloc-fifos <N> fifo-size <size in kB>
        private-segment-size <seg_size expressed as number + unit, e.g. 100m>


        Where N is the max number of connections you expect to handle at one
        time and <size> should be small if you test for CPS and exchange few
        bytes, say 4, if each connection just exchanges few packets. Or it
        should be much larger, up to 1024/4096 (i.e. 1-4MB) if you have only
        one connection and exchange a lot of packets, i.e., when you test for
        RPS. If you need to allocate lots of FIFOs, so you test for CPS, make
        private-segment-size something like 4g.

        Example:

        For CPS
        http static server www-root <www-root-dir> prealloc-fifos 10000
        fifo-size 64 private-segment-size 4000m

        For RPS
        test http server static prealloc-fifos 500000 fifo-size 4
        private-segment-size 4000m

        :param node: Node to start HTTP server on.
        :param http_static_plugin: Run HTTP static server plugin
        :param prealloc_fifos: Max number of connections you expect to handle at
            one time.
        :param fifo_size: FIFO size in kB.
        :param private_segment_size: Private segment size. Number + unit.
        :type node: dict
        :type http_static_plugin: boolean
        :type prealloc_fifos: str
        :type fifo_size: str
        :type private_segment_size: str
        """
        if http_static_plugin:
            cmd = 'http static server www-root {www_root} '\
                  'prealloc-fifos {prealloc_fifos} fifo-size {fifo_size}'\
                  ' private-segment-size {pvt_seg_size}'\
                  .format(www_root=cls.www_root_dir,
                          prealloc_fifos=prealloc_fifos, fifo_size=fifo_size,
                          pvt_seg_size=private_segment_size)
        else:
            cmd = 'test http server static prealloc-fifos {prealloc_fifos} '\
                  'fifo-size {fifo_size} private-segment-size {pvt_seg_size}'\
                  .format(prealloc_fifos=prealloc_fifos, fifo_size=fifo_size,
                          pvt_seg_size=private_segment_size)
        PapiSocketExecutor.run_cli_cmd(node, cmd)