Preparing to Install the Hot Fixes

This section describes the steps to perform before installing HFs.

  1. Take into account the specific details regarding backup for each of the 3DEXPERIENCE platform services.

    The details are summarized in the table below:

    Service Data to be backed up Installation Folder Databases Configuration Files Deployed application folder

    3DPassport

    		No specific data to back up

    Installation folder filled during installation to be backed up

    Databases filled during installation to be backed up

    Configuration files modified after the installation to be backed up

    Deployed application folder should be backed up

    3DDashboard

    		shared folder should be backed up

    3DSearch

    		No specific data to back up

    3DSpace

    		File Collaboration Server (FCS) files

    3DSpace Index

    		Indexes

    3D Indexing Serverfor building 2D/3D thumbnails)

    		shared folder should be backed up

    3DSwym

    		shared folder should be backed up

    3DSwym Video Converter

    No specific data to back up

    3DSwym Index

    Indexes

    3DComment

    		shared folder should be backed up

    3DNotification

    		shared folder should be backed up

    Reverse proxy and load balancer

    		No specific data to back up

  2. We strongly recommend that you shut down all application servers and databases.
  3. Back up installation folders along with databases.

    Back up data for all services except 3DSpace Index and 3DSwym Index . The shared directories are:

    Shared directories for each impacted service/component Compact deployment Separated deployment

    Shared data directories

    3DDashboard services

    3DDashboard data path

    3DSpace services

    		N/A

    FCS service

    3DSpace data path

    3D Indexing Serverfor building 2D/3D thumbnails)

    3D Indexing Server data path

    All 3DSwym services

    3DSwym data path

    3DComment services

    3DComment data path

    3DNotification services

    3DNotification data path

    Shared configuration directory (optional) Compact deployment Separated deployment
    Shared Configuration Path

    All services including reverse proxy and load balancer

    		certificate (.cer (or .crt))
    cypher key for 3DPassport
    TNSNames.ora directory

    Compact and Separated Deployment are described in Installation and Setup: Install: 3DEXPERIENCE Platform: 3DEXPERIENCE Platform Installation Roadmap: Overview.

  4. Back up the deployed folders and war exploded files if the deployment was done using an external TomEE.
  5. Back up any configuration files you modified.

    After the 3DEXPERIENCE platform installation, you may have configured or customized the platform by modifying Dassault Systèmes files in the service installation directory or directly in the deployed service folder in the application server.

    These files should be listed, and backed up as they may be updated by a HF installation.

  6. Backup data for EXALEAD-based services (3DSpace Index).
    1. Go to the <INSTALLDIR>\advancedsearch\<OS>\cv\data directory.
    2. Freeze all services using the master freeze method:

      cvcommand <HOSTNAME>:<BASEPORT+11> /mami /master freeze

      While in freeze mode:

      • all push operations are suspended
      • no indexing jobs are created
      • trigger job conditions are ignored.

    3. Verify that processes are disabled using:

      cvcommand <HOSTNAME>:<BASEPORT+11> /mami /indexing getBuildGroupStatus buildGroup =<BUILDGROUP>

    4. Check that the following are set to enabled="false":

      • PushServerStatus
      • AnalysisStatus
      • ImportStatus

    5. On all hosts, copy the <INSTALLDIR>\<OS>\cv\data from your product installation. You can also copy the <INSTALLDIR> if patches were applied.
    6. To reduce disk copy time, do not copy the <INSTALLDIR>\<OS>\cv\data\run folder (containing logs).
    7. Unfreeze the services using the master unfreeze method:

      cvcommand <HOSTNAME>:<BASEPORT+11> /mami /master unfreeze

      For more information about backups for 3DSpace Index, see Installation and Setup: 3DEXPERIENCE Platform: 3DEXPERIENCE Platform Administration: 3DSpace: 3DSpace Index: Monitoring and Maintaining the CloudView Server: Backing up and Restoring Data.