3.8 Branch Directory Restructure

With the introduction of the 3.8 branch of anthillpro, some directories have been restructured to better accommodate a larger amount of files/directories that can potentially exist. The change will make it so instead of a maximum of 32,000 directories allowing for 32,000 workflows, it will be a maximum of 1,000,000 directories allowing for 1,000,000 workflows. Since this is a huge change to the structure of the \var\ directory, a layout (with an example) is provided below:

Layout Change

Assume that %ARTIFACTS_HOME%[1] is set to the \var\artifacts\ directory of the server. The table below will list the comparisons between the old & new formats.

PREVIOUS FORMAT CURRENT FORMAT
%ARTIFACTS_HOME%\project-buildprofile\buildlife\artifactset\...artifacts... %ARTIFACTS_HOME%\long format project\long format buildprofile\long format buildlife\artifactset\...artifacts...

Example

So if we assume that we have a file called awesomefile.exe on the artifacts tab of the following:

  • Build Life ID: 423234
  • Project ID: 13423
  • Build Profile ID: 922
  • Artifact Set ID: -2

The comparisons of the formats would be:

PREVIOUS FORMAT CURRENT FORMAT
%ARTIFACTS_HOME%\13423-922\423234\-2\awesomefile.exe %ARTIFACTS_HOME%\0001\3423\0000\0922\0042\3234\-2\awesomefile.exe

The key to note here is that 13423 has been separated out to 00013423, which forms directory 0001\3423. Same goes with build profile 922 to 00000922 = 0000\0922. And the same with the buildlife 423234 to 00423234 = 0042\3234. Only the artifact set ID# and the artifacts themselves remain unchanged.

Examples

To illustrate this further, three examples of each type will be given below at different directory levels to understand the directory location

Artifacts

All the following directories are assumed to be under the %SERVER_HOME%\var\artifacts directory.

PREVIOUS CURRENT INFO
11-01\63\-2\log4j-1.2.5.jar 0000\0011\0000\0001\0000\0063\-2\log4j-1.2.5.jar
  • File is log4j-1.2.5.jar
  • Project ID#: 11
  • Build Profile#: 1
  • Build Life#: 63
  • Artifact Set ID#: -2
191-161\173\-2\token.txt 0000\0191\0000\0161\0000\0173\-2\token.txt
  • File is token.txt
  • Project ID#: 191
  • Build Profile#: 161
  • Build Life#: 173
  • Artifact Set ID#: -2
TBD 0001\6385\0001\6385\0104\8577\-2\token.txt
  • File is Anthill-Example.jar
  • Project ID#: 16,385
  • Build Profile#: 16,385
  • Build Life#: 1,048,577
  • Artifact Set ID#: -2

Job Logs

All the following directories are assumed to be under the %SERVER_HOME%\var\log\job directory. Once the job trace is found, the logs are broken up into a main.log (job trace log) and individual logs for each step (command trace output).

PREVIOUS CURRENT INFO
11 11
  • Job Trace ID#: 11
094\2 094\2
  • Job Trace ID#: 2,094
826\741\073\1 826\741\073\1
  • Job Trace ID#: 1,073,741,826