Upgrade installation

You can upgrade your existing CADMATIC Plant/Outfitting installation to a newer version.

Note: These instructions are for upgrading from version 6.0.7 or newer to the latest version. If your current version is older than 6.0.7, you must first upgrade to 6.0.7. If the P&ID application is used, an intermediate upgrade to 6.1.4 is also required.

• Upgrade installation
  • Downloading the new version
  • Preparations before upgrading
  • Upgrading the license server and updating license files
  • Upgrading COS servers
  • Installing the new version of applications
  • Converting projects
  • User areas after update
  • Profiles to be updated
  • Upgrading Plant Modeller Services
  • Upgrading eBrowser
  • Upgrading eShare

Downloading the new version

Log in at https://support.cadmatic.com/, browse to Downloads > DesignApplications, and download the latest installation media from the Marine or Plant folder, as appropriate.

Preparations before upgrading

Before starting the upgrade process, do the following.

• Ask all users to save and check in model objects. Drawings may remain checked out to users, and temporary spool attribute objects may remain owned by Plant Modeller areas even after checking in all objects—this is normal and does not prevent the upgrade.

• At each replica site:

  • Verify that all library and project database configuration objects are located at the master site and not owned by the replica.

  • Verify that the replica server has received the latest COS update. All COS servers must include the same information.

  • Create a COS backup in the Backup settings and save the backup in a secure location in case it is needed after the upgrade.

• At the master site

  • Verify that all configuration object ownerships have been received from replica servers.

  • Verify that all relevant objects in the library and project databases have been checked in by replica servers. DO NOT use Force cancel check-out or Take All.

    

  • Exit all Plant Modeller areas.

  • Create a COS backup in the Backup settings and save the backup in a secure location in case it is needed after the upgrade.

  • Set replica servers offline in the Replication settings.

    

Upgrading the license server and updating license files

Upgrade the license server as described in the CADMATIC License Server manual and renew licenses if necessary.

• Check that your license file is compatible with the software version. The version number is included in the license file name, which follows this format: <name>_<id>.<release>-<startdate>-<enddate>.lcf.cry. The license server of the latest release can be used for applications from version 5.0 onward.

• Uninstall the license server via Control Panel > Programs and Features.
• Start the license server installation from the installation media and follow the instructions.

For more information on licensing, see the CADMATIC License Server manual in docs.cadmatic.com.

Upgrading COS servers

Upgrade the required COS servers to the new software version. If multiple projects share the same COS server, all projects must be upgraded at the same time.

• From the installer, select the Install/upgrade COS server option, click Next, and follow the instructions.

  

• If upgrading from a 32-bit to a 64-bit COS server, you will be prompted that the entire replica network must be upgraded. Do not proceed unless you are certain.

  

• Do not disturb the COS server during conversion, as this may cause it to stop prematurely.

• Allow time for the COS server to convert, even if the program indicates that the conversion is complete.

• Check the COS server folder to confirm that the temporary db.uc catalog has been automatically deleted.

• Check the COS server log to confirm that it includes the line 'Database format conversion succeeded.'.

• Check the COS server log to confirm that the server is running. You can start and stop the server to verify it remains operational on the new version.

• Once COS servers are successfully upgraded at both master and replica sites, set the replicas online again, or in case of offline replication, send an update from the offline replica.

Installing the new version of applications

• Start the installation media for the latest version and select the components to install.

  

  

• Install the program folders to your preferred server or workstation location (default path: C:\Cadmatic). The new main version will be installed in parallel with any existing version.

• Select the default workstation profile or select your existing profile. Profiles must be updated.

• After installation, verify that the correct profile is in use so all users access the new version. Disable the old profile by renaming it, if it is no longer needed.

• If you have custom files in your program, merge your changes into the new files.

Converting projects

Before converting projects to the new version, check that Security Policies allow the system administrator to perform project conversion.

• Convert the project and library at the master site.

• Convert the project and library at replica sites. If a replica site is offline, the system will notify you. Selecting OK will complete the conversion.

User areas after update

• Verify that the area path points to the correct location.

• When users first start their areas, they are prompted to rebuild the model from MDL or from COS. Both options can be selected, but if unsure, choose Re-build area via COS update.

Profiles to be updated

Profile files do not need to be updated by default, but ensure they are linked to the latest version.

• PmArea.prf

• Component Manager PmGuest.prf

• Pipe.prf

• DmTools.prf

• Hull Agent PmTool.prf

Upgrading Plant Modeller Services

1. Run the version-specific Plant Service Installer from Start > CADMATIC or Start > CADMATIC Outfitting.

   

2. In the Installed Plant Modeller Services dialog, select Upgrade. The Upgrade Service dialog opens.

   

3. Select the configuration directory and workstation profile corresponding to the correct CADMATIC version.

   Once the new version is set, all hosted Service Instances are upgraded automatically.

Upgrading eBrowser

• Uninstall the old version (if it is older than 2014Q1) using Control Panel > Programs and Features.

• Install the new version from the installation media.

Upgrading eShare

• Install the new version from the eShare installation media.

• When upgrading the 3D Component on client computers, users may need to close the web browser on even end the browser process via Task Manager.

• Users may need to clear their browser cache.