Ubuntu Linux Setup Notes

Ubuntu_setup_notes.txt

Graham's Ubuntu Setup Notes
===========================

These notes are a record of how I set up a fresh install of Ununtu 18.04 LTS (well actually xUbuntu for me) and get it to do what I want....

Starting from a fresh install.....

Install the INDI server
-----------------------
	sudo add-apt-repository ppa:mutlaqja/ppa
	sudo apt-get update
	sudo apt install indi-atik indi-full indi-bin libindi-dev

Set up Python environment
-------------------------
  sudo apt install build-essential python3-pip libz3-dev python-setuptools python3-dev swig 
  sudo apt install python3-gi-cairo python3-gi gir1.2-gtk-3.0 pkg-config libcairo-dev libgirepository1.0-dev
	sudo apt install libcfitsio-dev libnova-dev virtualenv

Create and activate a python3 virtual environment
	sudo pip3 install virtualenvwrapper
	Add the following to ~/.bashrc:
		export WORKON_HOME=$HOME/.virtualenvs
		export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3
		source /usr/local/bin/virtualenvwrapper.sh
	source ~/.bashrc
	mkvirtualenv --python=/usr/bin/python3 py3
	workon py3

Install Python packages
-----------------------
	pip install pyindi-client
	pip install numpy astropy gobject PyGObject opencv-python pypng scipy
	pip install matplotlib pdoc3

Install ImageJ image analysis programme
---------------------------------------
	wget http://wsr.imagej.net/distros/cross-platform/ij152.zip
	unzip ij152.zip
	sudo mv ImageJ /usr/local
	sudo apt install default-jdk
	Edit /usr/local/ImageJ/run to read java -Xmx512m -jar /usr/local/ImageJ/ij.jar

	sudo ln -s /usr/local/ImageJ/run /usr/local/bin/ij
	ImageJ can now be run using the command 'ij'
  
Remote login Capability
-----------------------
sudo apt install openssh-server
	
Samba File Shares
-----------------
sudo apt install samba
Edit /etc/samba/smb.conf to be something like the following.   This sets up a share that requires authentication to access it (otherwise Windows 10 refuses to connect), and which allows symbolic links to other parts of the filesystem.

[global]
   workgroup = WORKGROUP
	 server string = %h server (Samba, Ubuntu)
   dns proxy = no
   log file = /var/log/samba/log.%m
   max log size = 1000
   panic action = /usr/share/samba/panic-action %d

####### Authentication #######
   server role = standalone server
   passdb backend = tdbsam
   obey pam restrictions = yes
   unix password sync = yes
   passwd program = /usr/bin/passwd %u
   passwd chat = *Enter\snew\s*\spassword:* %n\n *Retype\snew\s*\spassword:* %n\
n *password\supdated\ssuccessfully* .
   pam password change = yes
   map to guest = never   # THIS WAS IMPORTANT TO GET IT WORKING WITH WINDOWS 10
   usershare allow guests = no
   create mask = 0775
   directory mask = 0775
   allow insecure wide links = yes

[s4-labuser]
    browsable = yes
    read only = no
    follow symlinks = yes
    wide links = yes
    path = /home/labuser/shared_files

After editing, restart samba with
  sudo service smbd restart
  
Create at least one samba user to use for authentication using:
  sudo smbpasswd -a <username>
  
To make it discoverable on Windows 10, we need to run an additional Daemon

git clone https://github.com/Andy2244/wsdd2.git
cd wsdd2
make
cd ..
sudo mv wsdd2 /usr/local
sudo ln -s /usr/local/wsdd2/wsdd2 /usr/local/bin/wsdd2

Append the following to /etc/rc.local
  /usr/local/bin/wsdd2 -d
make /etc/rc.local executable with sudo chmod -x /etc/rc.local

Inhibit Sleep when Laptop Lid Closed on Login Screen
====================================================
Add the following line to /etc/systemd/logind.conf
	HandleLidSwitch=ignore