Using no-installer

Here you can learn how to start Magic Collaboration Studio using the no-installer .zip 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. Specify CATALINA_HOME_WEBAPP and JRE_HOME 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:

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

   5. Click OK.
      
      
      
      

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
   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: