Itential Automation Gateway

On this page:

Offline Installation

The following set of instructions explain how to perform an offline install of Automation Gateway. Use this process when the system is disconnected from the Internet.

More information can be found at the PIP Download reference guide.

Prepare Distribution

  1. From a VM with internet access of the same OS and Python version (reminder: Automation Gateway requires Python 3) as a target customer system:

    # mkdir dist
    # cd dist
    # pip -v download --extra-index-url https://registry.aws.itential.com/repository/ansible-manager/simple  ansible-manager

    Note: There are options on the 'pip download' command where you can specify "--platform", "--python-version", "–implementation", and "–abi" to choose a different platform than the one you are on. See the following reference guide for more information.

  2. Notice that multiple .whl files are downloaded (these are all the prerequisites needed by Automation Gateway).

    [root@centos-7 d]# ls
    ansible_manager-1.45.1-py3-none-any.whl      MarkupSafe-1.1.1-cp36-cp36m-manylinux1_x86_64.whl
    ansible_runner-1.2.0-py2.py3-none-any.whl    netifaces-0.10.9-cp36-cp36m-manylinux1_x86_64.whl
    argparse-1.4.0-py2.py3-none-any.whl          pexpect-4.7.0-py2.py3-none-any.whl
    attrs-19.1.0-py2.py3-none-any.whl            psutil-5.6.1.tar.gz
    certifi-2019.3.9-py2.py3-none-any.whl        ptyprocess-0.6.0-py2.py3-none-any.whl
    chardet-3.0.4-py2.py3-none-any.whl           pyrsistent-0.14.11.tar.gz
    Click-7.0-py2.py3-none-any.whl               python_daemon-2.2.3-py2.py3-none-any.whl
    clickclick-1.2.2-py2.py3-none-any.whl        python_dateutil-2.8.0-py2.py3-none-any.whl
    connexion-1.5.3-py2.py3-none-any.whl         PyYAML-3.13.tar.gz
    docutils-0.14-py3-none-any.whl               requests-2.21.0-py2.py3-none-any.whl
    Flask-1.0.2-py2.py3-none-any.whl             setuptools-41.0.1-py2.py3-none-any.whl
    Flask_SQLAlchemy-2.3.2-py2.py3-none-any.whl  six-1.12.0-py2.py3-none-any.whl
    idna-2.8-py2.py3-none-any.whl                SQLAlchemy-1.3.3.tar.gz
    inflection-0.3.1.tar.gz                      swagger_spec_validator-2.4.3-py2.py3-none-any.whl
    itsdangerous-1.1.0-py2.py3-none-any.whl      textfsm-0.4.1.tar.gz
    Jinja2-2.10.1-py2.py3-none-any.whl           tomlkit-0.4.6-py2.py3-none-any.whl
    jsonschema-3.0.1-py2.py3-none-any.whl        urllib3-1.24.1-py2.py3-none-any.whl
    lockfile-0.12.2-py2.py3-none-any.whl         Werkzeug-0.15.2-py2.py3-none-any.whl
  3. Create a tar file of all .whl files.

    [root@centos-7 d]# tar -zcvf ansible_mgr-dist.tar.gz *
    ansible_manager-1.45.1-py3-none-any.whl
    ansible_runner-1.2.0-py2.py3-none-any.whl
    argparse-1.4.0-py2.py3-none-any.whl
    attrs-19.1.0-py2.py3-none-any.whl
    certifi-2019.3.9-py2.py3-none-any.whl
    chardet-3.0.4-py2.py3-none-any.whl
    Click-7.0-py2.py3-none-any.whl
    clickclick-1.2.2-py2.py3-none-any.whl
    connexion-1.5.3-py2.py3-none-any.whl
    docutils-0.14-py3-none-any.whl
    Flask-1.0.2-py2.py3-none-any.whl
    Flask_SQLAlchemy-2.3.2-py2.py3-none-any.whl
    idna-2.8-py2.py3-none-any.whl
    inflection-0.3.1.tar.gz
    itsdangerous-1.1.0-py2.py3-none-any.whl
    Jinja2-2.10.1-py2.py3-none-any.whl
    jsonschema-3.0.1-py2.py3-none-any.whl
    lockfile-0.12.2-py2.py3-none-any.whl
    logger-1.4.tar.gz
    MarkupSafe-1.1.1-cp36-cp36m-manylinux1_x86_64.whl
    netifaces-0.10.9-cp36-cp36m-manylinux1_x86_64.whl
    pexpect-4.7.0-py2.py3-none-any.whl
    psutil-5.6.1.tar.gz
    ptyprocess-0.6.0-py2.py3-none-any.whl
    pyrsistent-0.14.11.tar.gz
    python_daemon-2.2.3-py2.py3-none-any.whl
    python_dateutil-2.8.0-py2.py3-none-any.whl
    PyYAML-3.13.tar.gz
    requests-2.21.0-py2.py3-none-any.whl
    setuptools-41.0.1-py2.py3-none-any.whl
    six-1.12.0-py2.py3-none-any.whl
    SQLAlchemy-1.3.3.tar.gz
    swagger_spec_validator-2.4.3-py2.py3-none-any.whl
    textfsm-0.4.1.tar.gz
    tomlkit-0.4.6-py2.py3-none-any.whl
    urllib3-1.24.1-py2.py3-none-any.whl
    Werkzeug-0.15.2-py2.py3-none-any.whl

On the Customer's POC Machine

  1. Transfer the tar file (ansible_mgr-dist.tar.gz) to the machine.

  2. Verify the OS and Python versions match what you choose previously in the first step above.

    # mkdir tmp
    # cd tmp
    # tar -zxvf ansible_mgr-dist.tar.gz
  3. Run the pip command to install all the wheels.

    pip install *.whl
  4. Process complete.