How to install StackMan Terminal Edition
----------------------------------------

1. Create a new Linux user, for example

	sudo useradd stamuser
	sudo groupadd stamuser

2. Copy the stam program archive to the user's folder and unpack it

	su stamuser
	cd ~
	tar -xvf stackmanager_linux.tar.gz
	sudo chown -r stamuser:stamuser ~stamuser/stam

3. Optional: If you want to avoid direct shell access, you make stam the default shell. For example, the user's entry in /etc/passwd could look like this:

	stamuser:x:1002:1004:StackMan Terminal Edition,,,:/home/stamuser:/home/stamuser/stam/stam

4. Create a MySQL database (and users) and import the following SQL dump:

	stam_entries.sql

5. Copy the default configuration file to the home directory of the user and edit it (add the MySQL data).

	Method 1:

		su stamuser
		cp ~/stam/defaults/.stam_config ~
		nano ~/.stam_config

	Method 2:

		su stamuser
		~/stam/write_stam_config

6. Copy the nanorc file (for syntax highlighting) and, if necessary correct the path to stam.nanorc to the absolute path of your user:

	su stamuser
	cp ~/stam/nanorc/.nanorc ~
	rnano ~/.nanorc

	You can test the syntax highlight with this command:

	nano ~/stam/nanorc/test.stam

7. Optional: If you want to create a live-backup on a external media (e.g. floppy disk or USB flash drive), you can create a symlink for the second history file 

	sudo mkdir /mnt/fdd
	sudo mount -o umask=0000,gid=1004,uid=1002 /dev/sda /mnt/fdd
	su stamuser
	touch /mnt/fdd/stam_history
	ln -s /mnt/fdd/stam_history ~/.stam_history_mir

---

Additional notes:

- If you want to run *.stam scripts, you have to correct the shebang to the correct location of the stam executable (#!/.../stam), and make the files executable (chmod +x test.stam)

- You can begin with running ~/stam/stam and enter "-help" to view all available commands.