3DOrchestrate Installation and Administration

3DOrchestrate Software Components

System Architecture and Deployment

Installation Roadmap

What's New

R2022x FD01 (FP.2205)

R2022x GA

Installation Media for All Simulation Apps and Services

Key Concepts

Installation and System Configuration Considerations

Software Prerequisites

Oracle Database Prerequisites

Java Runtime Environment (JRE) Requirements

Security

Network Communication Protocols

Simulation Licensing and On-Premises vs. Cloud Infrastructure

EU General Data Protection Regulation (GDPR) Compliance

Installing 3DOrchestrate

Installing the 3DOrchestrate Platform Services

Installing the 3DOrchestrate Distribution Server

SMAExeServer.properties File

Deploying 3DOrchestrate in the Java Application Server

Using the Deployment Utility GUI

Running the Deployment Utility from the Command Line

Configuring the 3DOrchestrate Database

Oracle Configuration Options

Configuring Oracle Automatically with the Deployment Utility

Preconfiguring Oracle Manually

Overview: Using a Preconfigured Secure Oracle Database

Creating the Oracle Instance, Tablespace, Schema User, and Tables

Create Database Instance, Tablespace, Schema User, and Tables

Verify that the 3DOrchestrate Database is Configured Correctly

Deploying the Application

Configuring Derby Automatically with the Deployment Utility

Preconfiguring SQL Server Manually

Create the Database

Create the Database User and Grant User Access

Create the Database Tables for the 3DOrchestrate Application

Open TCP Connections on Port 1433

Copy the JBDC Driver and Deploy the Application

Enable Encryption for Data Transfer between 3DOrchestrate and MSSQL Server

Installing and Starting a Public (Regular) Station

Home Directories for 3DOrchestrate

Configuring the Station's Applications in ApplicationInfo.xml

Run-As Security

About Run-As Security

Configuring Run-As Security

Enable Run-As Security in the 3DOrchestrate Distribution Server

Configure Run-As Security on a Windows Station

Configure Run-As Security on a Linux Station (Built-in DRM mode only)

File System Security

File System Security Without Run-As

File System Security With Run-As

Caching Run-As User Credentials

Upgrading to a Hot Fix (Maintenance Release)

Starting and Stopping the 3DOrchestrate Distribution Server

Configuring the 3DOrchestrate Distribution Server as a Windows Service

Checking for Successful Startup

Other Ways to Start the Server

Manually Starting a Public (Regular) Station

Automated Private Station for End Users

Configuring a Private Station on Linux

Configuring a Private Station for Windows Startup

Configuring Private Stations to Work with a Customized HTTPS 3DEXPERIENCE Launcher

Configure Localhost Ports for the Station

Configure Public/Private Key Pair

Verify the Configuration

Configuring Station Properties

About Station Configuration

About Station Affinities

Custom Affinities

Required Affinities

Station Properties File and Startup Command-Line Options

Quick Reference

Affinities

Allowed Users

Cache PLM Files

Client Services (Native apps)

Compute Services (Solvers) Location

Concurrency Limit

Configuration File of Command-Line Options

Configure Station from Group

Exposed IP Address for Remote Physics Visualization

Fast Flow Results Interval

Group Name

JMS Messaging

Large File Working Directory

Lease Interval

Log File Location

Logging Level

Logon Connection Profile

Logon Mode

LSF Error Logs

Maximum Quiescent Time

Name

No GUI

Parameter Match File for Results Analytics App

Port Range

Power’By Services

Predefined OS Commands

Private Station

Results Visualization Engine Location

Reverse Proxy URL

Reverse Proxy Exposed Name

Reverse Proxy Exposed Ports

Run-As Security

Security Domain for Run-As on Windows

Staging Directory

Server Staging Directory

Substation Start Time

Substation Launch Timeout

Substation Keep Alive

Temporary Directory

Temp Directory Skip Lock

Station Administration App

Opening the Station Administration App

User Interface

About the Station Administration User Interface

Server/Station Tree

Properties Panel

Server Administration Commands

Station Administration Commands

Server Administration Command Reference

Station Administration Command Reference

Multi-Selection Menu Commands

Configuring a New Station

Configuring a Group of Stations

Changing Station Configuration Properties

Station Administration Properties Reference

General Tab

Logging Tab

Advanced Tab

Compute Services Tab

Results Services Tab

Configuring Multiple Distribution Servers

Setting the Default Distribution Server for a User

Customization Script for Station Startup

On Windows

On Linux

Setting Excel and Word Options

Set Station Properties for Excel and Word

Replace a Process Level Token

Verify that the Desktop Folder Exists

Set Excel or Word Macro Security

Disable Excel Add-ins

Edit the Windows Registry

Edit User Account Control (UAC)

Create SMAEXE_TEMP Environment Variable

Operating a Public (Regular) Station as a Windows Service

About Using Public (Regular) Stations as a Service

Prerequisite Steps for Running a Public (Regular) Station as a Service

Configuring a Station to Run as a Windows Service

Registering an EER Station as a Windows Service

Starting a Station Running as a Windows Service

Stopping a Station Running as a Windows Service

Unregistering a Station Running as a Service

Distributed Resource Management

About Distributed Resource Management

Built-in DRM

Open DRM

IBM Spectrum LSF DRM

Customizing the 3DOrchestrate-DRM Interface

Scripted Open DRM Customization

About Scripted DRM Customization

Setting Server Properties for DRM Scripts

DRM Script-Based API

Submit Script

Description

Syntax

Return

Example

Kill Script

Description

Syntax

Return

Example

Status Script

Description

Syntax

Return

Example

Java Plug-In DRM Customization

About Java DRM Customization

Setting Server Properties for Java DRM Customization

Writing Your Java Classes

Example Code for DRMEnabler Methods

Accessing Run-As User Credentials in the DRM Enabler Class

Customizing the UI DRM Options for Users

XML Schema Reference for customDRMConfig.xsd

Root Element

Top Level Elements

DRM Custom UI Example

Network Security Configurations

Opening Communication Ports in Your Firewall

Authentication for Forward Proxy Servers

Reverse Proxy Configuration for 3DOrchestrate

Installing HTTPS Certificates in 3DOrchestrate

Results Analytics and File Monitoring Services

Results Analytics Servant and File Monitoring Services on Stations

Configuring Stations for Results Analytics and File Monitoring

Public (Regular) Stations outside the Reverse Proxy Server

Private (Local) Stations outside the Reverse Proxy Server

Public (Regular) Stations behind the Reverse Proxy Server

Advanced Settings for Masking the Station Proxy URL

Mask the Station URL with an Alias

Mask the Station Ports with an Alias

Mask the Station URL and Ports

Changing Public Stations from HTTP to HTTPS

3DOrchestrate Checker

About the 3DOrchestrate Checker

Verifying the Java Store Certificate

Verify a Series of 3DEXPERIENCE Servers Automatically

Verify SSL Certificates For a Single Station or Server

Load Balancing

Load Balancing in a 3DOrchestrate Cluster

Steps for Configuring a Cluster

Shared Network Disk Space

Cluster Operation

Configuring the Cluster

Configuring the JDBC Database Connection

Registering the Reverse Proxy, Load Balancer, and ActiveMQ Brokers

Registering, Deploying, and Configuring the 3DOrchestrate Servers

Starting and Stopping the ActiveMQ Brokers and 3DOrchestrate Servers

Start or Stop an ActiveMQ Broker

Start or Stop a Cluster 3DOrchestrate Server

Configuring a Station for Remote Execution of Physics Solvers and Visualization

Configure the Compute Services (Abaqus Solvers) for Remote Execution

Configure the Physics Results Engine for Remote Postprocessing

Configuring a Detached Controller Host for Remote Postprocessing

Physics Simulation Remote Execution with Open DRM and HPC

Physics Execution Workflow with Open DRM and Detached Controller Host

Configuring a Detached Controller Host Station

Sizing Considerations for a Detached Controller Host

Custom File Transfer Script

Adjusting JVM Memory/Performance Settings

Overview of JVM Performance Ergonomics

JVM Settings for 3DOrchestrate Station

JVM Settings for 3DOrchestrate Distribution Server Configured by TomEE CATALINA Scripts

JVM Settings for 3DOrchestrate Distribution Server Configured as a Windows Service