*********************
Troubleshooting Guide
*********************

.. contents::

Introduction
============

The documentation for Armv-A Base AEM FVP platform software typically
suffices in most cases but there could be certain host development machine
dependencies that could cause failures either during the build or execution
stages. This page provides solutions for known issues that could affect the
use of the platform software stack.


Error while using repo command
==============================

The `repo init` or `repo sync` command fails with the below listed error
message.

::

  File "<path-to-workspace>/.repo/repo/main.py", line 79
  file=sys.stderr)
      ^
  SyntaxError: invalid syntax


The typical reason for this failure could be that the default version of python
on the development machine is not Python3.6. To resolve this issue, install the
latest version of python, if not already installed on the development machine
and invoke the repo command from `/usr/bin/` with `python3` as listed below.

::

  python3 /usr/bin/repo init \
                -u https://git.gitlab.arm.com/arm-reference-solutions/arm-reference-solutions-manifest.git \
                -m pinned-aemfvp-a.xml \
                -b refs/tags/AEMFVP-A-2021.09.20

  python3 /usr/bin/repo sync


Builds do not progress to completion
====================================

During the build of the platform software stack, components such as GRUB
download additional code from remote repositories using the git port (or the
git protocol). Development machines on which git port is blocked, the build
does not progress to completion, waiting for the additional code to be
downloaded. This typically is observed when setting up a new platform software
workspace.

As a workaround, use https instead of git protocol for cloning required git
submodules of the various components in the software stack. A patch, as an
example of this change in the GRUB component, is listed below.

::

  diff --git a/bootstrap b/bootstrap
  index 5b08e7e2d..031784582 100755
  --- a/bootstrap
  +++ b/bootstrap
  @@ -47,7 +47,7 @@ PERL="${PERL-perl}"

   me=$0

  -default_gnulib_url=git://git.sv.gnu.org/gnulib
  +default_gnulib_url=https://git.savannah.gnu.org/git/gnulib.git

   usage() {
     cat <<EOF


FVP closes abruptly
===================

Tests such as distribution installation take few hours to complete on Armv-A
Base AEM FVP. If the model quits abruptly during its execution
without any particular error message displayed on the model launch
window, the host machine's memory requirements have to be rechecked.
Refer to the `model document`_ for more information about the system
requirements and follow the recommended configurations.

Repo sync fails when downloading Linux repo
===========================================

If the download of the Linux repo fails during the execution of the 'repo sync'
command, rerun the repo init command with the "--depth=1" parameter appended
to the repo init command. This parameter reduces the commit history that is
downloaded and can reduce the failures in downloading Linux repo.


--------------

*Copyright (c) 2021, Arm Limited. All rights reserved.*

.. _model document: https://developer.arm.com/documentation/100965/1115/Installing-Fast-Models/Requirements-for-Fast-Models?lang=en