Debugging issues for InstructLab

Debugging configuration issues

Debug an issue when you experience it.

There might be a configuration issue with the taxonomy or a CLI version issue.

Try one of the following options to resolve the issue.

Step 1: Validate the local taxonomy

Install the ilab CLI.

Run the ilab command to verify that the CLI is installed.

ilab

Output:

Usage: ilab [OPTIONS] COMMAND [ARGS]...

   CLI for interacting with InstructLab.
   ...

Initialize the ilab CLI and complete the prompts.
```
ilab config init
```
Run the diff command where the --taxonomy-base is the branch to compare the local files with. If you are using the InstructLab community taxonomy, this branch is main.
```
ilab taxonomy diff --taxonomy-path <local-path-to-taxonomy>  --taxonomy-base=empty
```
Output without any errors:
```
Taxonomy in <local-path-to-taxonomy> is valid :)
```

Step 2: Verify the version

If the issues are with the backend and not your taxonomy or local configuration, verify that the local CLI installation version matches what is being used in the backend.

Get the back end instructlab version.

a. In the Object Storage bucket, click synthetic_data > ID > logs > ilab_system_info.log.

b. Click Download object to download the log file.

c. Note the value for instructlab.version.
Get the local CLI version.
```
ibmcloud ilab -v
```
If the versions do not match, update the local CLI plug-in.
```
ibmcloud plugin update ilab
```