💽 Versions and Compatibility
ECLI 2.2.1 works with P21E 4.1 and higher
P21E 5.0 is needed for full functionality
This ECLI version is compatible with both Java 8 and Java 11
ECLI 2.1 works with P21E 4.1 and higher
ECLI 2.0 works with P21E 4.1
ECLI 1.0 works with P21E 4.0
🛰 Port Requirements
To use the CLI, these ports must be unblocked for outbound connections on your network. Note: These are the same ports that Aspera uses for file uploads.
Protocol | Open Port Requirement |
TCP | 443 |
TCP | 20022 |
UDP | 33001 |
Note: CLI users do not need to install Aspera Connect nor the Aspera browser plugin because Aspera is included in the CLI.
🔐 Access: Roles & Assignments
Note these differences:
A User API Key has the same Roles & Assignments at that User.
A System API Key has the Roles & Assignments you choose.
Roles:
To validate data in an existing Data Package,
AnalystRole or greater is needed. (Rule DesignerRole is needed too on P21E 4.x and lower.)To validate define.xml,
Define DesignerRole is needed.System ManagerRole gives access to every Project, Study, and Data Package in your environment, even if the User is not explicitly assigned to one of those Objects—use with caution!
Assignments:
A User API Key has the same Assignments as that User, so no extra steps are needed.
A System API Key needs to be added to Group, and then you need to assign that Group to a Project, Study, and Data Package. You can also add regular users to that Group, so that they can see the results from validations run by the System API Key.
👣 What's Next?
Learn more in How do I use P21 Enterprise via API/CLI?
Email questions or feedback to support@pinnacle21.atlassian.net.