1#!/usr/bin/env python
2
3r"""
4CLI FFDC Collector.
5"""
6
7import os
8import sys
9import click
10
11# ---------Set sys.path for cli command execution---------------------------------------
12# Absolute path to openbmc-test-automation/ffdc
13abs_path = os.path.abspath(os.path.dirname(sys.argv[0]))
14full_path = abs_path.split('ffdc')[0]
15sys.path.append(full_path)
16# Walk path and append to sys.path
17for root, dirs, files in os.walk(full_path):
18    for found_dir in dirs:
19        sys.path.append(os.path.join(root, found_dir))
20
21from ffdc_collector import FFDCCollector
22
23
24@click.command(context_settings=dict(help_option_names=['-h', '--help']))
25@click.option('-r', '--remote', envvar='OPENBMC_HOST',
26              help="Name/IP of the remote (targeting) host. [default: OPENBMC_HOST]")
27@click.option('-u', '--username', envvar='OPENBMC_USERNAME',
28              help="User on the remote host with access to FFDC files.[default: OPENBMC_USERNAME]")
29@click.option('-p', '--password', envvar='OPENBMC_PASSWORD',
30              help="Password for user on remote host. [default: OPENBMC_PASSWORD]")
31@click.option('-c', '--ffdc_config', default=abs_path + "/ffdc_config.yaml",
32              show_default=True, help="YAML Configuration file listing commands and files for FFDC.")
33@click.option('-l', '--location', default="/tmp",
34              show_default=True, help="Location to store collected FFDC data")
35@click.option('-t', '--remote_type',
36              help="OS type of the remote (targeting) host. OPENBMC, RHEL, UBUNTU, SLES, AIX")
37@click.option('-rp', '--remote_protocol', default="ALL",
38              show_default=True,
39              help="Select protocol (SSH, SCP, REDFISH) to communicate with remote host. \
40                    Default: all available.")
41@click.option('--log_level', default="INFO",
42              show_default=True,
43              help="python logging level (CRITICAL, ERROR, WARNING, INFO, DEBUG)")
44def cli_ffdc(remote, username, password, ffdc_config, location, remote_type, remote_protocol, log_level):
45    r"""
46    Stand alone CLI to generate and collect FFDC from the selected target.
47    """
48
49    click.echo("\n********** FFDC (First Failure Data Collection) Starts **********")
50
51    if input_options_ok(remote, username, password, ffdc_config, remote_type):
52        thisFFDC = FFDCCollector(remote, username, password,
53                                 ffdc_config, location,
54                                 remote_type, remote_protocol, log_level)
55        thisFFDC.collect_ffdc()
56
57        if len(os.listdir(thisFFDC.ffdc_dir_path)) == 0:
58            click.echo("\n\tFFDC Collection from " + remote + " has failed.\n\n")
59        else:
60            click.echo(str("\n\t" + str(len(os.listdir(thisFFDC.ffdc_dir_path)))
61                       + " files were retrieved from " + remote))
62            click.echo("\tFiles are stored in " + thisFFDC.ffdc_dir_path)
63
64        click.echo("\tTotal elapsed time " + thisFFDC.elapsed_time + "\n\n")
65    click.echo("\n********** FFDC Finishes **********\n\n")
66
67
68def input_options_ok(remote, username, password, ffdc_config, remote_type):
69    r"""
70    Verify script options exist via CLI options or environment variables.
71    """
72
73    all_options_ok = True
74
75    if not remote:
76        all_options_ok = False
77        print("\
78        \n>>>>>\tERROR: Name/IP of the remote host is not specified in CLI options or env OPENBMC_HOST.")
79    if not username:
80        all_options_ok = False
81        print("\
82        \n>>>>>\tERROR: User on the remote host is not specified in CLI options or env OPENBMC_USERNAME.")
83    if not password:
84        all_options_ok = False
85        print("\
86        \n>>>>>\tERROR: Password for user on remote host is not specified in CLI options "
87              + "or env OPENBMC_PASSWORD.")
88    if not remote_type:
89        all_options_ok = False
90        print("\
91        \n>>>>>\tERROR: Remote host os type is not specified in CLI options.")
92    if not os.path.isfile(ffdc_config):
93        all_options_ok = False
94        print("\
95        \n>>>>>\tERROR: Config file %s is not found.  Please verify path and filename." % ffdc_config)
96
97    return all_options_ok
98
99
100if __name__ == '__main__':
101    cli_ffdc()
102