<commit_before>.. _advanced-installation-options-label:

=============================
Advanced Installation Options
=============================
TODO
* online vs offline installer
* certs<commit_msg>docs: Advanced installation options<commit_after>.. _advanced-installation-options-label:

=============================
Advanced Installation Options
=============================

Online vs Offline Installer
---------------------------
The installer has two different versions: the offline installer -- 
prestoadmin-0.1.0-offline.tar.bz2 [TODO: add link]-- and the online installer -- 
prestoadmin-0.1.0-online.tar.bz2 [TODO: add link]. The offline installer includes all of the 
dependencies for ``presto-admin``, so it can be used on a cluster without an 
outside network connection. The offline installer is recommended because it is faster.

The online installer downloads all of the dependencies when you call ``./install-prestoadmin.sh``. 
You may need to use the online installer if you try to install ``presto-admin`` on an unsupported 
operating system, because some of the binary files are dependent on the 
system files of a given operating system. Be aware, though, that there may be other 
operating system dependent differences beyond the installation process for 
unsupported operating system, and ``presto-admin`` may not work.

Specifying a Certificate Authority for the Online Installer
-----------------------------------------------------------
The online installer downloads its dependencies from ``pypi.python.org``, the 
standard Python location for hosting packages. For some operating systems, 
the certificate for pypi.python.org is not included in the CA cert bundle, 
so our installation scripts specify ``--trusted-host pypi.python.org`` when 
downloading the dependencies.

If using --trusted-host is not suitable for your security needs, it is 
possible to supply your own certificates to use to authenticate to 
``pypi.python.org``.  Please note that if these certificates do not work to 
access ``pypi.python.org``, the installation will fail. For example, to install 
with your own certificates:

::

 sudo ./install-prestoadmin.sh <path_to_cert>/cacert.pem

{'fraction_non_alphanumeric': 0.15261958997722094, 'fraction_numerical': 0.0036446469248291574, 'mean_word_length': 3.979591836734694, 'pattern_counts': {'":': 0, '<': 4, '<?xml version=': 0, '>': 4, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 3, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '7053639', 'n_tokens_mistral': 567, 'n_tokens_neox': 527, 'n_words': 249}