You'll install Alexandria on the machine you’ve designated as your Data Station (i.e. server); ideally, We recommend installing Alexandria on a dedicated machine that is isolated from the public and only accessible for infrequent operator maintenance. This will be called your data station. Our most current Alexandria recent hardware and operating system recommendations can be found are outlined in System Requirements.
COMPanion will send you an email you with instructions and a link links to download your Alexandria v7 Installer. If you can’t locate this emailthe Alexandria app and the Alexandria Support folder. If the email isn't in your inbox, check your SPAMspam, junk, or deleted items folders as your confirmation email may have been accidentally placed there. Download the Alexandria v7 Installer to your Data Station machine. When downloading files, we recommend you . Download the installation files and save them to your operating system Desktop desktop so they are easily located. Once downloaded, double-click on the Alexandria software installer.'re easy to find.
Application & Support Folders
Anchor | ||||
---|---|---|---|---|
|
Alexandria will install to an operating system-specific directory. If one doesn’t already exist, the installer will create an Alexandria folder and extract the application there.
The installation files must be moved to specific locations on your computer for Alexandria to be installed correctly. If the folder(s) indicated below do not already exist, please create them now in the appropriate locations.
Extract the application from the .dmg (macOS) or .zip (Windows) file and move it here:
- macOS: MacHD > Applications > COMPanion Corporation > Alexandria > Alexandria.app
- Windows:
- (C:) > Program Files (x86) > COMPanion Corporation > Alexandria
Macintosh: Hard Drive > Applications > COMPanion Corporation > Alexandria
- > Alexandria.exe
Extract the All of your database information will be stored in an Alexandria Support folder located in the system shared application directory.
Windows: Local Disk (C:) > ProgramData > Alexandria Support
from the .zip file and move it here:
- macOS: MacHD
- > Users > Shared > Library > Application Support > Alexandria Support
- Windows: Local Disk (C:) > ProgramData > Alexandria Support
Info | ||
---|---|---|
| ||
If you don't see the ProgramData folder, go to the View tab and click the "Hidden Items" checkbox in the Show/hide section. For more detailed instructions, read this article by How-To Geek. |
The Alexandria Support folder contains a Data folder, where your core data (database, operation files, and logs) will be stored. In an Alexandria Controller, the Data folder will contain a separate folder for each data station serial number. The configuration file, required for Alexandria to operate, is located in the Alexandria Support folder. In an Alexandria Controller, a separate configuration file is stored in each data station folder.
Installation
With the files in the right place, double-click the application file to begin the installation process.
Alexandria will be installed as a service. When the installation is complete
Core data, including the Alexandria Database, Operations Files, and Logs will be contained within a folder named according to the database serial number and located within the Data folder inside of the Alexandria Support folder. An Alexandria Controller will contain a separate data station serial number folder for each data station under its management. Alexandria also requires a configuration file for a data station to be able to run. In a single data station setup this will be located next to the Data folder, at the root of the Alexandria Support folder. This is also the case for an Alexandria Controller; however, in this environment the configuration file for each controlled data station will be located within in its data station serial number folder.
During installation, Alexandria will attempt to register with your operating system as a service. Afterward, restart your computer to finalize the process. From this point on, Alexandria will launch at startup and continue to run in the background.
You can control the service via in the Service Control Manager on Windows or by using launchctl on macOS.
- sudo launchctl stop Alexandria
- sudo launchctl start Alexandria
Registration
Registration is largely automatic. The installer includes your unique Self-Hosted registration information in the configuration.txt file stored in your data Data folder — your Data Station data station just needs to connect to COMPanion servers to validate.
You shouldn't do anything with this file, but in case you wanted to know what it all means, here are some of the finer details:
Registration
- Name. Name is a string.
- Product Codes. Product Codes is a string.
- Serial. Serial is a string.
Web Server
- Disable SSLv3 Encryption. Disable SSLv3 Encryption is a bool; “0” for disabled (off) and “1” for enabled (on).
- Disable TLS Encryption. Disable TLS Encryption is a bool; “0” for disabled (off) and “1” for enabled (on).
- Enable SSL. Enable SSL is a bool; “0” for disabled (off) and “1” for enabled (on).
- Require Secure Connection. Require Secure Connection is a bool; “0” for disabled (off) and “1” for enabled (on).
- SSL Certificate Path. SSL Certificate Path is a string.
- SSL Chain Path. SSL Chain Path is a string.
- SSL Folder Path. SSL Folder Path is a string.
- By default: /Users/Shared/Library/Application Support/Alexandria Support/SSL/
- SSL Private Key Path. SSL Server App Name is a string.
- SSL Server App Name. Secure Port ID is a number and supports numeric characters only.
- Secure Port ID. Secure Port ID is a number and supports numeric characters only.
- Server Domain. Server Domain is a string.
- Web Port ID. Web Port ID is a number and supports numeric characters only.
- Z39.50 Server Port ID. The Z39.50 Server Port ID is a number and supports numeric characters only.
Controller
- Host Name. Host Name is a string.
- Simultaneous Tasks. Simultaneous Tasks is a number and supports numeric characters only.