Skip to content

Commit

Permalink
HTCondor installtion instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
@sdc50
sdc50 committed Feb 6, 2015
1 parent dd98112 commit e3eebfe
Show file tree
Hide file tree
Showing 2 changed files with 67 additions and 6 deletions.
20 changes: 14 additions & 6 deletions docs/installation/linux.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -61,8 +61,16 @@ c. Close the terminal, then log out and log back in to make the changes take eff

Adding a user to the Docker group is the equivalent of declaring a user as root. See `Giving non-root access <https://docs.docker.com/installation/ubuntulinux/#giving-non-root-access>`_ for more details.

3. Install HTCondor (Optional)
---------------------------------------------------------

HTCondor is a job scheduling and resource management system. It is used by the Tethys Compute module and is required for the module to have full functionality. Use one of the following links for instructions on how to install HTCondor through the package manager:

Enterprise Linux: `HTCondor YUM Repository <http://research.cs.wisc.edu/htcondor/yum/>`_

Debian Linux: `HTCondor Debian Repository <http://research.cs.wisc.edu/htcondor/debian/>`_

3. Create Virtual Environment and Install Tethys Platform
4. Create Virtual Environment and Install Tethys Platform
---------------------------------------------------------

Python virtual environments are used to create isolated Python installations to avoid conflicts with dependencies of other Python applications on the same system. The following commands should be executed in a terminal.
Expand Down Expand Up @@ -100,7 +108,7 @@ d. Restart the Python virtual environment::
$ . /usr/lib/tethys/bin/activate


4. Install Tethys Software Suite Using Docker
5. Install Tethys Software Suite Using Docker
---------------------------------------------

Tethys Platform provides a software suite that addresses the unique needs of water resources web app development including:
Expand Down Expand Up @@ -163,7 +171,7 @@ After you run the `tethys docker start` command, you will have running instances

If you would like to test the Docker containers, see :doc:`../supplementary/docker_testing`.

5. Create Settings File and Configure Settings
6. Create Settings File and Configure Settings
----------------------------------------------

In the next steps you will configure your Tethys Platform and link it to each of the software in the software suite. Create a new settings file for your Tethys Platform installation using the :command:`tethys` :doc:`../tethys_sdk/tethys_cli`. Execute the following command in the terminal::
Expand Down Expand Up @@ -224,7 +232,7 @@ d. Add the TETHYS_GIZMOS_GOOGLE_MAPS_API_KEY with an appropriate Google Maps v3

e. Save your changes and close the :file:`settings.py` file.

6. Create Database Tables
7. Create Database Tables
-------------------------

Execute the :command:`tethys manage syncdb` command from the Tethys :doc:`../tethys_sdk/tethys_cli` to create the database tables. In the terminal::
Expand All @@ -235,7 +243,7 @@ Execute the :command:`tethys manage syncdb` command from the Tethys :doc:`../tet

When prompted to create a system administrator enter 'yes'. Take note of the username and password, as this will be the user you use to manage your Tethys Platform installation.

7. Start up the Django Development Server
8. Start up the Django Development Server
-----------------------------------------

You are now ready to start the development server and view your instance of Tethys Platform. The website that comes with Tethys Platform is called Tethys Portal. In the terminal, execute the following command from the Tethys :doc:`../tethys_sdk/tethys_cli`::
Expand All @@ -247,7 +255,7 @@ Open `<http://localhost:8000/>`_ in a new tab in your web browser and you should
.. figure:: ../images/tethys_portal_landing.png
:width: 650px

8. Web Admin Setup
9. Web Admin Setup
------------------

You are now ready to configure your Tethys Platform installation using the web admin interface. Follow the :doc:`./web_admin_setup` tutorial to finish setting up your Tethys Platform.
Expand Down
53 changes: 53 additions & 0 deletions docs/installation/mac.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,59 @@ c. You will need a fresh installation of ``Python`` with the ``pip`` and ``virtu

d. Finally, install Docker using the `Installing Docker on Mac OSX <https://docs.docker.com/installation/mac/#installation>`_ instructions.

2. Install HTCondor (Optional)
---------------------------------------------------------

HTCondor is a job scheduling and resource management system. It is used by the Tethys Compute module and is required for the module to have full functionality.

a. Use a browser to download the HTCondor tarball from the `HTCondor downloads page. <http://research.cs.wisc.edu/htcondor/downloads/>`_ Click the link next to the version you wish to install. Select condor-X.X.X-x86_64_MacOSX-stripped.tar.gz, complete the rest of the form to submit your download request. This should redirect you to a page with a link to download the tarball.

b. In a terminal change directories to the location of the tarball, untar it, and change into the new directory::

$ tar xzf condor-X.X.X-x86_64_MacOSX-stripped.tar.gz
$ cd condor-X.X.X-x86_64_MacOSX7-stripped

c. Run the perl script condor_install with the following options to install condor

::

$ perl condor_install --install --install-dir /usr/local/condor

d. Add an environmental variable to point to the location of the global condor_config file, and add the condor bin and sbin directories to PATH. This can be done by executing the condor.sh script that was generated when condor was installed::

. /usr/local/condor/condor.sh

.. tip::

To have these environmental variables exported automatically when a terminal is started add the previous command to the .bash_profile.

::

echo '. /usr/local/condor/condor.sh' >> ~/.bash_profile

e. Start condor::

$ condor_master

f. Check that condor is running::

$condor_status

Name OpSys Arch State Activity LoadAv Mem ActvtyTime

slot1@ciwater-1.lo OSX X86_64 Unclaimed Idle 0.000 1024 0+00:50:05
slot2@ciwater-1.lo OSX X86_64 Unclaimed Idle 0.660 1024 0+00:50:06
slot3@ciwater-1.lo OSX X86_64 Unclaimed Idle 0.000 1024 0+00:50:07
slot4@ciwater-1.lo OSX X86_64 Unclaimed Idle 0.000 1024 0+00:50:08
slot5@ciwater-1.lo OSX X86_64 Unclaimed Idle 0.000 1024 0+00:50:09
slot6@ciwater-1.lo OSX X86_64 Unclaimed Idle 0.000 1024 0+00:50:10
slot7@ciwater-1.lo OSX X86_64 Unclaimed Idle 0.000 1024 0+00:50:11
slot8@ciwater-1.lo OSX X86_64 Unclaimed Idle 1.000 1024 0+00:50:04
Total Owner Claimed Unclaimed Matched Preempting Backfill

X86_64/OSX 8 0 0 8 0 0 0

Total 8 0 0 8 0 0 0

3. Create Virtual Environment and Install Tethys Platform
---------------------------------------------------------
Expand Down

0 comments on commit e3eebfe

Please sign in to comment.