Installing and configuring AEM 3D
The installation and configuration of AEM 3D (version 3.0) involves the following:
- Installing the Autodesk® FBX® SDK library.
- Downloading and installing the native 3D code package.
- Configuring the 3D asset ingestion workflow and restarting AEM.
- Validating the setup of AEM 3D.
See also Working with 3D assets .
See also AEM 3D Assets release notes for prerequisites, supported browsers, and other important release imformation.
See also Working with the 3D Sites component .
Before downloading and installing the 3D package, make sure that you have installed all prerequisite AEM packages successfully. See the AEM 3D Release Notes.
Installing the Autodesk FBX SDK library
The native AEM 3D code requires the Autodesk FBX library to support the FBX file format. (Adobe is currently unable to redistribute this library.)
See also Advanced configuration settings .
- Log onto the host where AEM is installed.
- If this is a Windows Server deployment, log onto the server as Administrator.
- If this is a MAC or Windows desktop, make sure you have administrator privileges.
- Use the link appropriate for your operating system to download FBX SDK version 2016.1.2
- OS X
- Install the FBX SDK:
- Windows. Install to the same drive where AEM is located.
- Mac. Install to the same partition where AEM is located.
- Linux. Extract the downloaded package and follow the instructions in <yourFBXSDKpath>/Install_FbxFileSdk.txt . Install the SDK to /usr .
Downloading and installing the native 3D code package
Before you proceed with the installation and configuration of AEM 3D, Adobe recommends that you deploy any applicable service packs and other related feature packs. See AEM 3D Release Notes .
See also Advanced Configuration Settings .
To install the native 3D code package :
- Do one of the following:
- If this is a Windows Server deployment, log on to the server as Administrator.
- If this is a Mac or Windows desktop, make sure you have Adminstrator privileges.
- Ensure that you have a supported browser available to access AEM.See System requirements .
- Using a supported browser, log on to AEM with Administrator privileges.
- In AEM, click the AEM logo to access the global navigation console, then click the Tools icon and navigate to Administration > Deployment > Package Share .
- On the Adobe page, use your Adobe ID credentials to log on to your Adobe Creative Cloud account.
- On the Adobe packages page, locate version 3.0.1 of AEM-6.4-DynamicMedia-3D feature pack, then download it.
- In AEM, click Tools > Administration > Deployment > Package Manager .
- Locate the downloaded feature pack, then click Install .
- In the Install Package dialog box, expand Advanced Settings , then set Access Control Handling to Merge .
- Click Install to begin installation of the package.The file sample-3D-content.zip is placed in the Assets root folder. See Validating the setup of AEM 3D for additional information.
Configuring the 3D asset ingestion workflow and restarting AEM
To configure the 3D asset ingestion workflow :
- In AEM, click the AEM logo to access the global navigation console, then click the Tools icon and navigate to Workflow > Models .
- On the Workflow Models page, hover over the DAM Update Asset workflow, and when the check mark appears, select it.
- On the toolbar, click Edit .
- On the DAM Update Asset screen, in the AEM floating panel, click the Plus icon to the right of Workflow to expand the list. Select Process Step in the list.
- Drag Process Step and drop it into the workflow just before DAM Update Asset Workflow Completed component near the end of the workflow.
- Double-click the newly added process step.
- In the Step Properties dialog box, under the Common tab, in the Title field, enter a suitable description for the process such as Process 3D content .
- Click the Process tab.
- From the Process drop-down menu, select Geometric 3D Object Service , then select the Handler Advance check box.
- Near the upper-right corner of the dialog box, click the check mark icon to return to the DAM Update Asset page.
- Near the upper-right corner of the DAM Update Asset page, click Sync to save the edited workflow model.
- Restart AEM.After restart, you are ready to upload 3D content and have AEM process it.Continue with Validating the setup of AEM 3D .
Validating the setup of AEM 3D
- In AEM, click Tools > Assets , then download sample-3D-content.zip , and expand the downloaded file. (You can now delete sample-3D-content.zip in AEM.)Make sure you are in Card View to view upload and processing feedback in the remaining steps.
- Create a folder named test3d to receive test content.
- Upload all files from sample-3D-content/images to the test3d folder.
- Wait for the upload and processing to complete. You may need to refresh your browser.Upload the three .fbx files from sample-3D-content/ to the test3d folder.Do not upload the .ma model files yet.
- In the Card View, observe the message banners that are shown on the 3d asset cards.Each asset proceeds through several processing steps. When the Creating Preview... processing step completes, the card is updated with a thumbnail image. When final processing is completed, the banner is replaced with the NEW indicator.Expect very high CPU utilization while 3D processing is in progress. Depending on available CPU capacity it may take a substantial amount of time to complete all processing.
- You will now learn how to resolve file dependencies.On the Unresolved Dependencies banner for the stage-helipad.fbx card, click the Exclamation Point icon to navigate to the asset's properties and open the Dependencies tab.
- Click the Folder/Magnifying Glass icon to the right of the file name to open the asset browser and resolve the dependencies as follows:
- Click Save and Close to finish processing the asset and return to the Card View , respectively.
- When processing is complete, you see the following in Card View :
- On the test3d page, click the logo-sphere.fbx card to open the model in Detail View .Near the upper-right corner of the logo-sphere.fbx page, click the Stage Spotlight icon to expand the drop-down menu, then select stage-spotlights.fbx .
- From the Stage Spotlight drop-down list, select stage-helipad.fbx .Using the left mouse button to adjust the view. The background and model lighting changes to reflect the new stage selection.
Configuring support for Adobe Dimension assets
This configuration task is optional.
You can optionally configure support in AEM 3D for Adobe Dimension assets.
You must configure an external conversion service to allow ingestion, preview, and publishing of Adobe Dimension 3D assets in AEM. The service converts from the proprietary Adobe Dimension ( .dn ) format to a variant of glTF (formatted as a .glb file) which is saved with the Dn asset as a rendition. The .glb rendition is used for web-based viewing of the 3D asset in AEM Assets, Sites, and Screens, and is also available for downloading for use with third-party applications.
The conversion service is hosted by Adobe in Amazon AWS. After properly configuring the service, .dn files uploaded to AEM are then copied securely to the conversion service by way of temporary storage in Amazon S3. The conversion result is transferred back to AEM by way of temporary S3 storage. All transfers and storage are secured. Also, the content persists in S3 and the conversion service only briefly (typically no more than a few minutes).
To configure suoport for Adobe Dimension assets :
- Contact your Adobe AEM account manager, provisioning expert, or support representative to request credentials for AEM3D Services .Only one set of credentials is required for each organization, regardless of the number of AEM instances on which the credentials are installed.
- Verify that you have received the following information:
- As Administrator, log into your AEM author instance where you want the credentials installed, then open CRXDE Lite .
- Configure the new credentials information by doing the following in CRXDE Lite:
- Navigate to /libs/settings/dam/v3D/services/dncr and set the clientId property to the new value.
- Navigate to /libs/settings/dam/v3D/services/aws and set the accountId , customerId , identityPoolId , and userPoolId properties to the new values.
- Load the new password value into the encryptedPassword property. This value is automatically encrypted when you tap Save All .
- Tap Save All , reload the page, then verify that the encryptedPassword property shows a different string enclosed by curly braces. This appearance indicates that the password is properly encrypted and secure.
- Specify the format of the .glb conversion rendition by doing the following in CRXDE Lite :
- Navigate to /libs/settings/dam/v3D/services/dncr in CRXDE Lite .
- Set the outputFormat property to either Dn or generic .When set to Dn , the .glb conversion includes Adobe-specific extensions, such as IBL lighting, for best quality when viewing Dn assets in AEM. However, the converted .glb rendition may not render well in third-party applications.When set to generic , the .glb rendition is generic without Adobe-specific extensions. This setting allows it to be used in third-party applications, while viewing with the AEM 3D viewer will be visually sub-optimal.
- Enable the Dn file format by doing the following in CRXDE Lite :
- Navigate to /libs/settings/dam/v3D/assetTypes/Dn .
- Set the Enabled property to true.
- Validate the configuration by doing the following:
If a "Processing Error" is displayed on the Dn asset in the Card View after 10-15 minutes, the conversion failed.If such case, you can troubleshoot the conversion by doing the following:
- Open AEM Assets.
- Upload logo_sphere.dn to the test3d folder. The file is located in sample-3D-content/models .Note that sample-3D-content.zip was previously downloaded for validating the basic 3D functionality.
- Return to the Card View and observe the message banner shown on the uploaded asset. The Converting Format... banner is displayed while the conversion process is in progress.
- After all processing is complete, open the asset in Detail View to verify that the converted asset is displayed correctly and that the viewer's navigation controls are usable.
- Delete the asset, then upload it again.
- Ensure that you have correctly set all configuration parameters in CRXDE Lite .
- Verify that no firewall is blocking access to the conversion service and AWS endpoints.