Download and install XQuartz
For Mac : Download and install XQuartz.
You never have to start XQuartz separately. XQuartz will be started automatically by running the proper ssh commands.
- If this is your first time installing XQuartz, you may wish to logout and log back in to update your DISPLAY environment variable. Changes in 2.7.11 All changes in 2.7.10 plus.
- Installing XQuartz on Apple Mac. This tutorial explains how to install XQuartz application on Apple Mac. This application is required by Wine application which allows to run Embird (native Windows application) on Apple Mac computer. Note: Please note, that applications XQuartz and Wine for Apple Mac are not developed nor supported by Embird team.Also, because Embird is natively Windows.
For Linux : A proper Linux desktop is equipped with a X-Windows server.
Xquartz On Mac
Is your install of XQuartz new? Have you just installed it? If so have you logged out and back in again since the install. This is needed to get the environment setup right and is mentioned in the install docs for XQuartz. Are you sure you are running the correct version of emacs. The version in /usr/bin is not X aware.
Run SSH
For mac, start a terminal session. Use SpotLight Search to find terminal.
Spotlight Search you can find in the upper right corner
Terminal you can find by typing in terminal
in the Spotlight Search box.
Once in terminal it is hard to see if you are on the virtual box with a ssh connection or on your local Mac. Running the command whoami
reveals the user and hostname
reveals the hostname. Both username and hostname of the vaizrdemobox are displayed left from the $ prompt
On the Mac, off coarse, this is diffrent on your machine
The vaizrdemobox
First you can setup a ssh session
$ssh vaizrdemo@localhost -p 2222
password : vaizrdemo
Mac Xquartz Setup
If you see something like this below it's OK
WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED
If you see something like WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED you had a machine before which was called localhost on port 2222. Most probably an earlier version of the vaizrdemobox. The easiest thing is to expand your ssh command with -o UserKnownHostsFile=/dev/null
The command becomes ssh vaizrdemo@localhost -p 2222 -o UserKnownHostsFile=/dev/null
$ssh vaizrdemo@localhost -p 2222 -o UserKnownHostsFile=/dev/null
password : vaizrdemo
Another way to solve this problem is by removing the offending ECDA key in the ~/.ssh/known_hosts file. Just remove the indicated line. The line number is indicated after the colon known_hosts:
Run SSH for X-Windows
Second you can see if X-windows is working properly.
This is a bit more cumbersome so for this reason some scripts are prepared which you downloaded before as vaizrdemohostscripts.zip.
Unzip the vaizrdemohostscripts.zip and go with the command prompt in the cli subfolder. cli
stands for command line interface. Here are some scripts which you can run to start programs on the virtual box.
- unzip
vaizrdemohostscripts.zip
- $
cd cli
$
. ./firefox
$
. ./set_execute_env.sh
- choose [1]
- $
. ./firefox
Ignore the errors which flow over your terminal screen, it's ok as long as you see the firefox screen starting.
If all goes well you should see the Ubuntu Start Page Mozilla Firefox
You can do the same with Google-Chrome. Google-Chrome can be started. You activate chrome by accepting the presented two options.
- $
. ./google-chrome
- choose
OK
Run GUI tools on vaizrdemobox
One last remark about X-Windows Server and Windows and Mac. On Mac we can execute the scripts directly from the host. However to run convienant the commands we have to set the guest with the . ./set_execute_env.sh
before and execute the commands with . ./
in front of the actual command. On Windows it is more convenient to start the SSH session from within MobaXterm. After logging on to the Ubuntu box we can simply execute the command. Since on the Vaizr Demo Ubuntu box the scripts are packaged in the ~/bin directory which has been added to the Path. In this chapter I will repeat the commands twice but after this chapter I will normally only show the host version.
- host > Mac, run command in terminal
- guest > Windows, run command in MobaXerm terminal
- host $
. ./firefox
guest $
firefox
If everything is alright you should see the above screen. You can also use any browser on your Mac directly
Mac Install Xquartz
URL http://localhost:8080/vaizrdemo
You can login with:
username : nanne
password : nanneo
Click Here to return to Getting Started
Xquartz On Mac
Is your install of XQuartz new? Have you just installed it? If so have you logged out and back in again since the install. This is needed to get the environment setup right and is mentioned in the install docs for XQuartz. Are you sure you are running the correct version of emacs. The version in /usr/bin is not X aware.
Run SSH
For mac, start a terminal session. Use SpotLight Search to find terminal.
Spotlight Search you can find in the upper right corner
Terminal you can find by typing in terminal
in the Spotlight Search box.
Once in terminal it is hard to see if you are on the virtual box with a ssh connection or on your local Mac. Running the command whoami
reveals the user and hostname
reveals the hostname. Both username and hostname of the vaizrdemobox are displayed left from the $ prompt
On the Mac, off coarse, this is diffrent on your machine
The vaizrdemobox
First you can setup a ssh session
$ssh vaizrdemo@localhost -p 2222
password : vaizrdemo
Mac Xquartz Setup
If you see something like this below it's OK
WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED
If you see something like WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED you had a machine before which was called localhost on port 2222. Most probably an earlier version of the vaizrdemobox. The easiest thing is to expand your ssh command with -o UserKnownHostsFile=/dev/null
The command becomes ssh vaizrdemo@localhost -p 2222 -o UserKnownHostsFile=/dev/null
$ssh vaizrdemo@localhost -p 2222 -o UserKnownHostsFile=/dev/null
password : vaizrdemo
Another way to solve this problem is by removing the offending ECDA key in the ~/.ssh/known_hosts file. Just remove the indicated line. The line number is indicated after the colon known_hosts:
Run SSH for X-Windows
Second you can see if X-windows is working properly.
This is a bit more cumbersome so for this reason some scripts are prepared which you downloaded before as vaizrdemohostscripts.zip.
Unzip the vaizrdemohostscripts.zip and go with the command prompt in the cli subfolder. cli
stands for command line interface. Here are some scripts which you can run to start programs on the virtual box.
- unzip
vaizrdemohostscripts.zip
- $
cd cli
$
. ./firefox
$
. ./set_execute_env.sh
- choose [1]
- $
. ./firefox
Ignore the errors which flow over your terminal screen, it's ok as long as you see the firefox screen starting.
If all goes well you should see the Ubuntu Start Page Mozilla Firefox
You can do the same with Google-Chrome. Google-Chrome can be started. You activate chrome by accepting the presented two options.
- $
. ./google-chrome
- choose
OK
Run GUI tools on vaizrdemobox
One last remark about X-Windows Server and Windows and Mac. On Mac we can execute the scripts directly from the host. However to run convienant the commands we have to set the guest with the . ./set_execute_env.sh
before and execute the commands with . ./
in front of the actual command. On Windows it is more convenient to start the SSH session from within MobaXterm. After logging on to the Ubuntu box we can simply execute the command. Since on the Vaizr Demo Ubuntu box the scripts are packaged in the ~/bin directory which has been added to the Path. In this chapter I will repeat the commands twice but after this chapter I will normally only show the host version.
- host > Mac, run command in terminal
- guest > Windows, run command in MobaXerm terminal
- host $
. ./firefox
guest $
firefox
If everything is alright you should see the above screen. You can also use any browser on your Mac directly
Mac Install Xquartz
URL http://localhost:8080/vaizrdemo
You can login with:
username : nanne
password : nanneo
Click Here to return to Getting Started
Click Here to continue with Generate Screens
About the App
- App name: XQuartz
- App description: xquartz (App: XQuartz.pkg)
- App website: http://xquartz.macosforge.org/
Install the App
- Press
Command+Space
and type Terminal and press enter/return key. - Run in Terminal app:
ruby -e '$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)' < /dev/null 2> /dev/null ; brew install caskroom/cask/brew-cask 2> /dev/null
and press enter/return key.
If the screen prompts you to enter a password, please enter your Mac's user password to continue. When you type the password, it won't be displayed on screen, but the system would accept it. So just type your password and press ENTER/RETURN key. Then wait for the command to finish. - Run:
brew cask install xquartz
Done! You can now use XQuartz.