HOWTO_Custom

1. summary How to install and use this program without installing system-wide.
2. labels Phase-Implementation,Phase-Deploy,Phase-Support

Introduction

If you don't have root-access on a host but would still like to use this program, you can do that, but it requires a bit more configuration. This guide will cover the basics needed to get you up and running.

This guide assumes that you have already downloaded and compiled the project from source.

Steps

1. Make a directory to keep the required binaries and configuration in your home directory.  Here are some suggestions:

$ mkdir -p ~/.ash/bin # for binaries
$ mkdir -p ~/.ash/conf # for configuration files
$ mkdir -p ~/.ash/lib # for shell library code

2. Copy the compiled binaries into the local binary directory.

$ cp -a /tmp/advanced-shell-history-master/files/usr/local/bin/* ~/.ash/bin

3. Copy the required config files into the local configuration directory.

$ cp -a /tmp/advanced-shell-history-master/files/etc/ash/* ~/.ash/conf

4. Copy the required shell library code into the local lib directory.

$ cp -a /tmp/advanced-shell-history-master/files/usr/lib/advanced_shell_history/* ~/.ash/lib

5. Edit your local configuration file ~/.ash/conf/ash.conf to set this value.

#
# Setup
#
ASH_CFG_LIB='~/.ash/lib'

6. Add the following to your shell resource file:

export ASH_CFG="~/.ash/ash.conf"
export PATH="${PATH}:~/.ash/bin"
source ~/.ash/lib/bash

7. Confirm that this works as expected by testing in a new terminal window.  Open a terminal window and execute the following:

cd /
ls -l
ash_query -q CWD $ you should see the two commands above

8. Done!  You can now explore the advanced configuration options.

Next

Explore the advanced configuration options and customize what is logged or not logged.