Metalnx is a web application designed to work alongside iRODS. It is a graphical user interface and serves as a client that authenticates to an existing iRODS Zone.
The preferred method of deployment is via Docker. You can deploy Metalnx directly from Docker Hub.
First, create and configure a database for Metalnx's use (this is for caching and other local information).
$ (sudo) su - postgres
postgres$ psql
psql> CREATE USER metalnx WITH PASSWORD 'changeme';
psql> CREATE DATABASE "IRODS-EXT";
psql> GRANT ALL PRIVILEGES ON DATABASE "IRODS-EXT" TO metalnx;
Configuration of the default application can change many things about how Metalnx looks and behaves.
- Configuration of Zone information, and features to display
- Theming with custom CSS/Logo
Create a copy of the default etc/irods-ext directory and update metalnx.properties and metalnxConfig.xml, and then run a container with the new configuration, probably with --add-host information due to Docker:
docker run -d \
-p 8080:8080 \
-v `pwd`/mylocal-irods-ext:/etc/irods-ext \
--add-host hostcomputer:172.17.0.1 \
--name metalnx \
irods/metalnx:latest
To map a local directory with SSL certificates (self-signed or from a CA), the container will look in /tmp/cert:
-v `pwd`/mylocal-certs:/tmp/cert \
The login screen should appear when requested in a web browser:
http://x.x.x.x:8080/metalnx
Or...
From source, the package will 'just build':
make
This will result in a new Docker image named myimages/metalnx:latest on your machine.
If you're deploying your own image (built just above):
docker run -d \
-p 8080:8080 \
-v `pwd`/mylocal-irods-ext:/etc/irods-ext \
--add-host hostcomputer:172.17.0.1 \
--name metalnx \
myimages/metalnx:latest
More documentation can be found in the Docs directory.
Copyright © 2018-2019 University of North Carolina at Chapel Hill; 2015-2017, Dell EMC.
This software is provided under the BSD-3 License.
Refer to the CHANGELOG file for the latest changes