Manually Expanding Archibus Web Central Files
Manually Expanding Archibus Web Central Files
Sometimes you need to move your Archibus Web Central files, as when you want to install the files on a file system or computer unavailable from the Archibus Setup program.
Expanding Archibus Web Central Files
Suppose you installed the Archibus Web Central files to \afmxx\temp. The Setup program places all of the files in a set of \afmxx\temp\archibus\ subfolders -- but it also installs a Web archive file in \afmxx\temp\archibus.war. To copy the files:
-
Copy
archibus.war
to your chosen destination folder, e.g.
C:\bea\user_projects\domains\archibu
s . - Expand the files to an archibus folder, preserving all subfolders.
-
On
Windows, you can use WinZip to do this. Double-click on the
archibus.war
file and use the Extract command
.
Extract To:myserver\webapps\
archibus
Be sure to turn on the Use Folder Names option. -
On
Unix and Linux, make and enter an archibus subfolder and use "
gunzip -r
archibus.war
".
- If deploying to Windows and files exceed maximum path length, consider enabling long path names as documented in this Microsoft topic: https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=registry
-
Once you have the files expanded
and the subfolder structure in place, copy your license file from
\Afmxx\temp\archibus\WEB-INF\config\ai-licenses.bin
to your new\myserver\webapps\archibus\WEB-INF\config
folder. The license file is configured for your organization in particular, and is not included in the .war file.
Exploded Archive Directories
The steps above deploy Archibus Web Central in a series of "exploded archive directories" rather than as a single archive file. This is because when you create Archibus view files over the Web, the Archibus Web application writes them to the file system through the application context and must have access to a physical file system.
This is also why when installing the archibus.war file you must expand it in a specific location rather than let the application server expand it for you: the application server will often place the Archibus Web application in a managed archive or location from which it cannot access the necessary files.