On this page

You can migrate document URLs from Cameo Collaborator for Alfresco to Cameo Collaborator for Teamwork Cloud by redirecting the URLs from one environment to another. This allows you to open documents in Cameo Collaborator for Teamwork Cloud using Cameo Collaborator for Alfresco document links. As the result, you will not have to change the document links shared with your teams, customers, or stakeholders.

Prerequisites

  • Make sure that in Cameo Collaborator for Alfresco you use original document names. If any of the documents have been renamed, change their names back to originals (they can be seen in title bar of an open document).
  • Contact your sales representative to obtain the share-<version_number>.war file.


Preparing for migration

Before starting to migrate document URLs, modify modeling tool properties and publish related models to Cameo Collaborator for Teamwork Cloud as described below.


To prepare for migrating document URLs


  1. Go t<modeling tool installation directory>\bin and open the properties file (e.g., magicdraw.properties).
  2. Add the following property to the the JAVA_ARGS line:

    -Dcc.document.migration.enable=true
  3. Save and close the properties file
  4. Publish all the documents, the URLs of which you wan to migrate, to Cameo Collaborator for TWC. When publishing, make sure that you specify the same document names and templates that are used in the Alfresco server.


Migrating document URLs

Once you prepare for migration, follow the steps below to migrate document URLs from the Alfresco server to Cameo Collaborator for Teamwork Cloud.


To migrate document URLs from the Alfresco server


  1. Create the .json file containing the published model information of a specific Alfresco server:
    1. Open a web browser and go to http://<cc_for_alfresco_host>:<cc_for_alfresco_port>/alfresco/s/nm/documentsInfo
    2. Copy all the text in the website and paste it to a plain text editor.
    3. Save the plain text editor file with the .json extension.
  2. Use a plain text editor to create the share.properties file.
  3. In the share.properties file, specify the following properties:

    #Specify the Cameo Collaborator for Teamwork Cloud domain name.
    webapp.url=http://<cc_for_twc_host>:<cc_for_twc_port>
    
    #Specify the path to the .json file containing the published model information of a specific Alfresco server.
    #For example, alfresco.document.info.file=C\:\\Users\\john\\Documents\\URLmigration\\documentsInfo190.json on Windows
    #and alfresco.document.info.file=//home//alfresco_documentsInfo.json on Linux.
    #If you need to include more then one file, separate file paths with semicolons (;).
    alfresco.document.info.file=<full_path_to_json_file>
    
    #Specify the cache for Teamwork Cloud data requests.
    twc.cache.specification=initialCapacity=10,maximumSize=100,expireAfterAccess=30m,expireAfterWrite=30m
  4. Place the share.properties file into the location that is on the classpath of the web application server the Web Application Platform runs on.

    Example

    If Web Application Platform runs on Apache Tomcat 8.0 or above, you can choose from the following options (refer to server documentation for all available options):

    • Place the share.properties file in the <tomcat_home>/shared/conf directory. Then open the <tomcat_home>/conf/catalina.properties file and set the shared.loader property as shared.loader="<catalina_base>/shared/conf".
    • Place the share.properties file in a custom directory. Add the path to the directory to the list of shared classloader paths defined by the "shared.loader" property in the ${tomcat.home}/conf/catalina.properties file. 

    If a different web application server is used, refer to its user manual.

  5. Rename the share-<version_number>.war file to share.war.
  6. Deploy the share.war file on the web application server where Web Application Platform is deployed (e.g., C:\Program Files\No Magic Web App Platform\apache-tomcat\webapps).
  7. Restart the web container.
  8. Redirect the Alfresco domain address (http://<cc_for_alfresco_host>:<cc_for_alfresco_port>/alfresco) to the Cameo Collaborator for teamwork Cloud server.


After finishing migration, redirect all calls from the Alfresco server to Cameo Collaborator for Teamwork Cloud and check if the migrated links work. To get the link that opens a document in Cameo Collaborator for TWC, replace the host name and port of the Alfresco document link with the host name and port of the Cameo Collaborator for TWC environment.


Post-migration recommendations

After you finish migrating document URLs and make sure that they work, complete the steps below to increase the publishing speed.


To increase the publishing speed after URL migration


  1. Go to <modeling tool installation directory>\bin and open the properties file (e.g., magicdraw.properties).
  2. Remove the -Dcc.document.migration.enable=true proeprty from the JAVA_ARGS line.

  3. Save and close the properties file.

Related pages