troubleshooting-guide.rst 3.21 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
Troubleshooting Guide
=====================

.. contents::

Introduction
------------

The documentation for Neoverse reference design platform software typically
suffices in most cases. But there could be certain host development machine
dependencies that could cause failures either during build and 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-rdv1.xml -b refs/tags/RD-INFRA-2021.02.24
  python3 /usr/bin/repo sync -c -j $(nproc) --fetch-submodules --force-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


72
73
74
75
76
77
78
79
80
81
82
FVP closes abruptly
-------------------

Tests such as distro installation take few hours to complete on Neoverse
Reference Desgin platform FVPs. If the model quits abruptly during its
execution without any particular error message displayed in the model
launch window, the host machine's memory requirements has to be
rechecked. This issue is typically seen if the host machine has a
configuration below that of on the one listed at `recommended configuration`_.


83
84
85
86
87
88
89
90
91
92
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" (without the quotes)
parameter appended to the repo init command. The parameter "--depth=1" reduces
the commit history that is downloaded and can reduce the failures in
downloading linux repo.


93
94
95
--------------

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

.. _recommended configuration: docs/infra/common/download-sources.rst