Installation steps
You will need to perform the following steps to test and configure your environment. For documentation purposes, transfer the values of your environment into the highlighted variables in the notes template.
Installation- ELO server system is S1
- Tomcat certificate is Z1
- ELOxc installation system is S2 (S1=S2 is possible)
- Successful validation of the HTTPS connection from S2 to the ELO server on S1
- Import from Z1 into certificate store of S2
- Set an ELO user XCADM (as main administrator) to access ELOxc Workspace
- Exchange server certificate is Z2
- Export from Z2 and import into S2 in the Trusted Publishers store
- Create certificate Z3 for ELOxc on S2 and save fingerprint TP1
| Exchange local | Exchange M365 |
| Import from Z2 into certificate store of S2 and check Autodiscover URL with Edge | Install PowerShell and Exchange Online PowerShell V2 2.0.5 (or higher) module in S2 |
| Create ELOxc service account XCSRV in domain AD1, save account XCACC and password XCPWD | Create certificate Z4, export for registration, and save fingerprint TP2 |
| Ensure XCSRV has read access to AD via LDAP | Create app registration for ELOxc in M365, save TNNT tenant and XCAPP app ID |
| Assign ApplicationImpersonation role for XCSRV in EAC | Authentication of registration with Z4 |
| API permissions to the registration for EWS and PowerShell | |
| Assignment of the Exchange Administrator role for the XCAPP service principal object (ServicePrincipal) |
- Select the installation directory, the log directory for ELOxc in S2 and the HTTPS port XCPORT above 5000
- Register ELOxc via the command line (administrator):
eloxc.exe -install -port:< HTTPS port > -logdir:<log directory> -cert:<fingerprint-Z3>
- Start ELOxc via Windows Services and open it in Edge https://S2:XCPORT
- Log on to ELOxc Workspace with XCADM
Updates
The content of the installation directory is replaced by the update package. The ELOxc.xml file must be retained.
The automatic update of the configuration takes place whenever an older configuration version than the current program version is found.
Connection settings
| Local | M365 | |
| Directory name | AD1 | TNNT |
| Authentication | XCACC | XCAPP |
| Key | XCPWD | TP2 |
Notes template
| Checklist | Local | M365 | Value |
| ELO user | XCADM | XCADM | |
| ELOxc system | S2 | S2 | |
| Workspace port | XCPORT | XCPORT | |
| Workspace certificate | TP1 | TP1 | |
| Directory name | AD1 | TNNT | |
| Authentication | XCACC | XCAPP | |
| Key | XCPWD | TP2 |
Execution
As a Windows service, ELOxc can be executed in the Local System context. The necessary authentication for the system environment and for ELO is provided in the configuration. It is recommended to run cmd.exe with administrative permissions when using a command prompt.
Execution1. To access the ELOxc Workspace user interface, open the browser and enter the following URL:
https://<ELOxc host name>:<port>
You will see the ELOxc Workspace logon screen.
2. Enter the address of the ELO Indexserver in the Indexserver URL field. You can select previously entered addresses in the drop-down menu.
3. Enter an ELO user in the User account field and the corresponding password in the field below.
4. Click Log on.
The ELOxc Workspace home screen appears.