LabCAS Docker Environment

This repository provides a Dockerized setup for LabCAS (Laboratory Catalog and Archive System) at JPL. It includes a Dockerfile and a build_labcas.sh script for automating the process of building and running the LabCAS environment, complete with LDAP configuration, Apache, and backend services.

Table of Contents

• Overview
• Prerequisites
• Installation
• Usage
• Configuration
• Advanced Usage
• Contributing
• License

Overview

This project automates the deployment of the LabCAS environment using Docker. The Docker image contains all necessary dependencies, including OpenJDK, Apache, LDAP, and the LabCAS backend. The build_labcas.sh script simplifies the build and run process, handling LDAP initialization, Apache setup, and backend service execution.

Prerequisites

Before you begin, ensure you have the following installed:

• Docker
• Git
• Bash (for running the provided script)
• A valid LabCAS username and password for accessing the resources

Installation

1. Clone the Repository

   git clone https://github.com/your-username/labcas-docker.git
   cd labcas-docker

2. Configure Credentials

   You will need your LabCAS username and password for authentication. These can be configured directly in the build_labcas.sh script or passed as environment variables.

Usage

To build and run the LabCAS Docker environment, simply run:

docker-compose up --build

If you have already run previous builds and re-running, recommend shutting down previous environments first:

docker-compose down
docker-compose up --build

This script will:

1. Build the Docker image across the Dockerfiles in subdirectories labcas-ui, labcas-backend, and ldap.
2. Run the Docker container with the necessary environment variables.
3. Initialize the LDAP configuration.
4. Start the Apache server.
5. Launch the LabCAS backend services.

Important Notes and Troubleshooting

Docker Container Error

If you get an error that a previous Docker container still exists, run the following command to remove the container:

docker rm [9c*** container ID]

CORS Issue

You might encounter CORS issues because the LabCAS backend web service is currently hosted on port 8444 while the UI is on port 80. A future release will resolve this by changing the UI to port 443 and set up a reverse proxy on the LabCAS backend.

For continued testing, if you’re using a MacBook, you can bypass CORS issues by running Chrome without CORS checks using the following command:

open -na "Google Chrome" --args --disable-web-security --user-data-dir="/tmp/chrome_dev"

Disabling Certificate Checks (Temporary)

Because the SSL certificates are not yet set up, please follow the steps below to disable certificate checks for the LabCAS backend service:

1. Open Chrome as described in step 4 (with --disable-web-security).
2. Navigate to: https://3.80.56.196:8444/labcas-backend-data-access-api/auth
3. Click “Proceed to [your_ip_address]” to bypass the certificate warning.

Configuration

Configuration Change: ui/environment.cfg

Please update the following file: ui/environment.cfg. Replace ip_address_placeholder with the actual IP address of your server. If you are running this locally on a MacBook, you can use localhost as the IP address:

ip_address_placeholder -> localhost (or your server IP)

Environment Variables

You can configure the following environment variables to customize your setup:

• LDAP_ADMIN_USERNAME: The LDAP admin username (default: admin)
• LDAP_ADMIN_PASSWORD: The LDAP admin password (default: secret)
• LDAP_ROOT: The LDAP root domain (default: dc=labcas,dc=jpl,dc=nasa,dc=gov)
• HOST_PORT_HTTP: The host port to map to container's port 80 (default: 80)
• HOST_PORT_HTTPS: The host port to map to container's port 8444 (default: 8444)

Script Configuration

To modify the build and run process, you can edit the build_labcas.sh script. The following variables are available:

• IMAGE_NAME: The name of the Docker image to build (default: labcas_debug_image)
• CONTAINER_NAME: The name of the Docker container to run (default: labcas_debug_instance)

Contributing

Contributions are welcome! Please fork the repository, make your changes, and submit a pull request.

License

The project is licensed under the Apache version 2 license.