2c66286e5f02e99efcddcf16a82763a9b4b75b69
[csit.git] / resources / tools / t-rex / t-rex-server-info.py
1 #!/usr/bin/python
2
3 # Copyright (c) 2016 Cisco and/or its affiliates.
4 # Licensed under the Apache License, Version 2.0 (the "License");
5 # you may not use this file except in compliance with the License.
6 # You may obtain a copy of the License at:
7 #
8 #     http://www.apache.org/licenses/LICENSE-2.0
9 #
10 # Unless required by applicable law or agreed to in writing, software
11 # distributed under the License is distributed on an "AS IS" BASIS,
12 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 # See the License for the specific language governing permissions and
14 # limitations under the License.
15
16 """This script uses T-REX stateless API to drive t-rex instance.
17
18 Requirements:
19 - T-REX: https://github.com/cisco-system-traffic-generator/trex-core
20  - compiled and running T-REX process (eg. ./t-rex-64 -i -c 4)
21  - trex_stl_lib.api library
22 - Script must be executed on a node with T-REX instance
23
24 Functionality:
25 1. Verify the API functionality and get server information
26
27 """
28
29 import sys
30
31 sys.path.insert(0, "/opt/trex-core-2.09/scripts/automation/"+\
32                    "trex_control_plane/stl/")
33 from trex_stl_lib.api import *
34
35
36 def get_server_system_info():
37     """Check server info and quit.
38
39     :return: nothing
40     """
41
42     # create client
43     client = STLClient()
44
45     try:
46         # connect to server
47         client.connect()
48         # get server info
49         print client.get_server_system_info()
50
51     except STLError as ex_error:
52         print_error(str(ex_error))
53         sys.exit(1)
54
55     finally:
56         client.disconnect()
57
58
59 def print_error(msg):
60     """Print error message on stderr.
61
62     :param msg: Error message to print.
63     :type msg: string
64     :return: nothing
65     """
66
67     sys.stderr.write(msg+'\n')
68
69
70 def main():
71     """Main function."""
72
73     get_server_system_info()
74
75 if __name__ == "__main__":
76     main()