Package: aa-intel-tool
AA Intel ToolD-Scans and more inAlliance Auth.AA Intel ToolOverviewFeaturesScreenshotsChat ScanD-ScanFleet CompositionInstallationStep 1: Install the PackageStep 2: Configure Alliance AuthAdd the App to Alliance AuthAdd the Scheduled Task(Optional) Allow Public ViewsStep 4: Preload Eve Universe DataStep 5: Finalizing the InstallationStep 6: Update Your Webserver ConfigurationApache 2NginxSettingsChangelogTranslation StatusContributingNoteThis app makes use of a feature introduced with Alliance Auth v3.6.1, meaning,
installing this app will pull in Alliance Auth v3.6.1 unsupervised if you haven't
updated yet.Please make sure to update Allianceauth to version 3.6.1 or higher before you
install this app to avoid any complications.OverviewFeaturesThe following modules can be enabled or disabled.
SeeSettingssection for details.Chat scan module (Disabled by default due to its possible high number of ESI calls)D-Scan moduleScreenshotsChat ScanD-ScanFleet CompositionInstallationNotePlease make sure you meet all preconditions before you proceed:AA Intel Tool is a plugin forAlliance Auth. If you don't have Alliance Auth running
already, please install it first before proceeding. (see the officialAlliance Auth installation guidefor details)AA Intel Tool needs at leastAlliance Auth v3.6.1. Please make sure to meet this
conditionbeforeinstalling this app, otherwise an update to Alliance Auth will
be pulled in unsupervised.AA Intel Tool needsEve Universeto function. Please make sure it is installed,
before continuing.Step 1: Install the PackageMake sure you're in the virtual environment (venv) of your Alliance Auth
installation Then install the latest release directly from PyPi.pipinstallaa-intel-toolStep 2: Configure Alliance AuthAdd the App to Alliance AuthThis is fairly simple, configure your AA settings (local.py) as follows:Addeveuniverse(if not already done so for a different app) andaa_intel_toolto
the list ofINSTALLED_APPS.# Add any additional apps to this list.INSTALLED_APPS+=["eveuniverse","aa_intel_tool",# https://github.com/ppfeufer/aa-intel-tool]Add the Scheduled TaskTo remove old scans from your DB, add the following task.
The retention time can be adjusted through theINTELTOOL_SCAN_RETENTION_TIMEsetting.if"aa_intel_tool"inINSTALLED_APPS:# Run at 01:00 each dayCELERYBEAT_SCHEDULE["AA Intel Tool :: Housekeeping"]={"task":"aa_intel_tool.tasks.housekeeping","schedule":crontab(minute="0",hour="1"),}(Optional) Allow Public ViewsThis app supports AA's feature of public views. To allow this feature, please add"aa_intel_tool",to the list ofAPPS_WITH_PUBLIC_VIEWSin yourlocal.py:# By default, apps are prevented from having public views for security reasons.# To allow specific apps to have public views, add them to APPS_WITH_PUBLIC_VIEWS#   » The format is the same as in INSTALLED_APPS#   » The app developer must also explicitly allow public views for their appAPPS_WITH_PUBLIC_VIEWS=["aa_intel_tool",# https://github.com/ppfeufer/aa-intel-tool]NoteIf you don't have a list forAPPS_WITH_PUBLIC_VIEWSyet, then add the whole
block from here. This feature has been added in Alliance Auth v3.6.0 so you
might not yet have this list in yourlocal.py.Step 4: Preload Eve Universe DataAA Intel Tool utilizes the EveUniverse module, so it doesn't need to ask ESI for ship
information. To set this up, you now need to run the following command.pythonmanage.pyaa_intel_tool_load_eve_typesStep 5: Finalizing the InstallationRun static files collection and migrations.pythonmanage.pycollectstatic
pythonmanage.pymigrateRestart your supervisor services for Auth.Step 6: Update Your Webserver ConfigurationBy default, webservers have a timout of about 30 seconds for requests. So we have to
tweak that a little bit, since parsing intel data can take a while, and we don't want
the webserver to spoil our fun, right?Apache 2Open your vhost configuration and add the following 2 lines right after theProxyPreserveHost Ondirective:ProxyTimeout600Timeout600Restart your Apache2 service.NginxOpen your vhost configuration and add the following lines inside thelocation / {directive:proxy_connect_timeout600;proxy_read_timeout600;proxy_send_timeout600;send_timeout600;Restart your Nginx service.SettingsTo customize the app, the following settings are available and can be made in
yourlocal.py.WarningEnable the chat scan module at your own risk. This module has the potential to
generate a huge number of ESI calls, which CCP might not be too happy about.NameDescriptionDefaultINTELTOOL_ENABLE_MODULE_CHATSCANEnable or disable the chat scan module.FalseINTELTOOL_ENABLE_MODULE_DSCANEnable or disable the d-scan module.TrueINTELTOOL_ENABLE_MODULE_FLEETCOMPEnable or disable the fleet composition module.TrueINTELTOOL_SCAN_RETENTION_TIMESet the time in days for how long the scans will be kept in the database. Set to 0 to keep scans indefinitely.30INTELTOOL_CHATSCAN_MAX_PILOTSSet the limit of pilots for chat scans, since these can take quite a long time to process. Set to 0 to disable.500INTELTOOL_DSCAN_GRID_SIZESet the grid size for D-Scans. This definesthe size of the grid in km in which ships and structures are considered to be "on grid"10000NoteA word about the chat scan limitations:It is advised to keep theINTELTOOL_CHATSCAN_MAX_PILOTSto a sane number. Large
chat scans can take quite some time to parse and from a certain number of pilots, the
bottleneck might be your browser refusing to render the results page.
(Source: Trust me, bro …)ChangelogSeeCHANGELOG.mdTranslation StatusDo you want to help translate this app into your language or improve the existing
translation? -Join our team of translators!ContributingDo you want to contribute to this project? That's cool!Please make sure to read theContribution Guidelines.(I promise, it's not much, just some basics)