はじめに
SD-Access(SDA) に関するトラブルシューティングを進めるにあたり、github 上で提供されているツール cc-assist を用いて追加のログを取得していただく手順について説明します。
事前準備
以降の操作は、TAC からの依頼があった場合にのみ実施いただくことが前提となっております。
また、各種操作を行うには、シェルを bash に切り替える必要があるため、以下の記事を参照いただき、
対応中のサービスリクエストの中で Token Response を入手し、シェルを切り替えてください。
DNAC: magshell (Restricted Shell) の概要と bash 使用手順
出力例:
[Saturday Jan 18 08:39:13 UTC] maglev@169.254.6.66 (maglev-master-169-254-6-66)
$ _shell
A challenge is already in progress with state CT_STATE_AUTHENTICATED
WFEN1QAAAQUBAAQAAAABAgAEAAAAAAMACAAAAAAAAAAABAAQhAXJrmfQjTRRpvnodpXqhwUABAAAJ2AGAARETkFDBwAMTUFHU0hFTExfQ1QyCAANRE4zLUhXLUFQTC1MCgkAJGIzODdkN2NhLTcwOWEtYmQwMS0zMTBhLWVkYTY2ODdiY2RlNw==
Please provide the consent token via [_shell -v] command for bash shell-access
[Saturday Jan 18 08:39:33 UTC] maglev@169.254.6.66 (maglev-master-169-254-6-66)
$ _shell -v KW4h2QAAAQUBAAQAAAABAgAEAAAAAAMBYkxJVU0xK2VqNWI5S0xURkdPWjZqRHRBQkY1YVlhZGdrQVdldFBLTkxBZ0pJVEdnWEZyN2pQWFQvUDQrV3pMQisNCkpxczFBcGkvU1NZNW5ENy9aU2RJSDYvQmQyNWNuNW5PTXZnK0oybDVBTmFpdHlSTk9aWkNJTEJmbTQ3MUg4TTMNCnRLdlpObzFVMXYxV1hlU3RkcWViS3VjV2pqb2dYUDZPb1M3SStUYVZIcmJ6c3RFMDh3ZFFydzNhUGw5MlRRNFcNCmpOT2NzZnYrdVJRNmJ3T25JZVlld0xXN1RVbkVTNTY4THluYVlFZHNVWk1FblprRWdQVDlmNGEwbjlVUk9URDMNCmZwTEFTa1dRUGs3U2NKTDNXQTZ0a04yY2NKS0ZEd3QrT0pOZVBZNE1lOEJLYVFQNkFOK3NKOCt2djFJTEMzUWYNCkZDRFg3UDQ4ZWtSeUtFSFNuRmlsYXc9PQ==
Warning! Activity within this shell can jeopardize the functioning of the system!
maglev@maglev-master-169-254-6-66:~$
ツールの導入
bash に切り替えたあと、git clone コマンドでツールを取得し、実行権限を設定します。
$ git clone https://github.com/yogeshdg/cc-assist
$ chmod -R a+x cc-assist
出力例:
maglev@maglev-master-169-254-6-66:~$ git clone https://github.com/yogeshdg/cc-assist
Cloning into 'cc-assist'...
remote: Enumerating objects: 98, done.
remote: Total 98 (delta 0), reused 0 (delta 0), pack-reused 98 (from 1)
Unpacking objects: 100% (98/98), done.
maglev@maglev-master-169-254-6-66:~$ chmod -R a+x cc-assist
ツールの実行
1. cc-assist を展開したディレクトリに移動し、cc-assist を実行します。
$ cd cc-assist
$ ./cc-assist
そして、メインメニューから「1」(Log Collection) を選択します。
出力例:
maglev@maglev-master-169-254-6-66:~/cc-assist$ ./cc-assist
PyInstaller/loader/pyimod03_importers.py:495: CryptographyDeprecationWarning: Python 3.6 is no longer supported by the Python core team. Therefore, support for it is deprecated in cryptography. The next release of cryptography will remove support for Python 3.6.
*****************************************************************************
*****************************************************************************
***** *****
***** CC-Assist *****
***** Version 2.0.7 *****
***** *****
*****************************************************************************
*****************************************************************************
Main Menu:
1 -> Log Collection
2 -> Utilities
3 -> Exit
Select an Option : 1
(中略)
Log Collection Menu:
1 -> IPAM
2 -> Lan Automation
3 -> Wireless
4 -> SDA-Wired
5 -> Others
6 -> Stuck tasks
7 -> START Tailing spf/np/inventory logs
8 -> Main Menu
9 -> Exit
Select an Option :
2. TAC からの指示に従って、番号を選択してください。
ENTER キーを押下するとログの生成を開始します。
例)SDA-Wired 関連のログを取得する場合は、「4」(SDA-Wired) を選択。
出力例:
Select an Option : 4
Generating data tables...
Generating networkdevice csv
Generating commonsetting csv
Generating l2segment csv
Generating segmentinfo csv
(中略)
Generating Network Design New service logs
Numbers of logs generated: 7
Collecting non-zero rabbitmq queues...
Collecting service status...
Press enter to continue...
3. ログの生成が完了したら、ENTER キーを押下し、最後に「9」(Exit) でツールを終了します。
ログファイルの取得
ログファイルは、カレントディレクトリ配下の「cc-logs/lan_automation」や「cc-logs/sda_wired」等の
ディレクトリ内に tar.gz で生成されるので、scp コマンドで外部に取得します。
出力例:
maglev@maglev-master-169-254-6-66:~/cc-assist$ find ./cc-logs -type f
./cc-logs/sda_wired/sda_wired_01-18-2025_08-53-05_UTC.tar.gz
./cc-logs/lan_automation/lan_automation_01-18-2025_10-25-35_UTC.tar.gz
maglev@maglev-master-169-254-6-66:~/cc-assist$
maglev@maglev-master-169-254-6-66:~/cc-assist$ scp cc-logs/sda_wired/sda_wired_01-18-2025_08-53-05_UTC.tar.gz user1@xx.xx.xx.xx:/tmp/
FIPS mode initialized
user1@xx.xx.xx.xx's password:
sda_wired_01-18-2025_08-53-05_UTC.tar.gz 100% 13MB 112.0MB/s 00:00
maglev@maglev-master-169-254-6-66:~/cc-assist$
以上