Versions Compared

Key

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

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

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>_installer_win64.exe file (the magic_collaboration_studio_<version_number>_installer_linux64.bin file if you use Linux). Contact your sales executive to get the file.

The installer file includes both TWCloud and Web applications (Resources, Collaborator, TWCloud Admin) in its installation package. During installation you will be asked to choose from installation options. The short introduction about these options During installation, you can choose one of the following installation options

  • Quick Install -

...

  • intended for simple collaboration scenarios where

...

  • web-based collaboration is not a daily activity. It will install

...

  • Magic Collaboration Studio and all

...

  • its web applications

...

  • into a single machine.
  • Advanced Install -

...

  • intended for heavy-weight production use. It will allow you to choose

...

  • what components to install: Teamwork Cloud Server and/or Web Application Platform (with all of the available web applications).

...

  • This installation option should be used when Teamwork Cloud Server is deployed

...

  • on a separate

...

  • machine from Web Application Platform.
Note
titlePrerequisites

Before installing Magic Collaboration Studio, do the following:

To install MCS by using the installer file

...


Warning
titleCassandra installation file

To obtain the Cassandra installation file do one of the following:

  • After downloading Magic Collaboration Studio installation files, extract the magic_collaboration_studio_<version_number>_no_

...

  • install_win64.

...

  • zip file. You will find the Cassandra installation file in the magic_collaboration_studio_<version_number>_no_install_win64\MagicCollaborationStudio\Utilities directory.
  • Install Magic Collaboration Studio but do not start any of its services. Go to the <Magic_Collaboration_Studio_install_directory>\Utilities directory and obtain the Cassandra installation file. Install Apache Cassandra, check if it is working, and only then start the Magic Collaboration Studio services.


Warning
titleInstallation path

If the installation path contains any of the special characters, like '[', ']', '(', ')', '!', '@', '#', '$', '#', '%', '{', '}', '+', '=', or ';', the installation procedure cannot be completed successfully and the login page will not load. For example, if the installation path is C:\Program Files\TeamworkCloud, which does not contain any of the special characters, the installation will not fail.


To install Magic Collaboration Studio by using the installer file

...

  1. Right-click the magic_collaboration_studio_<version_number>_installer_win64.exe file and select Run as administrator.
  2. When the installation wizard opens, click Next.

    Image Added

  3. Do one of the following: 
    1. Select the Quick install installation option, click Next, and go to step 5. 
    2. Select the Advanced Install installation option and click Next.
  4. Select the components you want to install and click Next.

    Image Added

  5. Configure the IP address: 
    1. Enter
  6. _installer_linux64.bin for Linux).
  7. Right click on the downloaded installer and Run as administrator. The Introduction section will open. Click Next.
    Image Removed
  8. In Select Installation Option section select type of installation: 
    1. If you select Quick install, click Next and go to step #4
    2. If you select Advanced Install, you will need to specify components that you want to install. Click Next.
      Image Removed
  9. Configure IP address: 
    1. Type the name or IP of the machine on which you want to install MCSMagic Collaboration Studio.
    2. Enter the node IP. If your machine is a single node server or the first node in the a cluster, enter the IP of your machine.

    Image Added

  10. Click Next.Image Removed
  11. Select the Java VM installed on your machine for running MCS and click NextMagic Collaboration Studio and click Next



  12. Select a location on your machine where you want to install TWCloud Magic Collaboration Studio and click Next. The Pre-Installation Summary section will open.

  13. Check if everything is correct.
  14. Click Install. The installer will install MCS on your machine. 

  15.  Next.

    Image Added 

  16. Check the pre-installation summary and click Install.

  17. Upon successful installation, click Done to close the installation window.

  18. Open the Task Manager and start the following services:

    • Authserver AuthServer service
    • Teamwork Cloud TeamworkCloud service
    • WebApp service
    • Zookeeper service
  19. Check if the system is working. You should be able to access Magic Collaboration Studio via https://localhostFQDN:8443/webapp/.


Post-

...

installation configuration

Note

The installer has now created the preliminary configuration. If your system is still not operational and you cannot use Magic Collaboration Studio, check the configuration parameters as described below.

...