GTAS icon indicating copy to clipboard operation
GTAS copied to clipboard

Provide installation manual

Open pmocek opened this issue 4 years ago • 3 comments

As a system administrator, I want to read documentation of GTAS dependencies and installation procedures, so that I can install, configure, and run GTAS.

pmocek avatar Feb 26 '21 04:02 pmocek

Hi @pmocek,

Please check out https://www.youtube.com/channel/UCtXAg19WpOVH245FO9Xb5dg for step-by-step installation guides for every dependency, and core application. If the link does not work for whatever reason, please search "global travel assessment system" on YouTube and look for the GTAS channel.

There is even a video for installing the entire environment using docker, https://youtu.be/vR9ihvtP5BA .

The only integration that isn't covered at the moment is the ELK stack, but there are plans to include a walkthrough for that in the near future. In the meantime, the docker installation will likely suffice.

Please let us know what you think, or if we missed anything!

dje04001 avatar Feb 26 '21 06:02 dje04001

Please check out https://www.youtube.com/channel/UCtXAg19WpOVH245FO9Xb5dg for step-by-step installation guides

That is a video, not a manual.

My suggestion with this ticket is to produce a document. Your project, an interesting one, is nearly 100% lacking in documentation.

Why would a system administrator want someone to dictate the procedure to them? Why rely on Youtube? A video is a horribly cumbersome way of communicating information about software installation.

pmocek avatar Feb 26 '21 06:02 pmocek

So much for a picture (or motion picture) being worth a thousand words! the videos also are also linked to GitHub issues that have the commands to follow along.

All joking aside, I'm sure we have you covered. Tell us a little more about your environment, and we can upload a document. I assure you, while our GitHub project might lack documentation, that doesn't mean it doesn't exist.

We try our best accommodate the most common use cases, which mainly center around virtualized Linux environments.

Each of our deployments for our 7+ foreign partners are thoroughly documented, which also include training packages that are delivered by the World Customs Organization. Typically, this level of documentation is only provided to foreign partners due to sensitivity and specificity.

We've deployed in the following environments not including our own development environments that use Docker and Kubernetes on AWS;

  • CentOs / bare metal
  • RHEL / VMware ESXi
  • Linux / AWS
  • CentOs / Docker / ppc64le

We certainly appreciate the feedback.

dje04001 avatar Feb 26 '21 15:02 dje04001