|The instructions provided in this article or section are considered advanced.|
You are expected to be knowledgeable in the UNIX shell.
|The instructions provided in this article or section require shell access unless otherwise stated.|
You can use the PuTTY client on Windows, or SSH on UNIX and UNIX-like systems such as Linux or Mac OS X.
Googlecl is a python-powered command line interface to many Google services. It is possible to install it on shared and virtual servers. Note: This tutorial assumes you are using bash, which is the default shell at DreamHost.
Downloading and extracting
Go to the googlecl downloads page, and find the latest tar.gz file (googlecl-0.9.10.tar.gz at the time of this writing). Issue the following commands:
wget http://googlecl.googlecode.com/files/googlecl-0.9.10.tar.gz tar xzf googlecl-0.9.10.tar.gz
The googlecl installation process varies depending on which type of DreamHost you have.
If you have standard (shared) DreamHost Service, the installation process will need to be followed for each user you need. First, create the directories that are needed for the installation and use of googlecl:
mkdir $HOME/lib mkdir $HOME/lib/python mkdir $HOME/.config mkdir $HOME/.config/googlecl mkdir $HOME/bin
Then, use a command line text editor like nano to add the following lines to $HOME/.bash_profile:
export PYTHONPATH="$HOME/lib/python" PATH=$PATH:$HOME/bin export PATH
Exit SSH and log back in so your changes to $HOME/.bash_profile can take affect. Then cd to the googlecl directory like so:
Finally, run the setup script:
python setup.py install --home=~
Installation on a VPS
Installation on a VPS is easier by far. Simply issue the fallowing commands from a VPS admin account:
cd googlecl-0.9.10 sudo python setup.py install
Googlecl will be installed for all of the users on your system.
Note: Each user will still need to create the proper directories so that googlecl will have a place to store it's settings.
mkdir $HOME/.config mkdir $HOME/.config/googlecl
Use the googlecl example scripts to test your installation.