installation / usability feedback for new divio user on ubuntu 16.04 / xenial

[ewann]

I've landed here from: http://support.divio.com/local-development/setup/set-up-the-local-development-environment-linux

Some of my feedback relates to https://www.divio.com/en/downloads/divio-linux/ and some of it to the divio-cli. As there is no obvious place to deposit feedback about the gui, I'll leave all of it here and anticipate you might redirect some of it :)

my

lsb_release -crs

yields

16.04
xenial

Downloading the appimage worked with out issue You may wish to reorder the documentation to mention the (possible? seems most likely) need for

chmod 700

Before mentioning running gui

In my case I got stuck at the screen requesting me to specify a local folder - it was impossible to click continue. For this reason I proceeded to attempt to install & use the cli...

pip install divio-cli

worked without issue. You may wish to reorder the documentation to mention

divio doctor

before suggesting other installation steps, since divio doctor may indicate only a small number of steps are needed.

I experienced the following with divio doctor:

At least on my platform, it incorrectly attempts to invoke docker: docker-machine is not a binary or symlink that is present after following the linked docker documentation. I was able to work around this issue with:

ln -s /usr/bin/docker /usr/bin/docker-machine

It might also be helpful to feedback to the user the appropriate / missing download (noting it doesn't exist in my case, but.. :) )

It could be helpful to attempt to detect membership of the docker group. You might also consider changing the language of "Following the installation, we strongly recommend you take Docker's advised post-installation steps." since divio-cli doesn't appear to work unless the user is a member of the docker group, or invoked using sudo

It could be helpful if you suggest to the user how to install docker-compose, or remind them the correct fm to rt. Indeed: This user should have rtfm :)

After

pip install divio-cli

I was surprised to find that divio-cli was not executable. Perhaps there are strong reasons to invoke this as divio and not divio-cli

Having managed to make divio doctor report all checks successful / green, I found I was able to progress past the original blocking page in the gui...

I next became blocked during the "local server setup" step. In the gui I saw "Running command. This may take a while." In the terminal I launched the gui from I found a prompt:

The authenticity of host 'git.divio.com (5.148.186.169)' can't be established.
RSA key fingerprint is SHA256:oKtZtDEiR6KsH5Ghh2DlrnbtS5xe9gfL/qP80NQLc0A....

probably because many minutes elapsed between the prompt and my accepting the key finger print, I next encountered:

Warning: Permanently added 'git.divio.com,5.148.186.169' (RSA) to the list of known hosts.
Connection to git.divio.com closed by remote host.
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.
--------------------------------------------------------------------------------
There was an error trying to run a command. This is most likely
not an issue with divio-cli, but the called program itself.
Try checking the output of the command above.
The command was:
  git clone git@git.divio.com:{redacted} /home/{redacted}

and an additional terminal window was launched:

There was a problem while checking your system. Please run 'divio doctor'.
user@user-Parrot:~/local-git-clones/reimagi-divio-app/here$

returning back to the gui and clicking the action "Setup" again returned me to "Running command. This may take a while"

Indeed it does. In my case the progress was visible to me because I invoked the gui from a terminal window. Had I invoked it by double clicking, I suppose I would not have had this visibility.

The next issue I faced was:

Removing intermediate container 7364eb7850c3
Successfully built fd86e57b66bd
creating new database container
 ===> Pulling database from reimagitest2 test server
 ---> Preparing downloadError: Network error. Please check your connection and try again.('Connection aborted.', error(104, 'Connection reset by peer'))

And no error message in the gui. http://support.divio.com/local-development/setup/set-up-the-local-development-environment-linux explains the linux gui client is in beta so I simply click "setup" again, and ignore the "proceed with caution" message, clicking "Setup Project"

At this point, I appear to be ready to proceed with http://support.divio.com/local-development/divio-app/using-the-divio-app

[Chive]

@ewann Thanks for your detailed feedback! Pinging the responsible maintainers @Brankub and @evildmp.

[mzhKU]

I'd like to report that on Ubuntu 18 (after following the instructions for setup of the local environment in linux, jup I can invoke docker run hello-world without sudo), the app hangs at the last "Download" checkpoint and freezes my laptop.