Quick Deploy XML for Realize LIVE 2022 Session

WELCOME
Join the transformation
Las Vegas, May 9-12, 2022

REALIZE LIVE 2022
Quick Deployments

Agenda
In this session, you will learn how to build a Quick Deploy XML for Deployment
Center. And to validate your XML using an XSD to reduce the number of iterations.
Ensuring you have no errors, find syntax errors, or even identify a severe error,
usually with a recommendation on how to fix it!
• A Quick Deploy XML can be used to create and install a new environment in DC.
• Validate the XML using an XSD before running it.
• Reduce the number of iterations while building the XML.
A complete method.

Presenters
Randy
Ellsworth

Why Quick Deploy?
Show of Hands...
Who has used Deployment Center?

Why Deployment Center? Why Quick Deploy?
Deployment Center is a centralized web application for deploying software to Teamcenter environments, both servers
and clients. It simplifies the process of installing and updating software and automates deployment. You can manage a
variety of Teamcenter environments more efficiently.
Download software packages to a central location, set up your installation or update in Deployment Center, and
generate deployment scripts. Run the scripts on target machines that access and install the software.
Benefits
• Deploy, manage, and maintain multiple versions of software in multiple Teamcenter environments from a single web
application with authenticated user access.
• Reduce the costs of managing Teamcenter environments by reducing the number of steps and time involved in
software deployment.
• Provide a centralized location to create and view Teamcenter environments and view deployment information.
• Ensure consistency and accuracy by reviewing and adjusting deployment configuration before rollout to Teamcenter
environments.
• When setting up your environment, take advantage of entering parameters for one component and having those
values shared with related components. For example, when you enter a machine name or port number for a
component, that information is shared with other components that require the same information.

Environments: All-in-One, Single Server, or Distributed?
Deployment Reference Architecture
https://support.sw.siemens.com/en-
US/product/282219420/download/
PL20211204580108043

Teamcenter Deployment Reference Architecture Sample QD Files
Quick Deploy configurations are provided for both wntx64 and lnx64

Download a OpenJDK
Download Azul Zulu Builds of JRE (optionally, JDK)
https://www.azul.com/downloads/?version=java-11-lts&os=windows&architecture=x86-64-bit&package=jre
1 2 3
4

Install OpenJDK
Install Azul Zulu 11 and set JAVA_HOME
In the Custom Setup dialog, Click Set JAVA_HOME variable and select Entire feature will be installed on
local hard drive then click Next and Install.
1
2
3
4
C:Program FilesZulu

Installing Deployment Center
Show of Hands...
Who has installed Deployment Center?

Stage the Software
Download and extract DeploymentCenter_4.2.1 to C:Temp
https://support.sw.siemens.com/en-
US/product/282219420/download/
PL20220314275597017
1
2
3
4

Launch a Command Prompt
Run as administrator
Run an “Administrator: Command Prompt” and view the utility Help

Open the Installer Config File
Open in your
favorite editor
Open C:TempDeploymentCenter_4.2.1deployment_centerinstall_config.properties

the password must not contain any of the following
characters: ! @ $ % = & ' " ^ : ; . _ < > ( ) { }
Generate Encrypted Passwords
Best Practice: Use encrypted passwords
cd /d C:TempDeploymentCenter_4.2.1deployment_center
dc_encrypt.bat -password=dcadmin
Cleartext password
14pXjKcFG8CIrbjdy1teV5JWJY/aVc7tj6BgDCQ3
abiAJjZ4GWdFbV3MI0e+jSPhN2R+W6RPS/dd3
YxENZFX/A==
dc_encrypt.bat -password=dcadmin -file=dc.pwf
Save for later
SHA256

Zulu-11 JDK versus Zulu-11 JRE
JDK Fix - C:TempDeploymentCenter_4.2.1deployment_centerdc_encrypt.bat
if not exist "%JAVA_HOME%jre"
Add quotes
C:Program FilesZulu
JRE
JDK

Edit Install Config
Edit install_config.properties and Save As acme_install_config.properties
enableSoftwareAnalytics=No
serverDir=C:SiemensDCwebserver
serverPort=8180
serviceName=Teamcenter_DC_Service
repoDir=C:SiemensDCrepository
repoPort=8190
repoServiceName=Teamcenter_DC_RepoService
repoPublisherPort=8181
repoSubscriberPort=61616
user=dcadmin
password=14pXjKcFG8CIrbjdy1teV5JWJY...
useEncryptedPassword=true
useHttpsCommunication=false

Install Deployment Center
Run the installer using the config file
deployment_center.bat -install -inputFile=.acme_install_config.properties

Validate the Installation
http://localhost:8180/deploymentcenter/

Tour the Installation
Post repository tasks
repositorysystemdeployer
C:SiemensDC
Teamcenter_DC_ReportService Manages scanning of software
Teamcenter_DC_ReportService_Publisher Watches for new software to scan
Teamcenter_DC_Service Runs DC web app

Populate the Repo
Add software to the repository
repository repositorysoftware webserverrepotoollogs

Generate Software Configuration Report
Generate a Software Configuration Report for the software in the repository
1
2
3 4

Backup the Installation
Backup and Recovery
webserverdb repository
Software must be
recovered to the
same location

Install Quick Deploy
Extract to DC_ROOT
webserveradditional_tools
C:SiemensDC

Building the Quick Deploy XML
Show of Hands...
Has anyone customized a Quick Deploy XML?

Export Full versus Export Lean
Export the XML from the DC UI or using the QD utility
dc_quick_deploy.bat
-dcurl=http://acme:8180/deploymentcenter/
-mode=export
-environment=TC4ACME
-exportType=Full (or Lean)
-exportFile=.acme_quick_deploy.xml
-dcusername=dcadmin
-dcpasswordFile=.dc.pwf
Full Export
or
Lean Export
Rename the export file after export from the DC UI to avoid overwriting. Warning! Passwords are not exported.

Validate the Install Path
DC 4.2 now includes an Install Path column

Export the Environment
Export a QD XML from the DC UI
1
2
3 4
Rename the file after export from the DC UI to avoid overwriting. Passwords are not exported.

Remember the Encrypted Passwords!
Best practice: Use encrypted passwords in your QD XML
dc_quick_deploy.bat -encrypt=ospassword
Cleartext
Passwords are always encrypted in the DC database.
Encrypted : true
Encrypted : false
DC now supports HTTPS!

Review the XML File
Exported Quick Deploy XML

Software Configuration Reports
Configuration Report for Active Workspace 6.0.1
• Teamcenter_ActiveWorkspace_6.0.1.html
• Teamcenter_ActiveWorkspace_6.0.html
• Teamcenter_Foundation_13.3.html
• Teamcenter_Foundation_13.html
• Teamcenter_Foundation_14.0.html
• Teamcenter_MicroServiceFramework_6.0.1.html

Review the Software Configuration Report
Media Information, List of Applications, List of Components, ConnectedTo
Teamcenter_ActiveWorkspace_6.0.html

Building the Configuration
quickDeployConfig, archType, quickDeploySoftware, and quickDeployClients

Install BMIDE
Business Modeler IDE Standalone

BMIDE Component in QD XML
Component for BMIDE

Mass Deploy TCCS
Mass Deploy for TCCS-Only
LB
LB
FO

Mass Deploy TCCS in QD XML
Mass Deploy for TCCS-Only with Fail-Over and Load Balancing
LB
LB
FO

Install the Rich Application Client
Install a 4tRAC or 2tRAC, combined 2t4tRAC is not supported in DC.
Same Machine Name
Same Machine Name
1
2
3

Mass Deploy 4tRAC
Mass Deploy for 4tRAC

Mass Deploy 4tRAC in QD XML
Mass Deploy for 4tRAC

Mass Deploy BMIDE
Mass Deploy for BMIDE

Mass Deploy BMIDE in QD XML
Mass Deploy for BMIDE

Validating an XML
Show of Hands...
Has anyone validated an XML using an XSD?

How do I find the XSD?
Drag and Drop
C:SiemensDCwebserverwebserverjetty_9.4.43webappsdeploymentcenter.war
WEB-INFlibdc_quick_deployjarcom.dc.common.jar
comsiemensdeploymentcentermodelquickdeployschemadc-quickdeploy.xsd
C:SiemensDCdc_quick_deploy

A quick look at dc-quickdeploy.xsd
Use this XSD to validate that your XML is well-formed and will not cause issues in DC.
High level process...
• Open Plugins Admin and Install XML Tools in Notepad++.
• Open the XML document that you want to validate.
• Click on the Plugins > XML Tools > Validate Now option.
• Browse and select an XSD file to validate the XML.

Install the XML Tools Plugin
Launch Notepad++, click Plugins and Plugins Admin..., click XML Tools and Install
1
2
3
4
5

Validate the XML
Open the XML document that you want to validate. Click Plugins, XML Tools and Validate Now
1
2
3

Select the XSD
Select dc-quickdeploy.xsd and click OK.
1
2

Error Detection
You will either get “No errors detected.”
Or a syntax error (missing closing bracket).

Severe Error with Recommendation!
Or a more severe error with a suggestion on how to fix it!

Create an Environment
Show of Hands...
Has anyone used a Quick Deploy XML to create an environment?

Iterate Template Version in DC
Iterate the software version before adding package to the DC repo
Iterate!
Build version is optional
template-internal-name_OS_template-version_build-version_YYYY_MM_DD_HH-MM-SS

Validate DC Command Line Switches
Review QD help
dc_quick_deploy

Create an Environment in DC and Build Scripts
Run QD using the XML
dc_quick_deploy.bat
-dcurl=http://acme.com:8180/deploymentcenter/
-environment=TC4ACME
-inputFile=.acme_quick_deploy.xml
-dcusername=dcadmin
-dcpasswordFile=.dc.pwf
repositorydeploy_scripts
skipScriptGeneration

Deploy the New Environment
Copy and unzip the deploy package locally before running
deploy.bat
-dcusername=dcadmin
-dcpasswordFile=Z:dc_quick_deploydc.pwf
-softwareLocation=Z:repositorysoftware
-diagnosticChecks
deploy.bat
-dcusername=dcadmin
-dcpasswordFile=Z:dc_quick_deploydc.pwf
-softwareLocation=Z:repositorysoftware
Fix issues
E:Tempdeploy_ACMECORP1

Troubleshoot the Deployment
See logsdeployer_timestamp.log, section Diagnostic Checks Detail
logs
Check directories...
• TC_ROOTlogs
• TEMP

What’s Next...
Show of Hands...
Has anyone automated their deployment process?

What are my next steps?
CI/CD
Orchestration
Mass Client Deploys
Software
Configuration Report
Patch Upgrade
send_configuration_to_dc
Install
Andrew Blainey (andrew.blainey@siemens.com)

THE TIME IS NOW
Accelerate your journey by leveraging the Quick Deploy XML

Quick Deploy XML for Realize LIVE 2022 Session

Empfohlen

Empfohlen

Weitere ähnliche Inhalte

Ähnlich wie Quick Deploy XML for Realize LIVE 2022 Session

Ähnlich wie Quick Deploy XML for Realize LIVE 2022 Session (20)

Kürzlich hochgeladen

Kürzlich hochgeladen (20)

Quick Deploy XML for Realize LIVE 2022 Session

Hinweis der Redaktion