This guide will walk you through generating a setup script for your Point of Presence (POP) and running it on your infrastructure. Follow these simple steps to get everything up and running smoothly.
- Sudo privileges: The script assumes you have sudo privileges. If you are not a sudo user, you may need to manually adjust commands involving
sudo
. - Tools, permissions, and ports required:
- Docker (latest version) - Install Docker
- Docker Compose (latest version) - Install Docker Compose
- Uvicorn (latest version): Install via PIP:
pip install uvicorn
- PIP (latest version) - Install PIP
- Python 3 (latest version)
- Git (latest version) - Install Git
- Ports 8000 and 8443 should be open
- Write permissions on the server file system
Note: This script has been tested on Ubuntu 22.04 LTS. If you plan to run it on other operating systems or Linux distributions, you may need to modify it accordingly.
-
Open your web browser and navigate to nationaldataplatform.org.
-
Once logged in, locate and click on POPs in the sidebar or main navigation to access the NDP POP Factory.
-
You will see an option to choose between POP (Point of Presence) or sciDX (Scientific Data Exchange). Select POP to proceed.
-
A form will appear asking for specific details:
- Catalog Username: Enter your catalog username.
- Catalog Password: Enter your catalog password.
- IDP Client ID: Enter the client ID for the Identity Provider. Contact the National Data Platform IDP Admins (Andreu, Sergey) to get this information.
- IDP Client Secret: Enter the client secret.
- Realm Name: Enter the appropriate realm name.
-
Fill in the required fields and click on the Generate Script button.
-
After a few moments, the setup script will be generated. Copy the script from the generated box or download it.
- Log into your server where you want to deploy the POP setup. It is recommended to have sudo permissions.
- On your server, open a text editor (like
nano
orvim
) and paste the copied script. Save the file assetup.sh
. Alternatively, you can download the file and copy it from your local machine to the server where the POP will be deployed (e.g., usingscp
or a similar tool).
-
Run the script by executing the following command:
bash setup.sh
This will initiate the setup process for your POP environment. It will take around 5-6 minutes to complete the setup and configure all the connections and permissions.
After the setup completes, you can access the catalog at http://YourMachinePublicIP:8443
and the POP API at http://YourMachinePublicIP:8000
.
The generated script assumes that the user has sudo privileges. If you do not have sudo privileges, you should comment out the parts that use sudo
. Specifically, comment out or modify the following sections:
- Installation commands:
# Install necessary tools install_docker install_docker_compose install_git install_python install_uvicorn ensure_user_permissions
By commenting out the above sections, you will prevent the script from executing any commands that require sudo
. However, you will need to ask your system administrator to install these packages if they are not already available on your system.
If you encounter any issues, please refer to the documentation provided on the platform or contact support at saleemalharir1.