Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Warning
titlePrerequisites

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.

...

  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. Specify CATALINA_HOME_WEBAPP and JRE_HOME variables the following way:

    Set JRE_HOME and
    1. Open Control Panel and go to System and Security > System.
    2. Select the Advanced system settings option on the left side of the System dialog.
    3. In the System Properties dialog, click the Environment Variables button.
    4. In the System variables area of the Environment Variables dialog, specify the values for the JRE_HOME and 

    1. CATALINA_HOME_WEBAPP variables as shown below:

      Code Block
      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.pngImage Removed

    Start twcloud.exe (magic
    1. <magic_collaboration_studio
    _[version]
    1. _no
    _install_win64\MagicCollaborationStudio) as Administrator
  8. Start Authserver server - run.bat (magic_collaboration_studio_[version]_no_install_win64\MagicCollaborationStudio\AuthServer\bin) as Administrator
  9. Start tomcat server- startup.bat (magic
    1. -installer_directory>\MagicCollaborationStudio\WebAppPlatform
      JRE_HOME=/<magic_collaboration_studio
    _[version]
    1. _no-installer_
    install_win64
    1. directory>\MagicCollaborationStudio\WebAppPlatform\
    bin) as Administrator

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

    1. jre


    2. Click OK.

  10. Go to <

    But if you want to run as services:

    Run the Teamwork Cloud service installation script -magic_collaboration_studio_[version]_no-installer_install_win64directory>\MagicCollaborationStudio\scripts\windows>installService.bat windows and run the genkey.bat file as administrator.
  11. Run the Authserver service installation script - 

    Go to <

    magic_collaboration_studio_

    [version]_

    no

    _install_win64\MagicCollaborationStudio\AuthServer\registerWindowsService.batRun the Webapp service installation script - invoke terminal in magic_collaboration_studio_[version]_no_install_win64

    -installer_directory>\MagicCollaborationStudio\WebAppPlatform\bin

     and run the command:
    service.bat install

Linux

  1. and run the certgen.bat file as administrator.

  2. Go to <magic

  3. Unzip magic_collaboration_studio_[version]_no_install_win64.zip no install file
  4. Open and edit authserver.properties file (magic_collaboration_studio_[version]_no-installer_install_linux64directory>\MagicCollaborationStudio\AuthServerscripts\config) and update properties:

    server.public.host
    authentication.redirect.uri.whitelist
    twc.server.host

    windows and run the installService.bat file as administrator.

  5. Go to <magicRun genkey file (magic_collaboration_studio_[version]_no-installer_install_linux64directory>\MagicCollaborationStudio\scripts\)Run certgen file (magicAuthServer and run the registerWindowsService.bat file as administrator.
  6. Go to <magic_collaboration_studio_[version]_no-installer_install_linux64directory>\MagicCollaborationStudio\WebAppPlatform\bin)

    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

  7. Start twcloud.exe (magic_collaboration_studio_[version]_no_install_linux64\MagicCollaborationStudio)
  8. Start AuthServer server - run.sh (magic_collaboration_studio_[version]_no_install_linux64\MagicCollaborationStudio\AuthServer\bin) 
  9. Start tomcat server - startup.sh (magic_collaboration_studio_[version]_no_install_linux64\MagicCollaborationStudio\bin) 
  10. , invoke CMD as administrator, and run "service.bat install" command.
  11. Open the Task Manager and start the following services:
    • No Magic Authserver service
    • No Magic Teamwork Cloud service
    • No Magic WebApp service
  12. In your web browser, go

    Open a web browser and go

    to https://localhost:8443/webapp (if default options are used)

...

  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:

...

  1. to open Magic Collaboration Studio.