Skip to content

rocky9_build.md

Latest commit

 

History

History
90 lines (77 loc) · 3.07 KB

rocky9_build.md

File metadata and controls

90 lines (77 loc) · 3.07 KB

Building MoonRay on Rocky Linux 9

Start with reading the general build instructions.

Base Requirements

  • CMake 3.23.1 (or greater)

Step 1. Create the folders

Create a clean root folder for moonray. Attempting to build atop a previous installation may cause issues. The folders can be created in the location of your choosing, but these instruction, the provided CMake presets, and several of the scripts mentioned below assume this location/structure.

mkdir -p /opt/MoonRay/{installs,build,build-deps,source}
mkdir -p /opt/MoonRay/installs/{bin,lib,include}

Step 2. Clone the OpenMoonRay source

sudo dnf install -y git git-lfs
cd /opt/MoonRay/source
git clone --recurse-submodules https://github.com/dreamworksanimation/openmoonray.git

Note: If building for Houdini, you'll potentially need to make the following changes before proceeding:

  • Edit source/openmoonray/CMakeLinuxPresets.json to update HOUDINI_INSTALL_DIR
  • Edit source/openmoonray/scripts/Rocky9/setupHoudini.sh to update HOUDINI_PATH
  • Edit source/openmoonray/building/Rocky9/pxr-houdini/pxrTargets.cmake to update HPYTHONLIB and HPYTHONINC if needed

Step 3. Install some of the dependencies via script/package manager

sudo source openmoonray/building/Rocky9/install_packages.sh
sudo dnf install -y cuda-toolkit

You can add arguments --nocuda and --noqt to skip GPU and GUI support respectively.

Step 4. Build the remaining dependencies from source

Note: If building for Houdini you'll need to build moonray against Houdini's USD libraries. You'll want to skip building USD during this step by adding -DNOUSD=1 to the first cmake command below: cmake -DNO_USD=1 ../source/openmoonray/building/Rocky9. You should clean the build-deps/ and installs/ directory if you have previously installed the dependencies without passing -DNOUSD=1, to remove any USD related files or step 5 may fail to link to Houdini's USD libs.

cd /opt/MoonRay/build-deps
cmake ../source/openmoonray/building/Rocky9
cmake --build . -- -j $(nproc)

Step 5. Build MoonRay

Note: If building for Houdini, replace rocky9-release presets below with rocky9-houdini-release

cd /opt/MoonRay/source/openmoonray
cmake --preset rocky9-release
cmake --build --preset rocky9-release -- -j $(nproc)

Step 6. Run/Test

source /opt/MoonRay/installs/openmoonray/scripts/setup.sh
cd /opt/MoonRay/source/openmoonray/testdata
moonray_gui -exec_mode xpu -info -in curves.rdla

HOUDINI: Open a terminal and run:

cd /opt/hfs20.0  # location of houdini install
source houdini_setup
source /opt/MoonRay/source/openmoonray/scripts/Rocky9/setupHoudini.sh
houdini

In the Main menu bar at top select Desktop->Solaris In the Scene View tab on the main window, change from "obj" to "stage". Click in the Solaris network editor, hit tab, type "sphere" and hit enter to place a sphere on the stage. In the viewport menu, click on "Persp" and select "Moonray", this should trigger rendering.

Step 8. Post-build/install Cleanup

rm -rf /opt/MoonRay/{build,build-deps}