You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

Here you can learn how to start Magic Collaboration Studio using the no-installer .zip file.

Prerequisites

To run Magic Collaboration Studio:

  • You must have a working instance of Cassandra. Learn how to install and configure Cassandra.
  • You have to obtain the magic_collaboration_studio_<version_number>_no_install_win64.zip file (the magic_collaboration_studio_190_sp2_no_install_linux64.zip file if you use Linux). Contact your sales executive to get the file.


Running Magic Collaboration Studio on Windows


To run Magic Collaboration Studio by using no-installer

  1. Extract the magic_collaboration_studio_<version_number>_no_install_win64.zip file.

  2. Go to magic_collaboration_studio_no-installer directory/ Open and edit authserver.properties file (magic_collaboration_studio_[version]_no_install_win64\MagicCollaborationStudio\AuthServer\config) and update properties:

    server.public.host
    authentication.redirect.uri.whitelist
    twc.server.host
  3. Run genkey file (magic_collaboration_studio_[version]_no_install_win64\MagicCollaborationStudio\scripts\)
  4. Run certgen file (magic_collaboration_studio_[version]_no_install_win64\MagicCollaborationStudio\WebAppPlatform\bin)

  5. Set JRE_HOME and CATALINA_HOME_WEBAPP variables:

    CATALINA_HOME_WEBAPP=/<WebApp install directory>
    JRE_HOME=/<Java install directory (should be in Webapp folder (WebAppPlatform\jre)- JAVA 11)>

    image2018-11-7_10-35-16.png

  6. Start twcloud.exe (magic_collaboration_studio_[version]_no_install_win64\MagicCollaborationStudio) as Administrator

  7. Start Authserver server - run.bat (magic_collaboration_studio_[version]_no_install_win64\MagicCollaborationStudio\AuthServer\bin) as Administrator
  8. Start tomcat server- startup.bat (magic_collaboration_studio_[version]_no_install_win64\MagicCollaborationStudio\WebAppPlatform\bin) as Administrator

  9. Open a web browser and go to https://localhost:8443/webapp (if default options are used)

    But if you want to run as services:

    1. Run the Teamwork Cloud service installation script -magic_collaboration_studio_[version]_no_install_win64\MagicCollaborationStudio\scripts\windows>installService.bat 

    2. Run the Authserver service installation script - magic_collaboration_studio_[version]_no_install_win64\MagicCollaborationStudio\AuthServer\registerWindowsService.bat

    3. Run the Webapp service installation script - invoke terminal in magic_collaboration_studio_[version]_no_install_win64\MagicCollaborationStudio\WebAppPlatform\bin and run the command:

      service.bat install

Linux

  1. Unzip magic_collaboration_studio_[version]_no_install_win64.zip no install file

  2. Open and edit authserver.properties file (magic_collaboration_studio_[version]_no_install_linux64\MagicCollaborationStudio\AuthServer\config) and update properties:

    server.public.host
    authentication.redirect.uri.whitelist
    twc.server.host
  3. Run genkey file (magic_collaboration_studio_[version]_no_install_linux64\MagicCollaborationStudio\scripts\)
  4. Run certgen file (magic_collaboration_studio_[version]_no_install_linux64\MagicCollaborationStudio\WebAppPlatform\bin)

  5. Set JRE_HOME and CATALINA_HOME_WEBAPP variables:

    CATALINA_HOME_WEBAPP=/<WebApp install directory>
    JRE_HOME=/<Java install directory (should be in Webapp folder (WebAppPlatform\jre)- JAVA 11)>

    How-to set variables:

    1. Open terminal
    2 export JAVA_HOME=magic_collaboration_studio_[version]_no_install_linux64\MagicCollaborationStudio/WebAppPlatform/jre specify your own path
    3. export CATALINA_HOME_WEBAPP=magic_collaboration_studio_[version]_no_install_linux64\MagicCollaborationStudio/WebAppPlatform specify your own path

    To check variable command:

    echo $JRE_HOME

  6. Start twcloud.exe (magic_collaboration_studio_[version]_no_install_linux64\MagicCollaborationStudio)
  7. Start AuthServer server - run.sh (magic_collaboration_studio_[version]_no_install_linux64\MagicCollaborationStudio\AuthServer\bin) 
  8. Start tomcat server - startup.sh (magic_collaboration_studio_[version]_no_install_linux64\MagicCollaborationStudio\bin) 
  9. Open a web browser and go to https://localhost:8443/webapp (if default options are used)


But if you want to run as services:

  1. Run the Teamwork Cloud service installation script -magic_collaboration_studio_[version]_no_install_linux64\MagicCollaborationStudio\scripts\windows>installService.sh
  2. Run the Authserver service installation script - magic_collaboration_studio_[version]_no_install_linux64\MagicCollaborationStudio\AuthServer\registerWindowsService.sh
  3. Run the Webapp service installation script - invoke terminal in magic_collaboration_studio_[version]_no_install_linux64\MagicCollaborationStudio\WebAppPlatform\bin and run the command:


sudo service.sh install