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

Compare with Current View Page History

« Previous Version 9 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>\MagicCollaborationStudio\AuthServer\config and open the authserver.properties file.

  3. Specify the values of the following properties:

    • server.public.host
    • authentication.redirect.uri.whitelist
    • twc.server.host
  4. Save and close the authserver.properties file.
  5. Go to <magic_collaboration_studio_no-installer_directory>\MagicCollaborationStudio\scripts\windows and run the genkey.bat file as administrator.
  6. Go to <magic_collaboration_studio_no-installer_directory>\MagicCollaborationStudio\WebAppPlatform\bin and run the certgen.bat file as administrator.
  7. 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

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

  9. Start Authserver server - run.bat (magic_collaboration_studio_[version]_no_install_win64\MagicCollaborationStudio\AuthServer\bin) as Administrator
  10. Start tomcat server- startup.bat (magic_collaboration_studio_[version]_no_install_win64\MagicCollaborationStudio\WebAppPlatform\bin) as Administrator
  11. 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
    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