Enterprise software conjures up collaboration and that requires direct coordination. If you have ever worried about changing your Teamcenter system configuration, a Version Control System such as Git Hub is a great tool to alleviate your fear. <\/p>\n\n\n\n
How is it done?<\/p>\n\n\n\n
![\"\"](\"https:\/\/blogs.sw.siemens.com\/wp-content\/uploads\/sites\/14\/2023\/02\/paul-eric-vcs-server-1024x828.png\")
<\/figure>\n<\/div>\n<\/div>\n\n\n\nA proper setup of version control system or VCS, also known as source code management or SCM, maintains a master copy of data in a centralized database. Now you can update the configuration of applications in a controlled manner. <\/p>\n\n\n\n
This enables various contributors to:<\/p>\n\n\n\n
- \n
- Pull the latest information from the central server<\/li>\n\n\n\n
- Modify any work as neccessary<\/li>\n\n\n\n
- Validate the changes are working and ensure you are not creating more issues<\/li>\n\n\n\n
- Commit changes back into the central repository<\/li>\n<\/ul>\n\n\n\n<\/div>\n\n\n\n
Before continuing, ensure you have a good foundation of VCS, fetching remote repository contents, committing and pushing changes.<\/p>\n\n\n\n
<\/div>\n\n\n\nTeamcenter configuration with Version control system<\/h2>\n\n\n\n
<\/div>\n\n\n\nLet\u2019s now focus on a Teamcenter configuration.<\/p>\n\n\n\n
<\/div>\n\n\n\nIt\u2019s made of preferences, workflows, queries and stylesheets affecting the user interface and configurations for the Active Workspace Client. It’s now possible to manage all of your information in files. Teamcenter utilities exist to export and import preferences, files or workflows. For example, relying on an import script to synchronize contents in a reproducible manner. That import script is up to you, it is your recipe! However, it should include instructions for each and every configuration item you plan to manage. Be aware many utilities require a 2-Tier RAC client to run, so make provisions to access a host when considering managing configurations.<\/p>\n\n\n\n
<\/div>\n\n\n\nLet\u2019s take a break from the nuts and bolts and get an overall view of the process:<\/p>\n\n\n\n
<\/div>\n\n\n\n![\"\"](\"https:\/\/blogs.sw.siemens.com\/wp-content\/uploads\/sites\/14\/2023\/02\/paul-eric-close-loop-1024x409.jpg\")
<\/figure>\n\n\n\n<\/div>\n\n\n\nThe above process starts with an initiator, recognizing \u201csomething\u201d needs to be done. Instructions are shared to an assigned resource, who will:<\/p>\n\n\n\n
<\/div>\n\n\n\n- \n
- Fetch the latest configuration definition from the central VCS repository<\/li>\n\n\n\n
- Perform changes to configuration<\/li>\n\n\n\n
- Test them locally on a test server away from production and once deemed satisfying requirements (this step often includes a group review)<\/li>\n\n\n\n
- Commit to changes so the initiator can assess the changes have been made to standard<\/li>\n<\/ul>\n\n\n\n<\/div>\n\n\n\n
Independently, users can rely on VCS features to report changes.<\/p>\n\n\n\n
<\/div>\n\n\n\nTeamcenter configuration artifacts:<\/h2>\n\n\n\n
<\/div>\n\n\n\nRely on Teamcenter utilities to extract existing configuration information:<\/p>\n\n\n\n
<\/div>\n\n\n\nArtifact<\/strong><\/td> Utility<\/strong><\/td> Outcome<\/strong><\/td><\/tr> Tc Reports<\/strong><\/td> import_export_reports –export<\/strong><\/td> Generates a new folder named after the reportId parameter<\/td><\/tr> Preferences<\/strong><\/td> preferences_manager (\u2026) -mode=export<\/strong><\/td> Exports preferences<\/td><\/tr> Queries<\/strong><\/td> plmxml_export (\u2026) -query=query_name<\/em><\/td> Exports a query named query_name<\/em><\/td><\/tr> Workflow templates<\/strong><\/td> plmxml_export (\u2026) -template=template_name<\/em><\/td> Exports a workflow template named template_name<\/em><\/td><\/tr> AWC UI Configurations<\/strong><\/td> export_uiconfig<\/td> Exports the AWC UI configuration file<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n <\/div>\n\n\n\nExpress these artifacts on a local host and push them into a remote repository using VCS-specific instructions, such as “git commit.” Prioritize these rules to maintain a reliable set of configurations should an unfortunate event occur (i.e., a user changes a workflow template on your server, without proper backup in place).<\/p>\n\n\n\n
<\/div>\n\n\n\nEstablish a baseline configuration of Teamcenter on your VCS. Start planning configuration changes with confidence. Rely on any trick related to VCS \u2013 branching, checkout, tagging \u2013 to document changes and ensuring you have a safety net, limiting business interruption. Mark configuration changes such as \u201cInitial Configuration\u201d, then as business needs require it \u2013 \u201cAdd comments on Part Summary stylesheet\u201d, \u201cChange to workflow to add release review\u201d and \u201cFix to PDF generation.”<\/p>\n\n\n\n
<\/div>\n\n\n\nImporting contents<\/h2>\n\n\n\n
<\/div>\n\n\n\nWhen importing configuration changes in your test virtual machine or a Tc server, you\u2019ll use the corresponding set of utilities with arguments supporting an import.<\/p>\n\n\n\n
<\/div>\n\n\n\nCreate a script listing all your instructions to organize your process. Include that script in your VCS repository, so you or a colleague can optimally replay the process with minimal supervision. <\/p>\n\n\n\n
<\/div>\n\n\n\nExamine this snippet of a set of instructions:<\/p>\n\n\n\n
(\u2026)<\/p>\n\n\n\n
echo ########## Loading AWC Stylesheet Preferences #################<\/code><\/p>\n\n\n\npreferences_manager -u=adm_user<\/em> -p=adm_passwd<\/em> -g=adm_group<\/em> -mode=import -action=OVERRIDE -scope=site -file=Stylesheets\\import_prefs.xml<\/code><\/p>\n\n\n\necho ######### Importing uiconfig file #########<\/code><\/p>\n\n\n\nimport_uiconfig -u=adm_user<\/em> -p=adm_passwd<\/em> -g=adm_group<\/em> -file=AWC\/uiconfig.xml<\/code><\/p>\n\n\n\necho ######### BOM Report #########<\/code><\/p>\n\n\n\nimport_export_reports.exe -import -u=adm_user<\/em> -p=adm_passwd<\/em> -g=adm_group<\/em> -stageDir=\"Reports\" -reportId=\"PS-BOMStruct\" -overwrite<\/code><\/p>\n\n\n\n(\u2026)<\/p>\n\n\n\n
<\/div>\n\n\n\nRun that import script to populate your Teamcenter environment with the configuration.<\/p>\n\n\n\n
<\/div>\n\n\n\nSynchronizing contents across environments<\/h2>\n\n\n\n
<\/div>\n\n\n\nCreate a process that takes configuration changes from a development environment onto a test environment. If needed, into a production environment passing through a staging setup.<\/p>\n\n\n\n
<\/div>\n\n\n\nConsider the following setup, where a developer receives a work order and pulls contents from the VCS server and updates it. Once done, it\u2019s committed to the VCS server and changes are propagated to a Test machine. A validation could indicate further work is needed, so a request is sent to development, with changes. Work continues and code is pushed again so tests can proceed. Eventually, you go to deploying a configuration on a production server.<\/p>\n\n\n\n
<\/div>\n\n\n\n![\"\"](\"https:\/\/blogs.sw.siemens.com\/wp-content\/uploads\/sites\/14\/2023\/02\/paul-eric-uml-sequence.jpg\")
Figure 2 Propagation of changes across Teamcenter environments.<\/figcaption><\/figure>\n\n\n\n <\/div>\n\n\n\nMany sites might not need a staging server setup, at which point your test resources would be the last stop before considering deploying the configuration in production.<\/p>\n\n\n\n
<\/div>\n\n\n\nTips:<\/h3>\n\n\n\n
- \n
- Use your favorite text editor to modify stylesheets, reports, AWC UI configuration files
- Stylesheets are best exported or downloaded through RAC or AWC<\/li><\/ul>\n
- \n
- Stored as dataset: exporting out of Tc allows you to edit them in a rich text editor<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- Avoid modifying a workflow through its file!\n
- \n
- Edit it exclusively through the Workflow Designer, as all tasks and their relationships are resolved dynamically<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- Queries are best edited through the Query Editor: a counter ensures all properties are accounted accurately<\/li>\n<\/ul>\n\n\n\n<\/div>\n\n\n\n
What\u2019s next?<\/h2>\n\n\n\n
<\/div>\n\n\n\nHow about <\/strong>branching, merging, tags?<\/p>\n\n\n\n
<\/div>\n\n\n\nThese are specifically VCS activities, that know-how is a pre-requisite to maintaining your configuration information.<\/p>\n\n\n\n
<\/div>\n\n\n\nAnd what about Continuous Integration, Continuous Deployment?<\/p>\n\n\n\n
<\/div>\n\n\n\nThis is a bit trickier; it involves stopping Teamcenter services and processes and is more involving. Siemens offers services engagement to support this activity.<\/p>\n\n\n\n
<\/div>\n\n\n\nIn summary<\/h2>\n\n\n\n
<\/div>\n\n\n\n- \n
- There are utilities that allow import and export of preferences, reports and other configuration artifacts<\/li>\n\n\n\n
- Queries and workflows can only be edited within RAC or AWC<\/li>\n\n\n\n
- Some artifacts can\u2019t be exported or don\u2019t have a command-line utility<\/li>\n<\/ul>\n\n\n\n<\/div>\n\n\n\n
- Stylesheets are best exported or downloaded through RAC or AWC<\/li><\/ul>\n
- Use your favorite text editor to modify stylesheets, reports, AWC UI configuration files