The below instructions assume that your site has already installed Altair Grid Engine.
UniSight is used for monitoring live and historical data of Altair Grid Engine. The below instructions are to assist with the installation and setup of UniSight and assume that your site has internet connectivity. For sites that must perform an offline installation of UniSight, email Altair Grid Engine/NavOps support at age-navops-support@altair.com.
Note: Documentation for UniSight is installed with the product. See the UniSight documentation directory.
Install the Dockerized Version of UniSight
alternatives --install /usr/bin/python python /usr/bin/python2 0
alternatives --install /usr/bin/python python /usr/bin/python2.7 1
alternatives --install /usr/bin/python python /usr/bin/python3.6 2
pip3 install requests
tar -xvzf dockerized-unisight-<version>-<date>.tar.gz
run ./setup.sh
Note: Additional packages are downloaded as part of this installation process.
docker-compose up -d
Note: Additional packages are downloaded.
docker ps
UGERest is required for communication between Altair Grid Engine and UniSight. Documentation for installing UGERest is available as part of the Altair Grid Engine documentation.
Create a Cron Job to Move Altair Grid Engine Reporting Data to UniSight
Note: Depending on your site’s Altair Grid Engine installation (i.e., user permissions, access to mounted directories, etc.), you may need to set up the cron job differently than the following instructions.
The below instructions cover how to add the cron job to the UGE administrator’s (user = ugeadmin) crontab on the qmaster node. ugeadmin is the only user allowed to read/write the reporting files and subdirectories in $SGE_ROOT. This option was chosen because the option to add a cron job to root’s crontab on the UniSight host was not available.
cp mv-report.sh $SGE_ROOT
Note: The mv-reporting.sh script is in the directory created after extracting the UniSight tar file (e.g., opt/unisight-<version>/)
crontab -e
*/15 * * * * <$SGE_ROOT>/mv-reporting.sh
Enable Reporting and Optional joblog in Altair Grid Engine
ugeServer: host where UGERest is running (ex. 192.168.1.20)
ugePort: 8182 (secureRest=false) or 8183 (secureRest=true & using SSH)
user: admin userid
pass: admin user password
python tools/unisight_cli.py create cluster.json
Logging into Containers and Checking Log Files
docker ps
docker exec -it <container_id> /bin/bash
Install the UniSight Visualization package:
Note: It is recommended to download the latest version of this package.
tar -xvzf unisight-visualizations-<version>.tar.gz
cd prometheus/docker
GRAPHQL_HOST=172.17.0.1
docker-compose up -d
`qconf -sc > /tmp/sconf
echo "execd_running execd_running INT <= NO NO 0 0 NO 0.000000" >> /tmp/sconf
echo "scratch_mounted scratch_mounted INT <= NO NO 0 0 NO 0.000000" >> /tmp/sconf
echo "opt_total_space opt_total_space DOUBLE <= NO NO 0 0 NO 0.000000" >> /tmp/sconf
echo "opt_used_space opt_used_space DOUBLE <= NO NO 0 0 NO 0.000000" >> /tmp/sconf
echo "opt_avail_space opt_avail_space DOUBLE <= NO NO 0 0 NO 0.000000" >> /tmp/sconf
qconf -Mc /tmp/sconf`
For Altair Grid Engine versions starting with 8.7.0 and after:
`qconf -sc > /tmp/sconf
echo "execd_running execd_running INT <= NO NO 0 0 NO 0.000000 YES NO" >> /tmp/sconf
echo "scratch_mounted scratch_mounted INT <= NO NO 0 0 NO 0.000000 YES NO" >> /tmp/sconf
echo "opt_total_space opt_total_space DOUBLE <= NO NO 0 0 NO 0.000000 YES NO" >> /tmp/sconf
echo "opt_used_space opt_used_space DOUBLE <= NO NO 0 0 NO 0.000000 YES NO" >> /tmp/sconf
echo "opt_avail_space opt_avail_space DOUBLE <= NO NO 0 0 NO 0.000000 YES NO" >> /tmp/sconf
qconf -Mc /tmp/sconf`
Tip: If you notice display issues on the UniSight dashboard, restarting the container may help:
docker-compose down
docker-compose up -d
Tip: Permissions on the uge-reporting directory in $SGE_ROOT may need to be modified to a+rwx to process the reporting files.