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

    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 CATALINA_HOME_WEBAPP variables as shown below:

      Code Block
      CATALINA_HOME_WEBAPP=/<magic_collaboration_studio_no-installer_directory>\MagicCollaborationStudio\WebAppPlatform
      JRE_HOME=/<magic_collaboration_studio_no-installer_directory>\MagicCollaborationStudio\WebAppPlatform\<Java_install_directory>jre


    5. Click OK.

  8. Go to <magic<magic_collaboration_studio_no-installer_directory>\MagicCollaborationStudio\scripts\windows and  and run the installServicegenkey.bat file as administrator.Go to <magic_collaboration_studio_no-installer_directory>\MagicCollaborationStudio\AuthServer and run the registerWindowsService.bat file as administrator.
  9. Go to <magic_collaboration_studio_no-installer_directory>\MagicCollaborationStudio\WebAppPlatform\bin

     and

    and run the 

    service

    certgen.bat file as administrator

    .
  10. Open the Task Manager and start the following services:
    • AuthServer
    • TeamworkCloud
    • WebApp
  11. Open your web browser and go to https://localhost:8443/webapp (if default options are used).

  12. When the welcome page opens apply the Magic Collaboration Studio license.

Running Magic Collaboration Studio on Linux

To run Magic Collaboration Studio by using no-installer

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

    .

  2. Save and close the authserver.properties file

    Go to <magic<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. scripts\windows and run the installService.bat file as administrator.

  5. Go to <magic<magic_collaboration_studio_no-installer_directory>\MagicCollaborationStudio\scripts\linux and run the genkeyAuthServer and run the registerWindowsService.bat file as administrator.
  6. Go to <magic<magic_collaboration_studio_no-installer_directory>\MagicCollaborationStudio\WebAppPlatform\bin and run the certgen.sh file as administrator.

    Specify CATALINA_HOME_WEBAPP and JRE_HOME variables the following way:

  7. Open the Terminal application.
  8. Execute the following command:

    Code Block
    export JRE_HOME=/<Java_install_directory>
    

    Execute the following command:

    Code Block
    export CATALINA_HOME_WEBAPP=/<magic_collaboration_studio_no-installer_directory>\MagicCollaborationStudio\WebAppPlatform
  9. Close the Terminal application.
  10. Go to <magic_collaboration_studio_no-installer_directory>\MagicCollaborationStudio and run the twcloud file as administrator.

  11. Go to <magic_collaboration_studio_no-installer_directory>\MagicCollaborationStudio\AuthServer\bin and run the  run.sh file as administrator.
  12. , invoke CMD as administrator, and run "service.bat install" command.
  13. Open the Task Manager and start the following services:
    • No Magic Authserver service
    • No Magic Teamwork Cloud service
    • No Magic WebApp service
  14. In your web browser, go to https://localhost:8443/webapp (if default options are used) to open Magic Collaboration Studio

    Go to <magic_collaboration_studio_no-installer_directory>\MagicCollaborationStudio\WebAppPlatform\bin and run the startup.sh file as administrator

    .