Page History

...

1. Download the installer, magic_collaboration_studio_190_sp2_installer_win64.exe for Windows (or magic_collaboration_studio_190_sp2_installer_linux64.bin for Linux).
2. Right click on the downloaded installer and Run as administrator. The Introduction section will open. Click Next.
   
3. 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.
      
4. Configure IP address: 
   1. Type the name or IP of the machine on which you want to install MCS.
   2. Enter the node IP. If your machine is a single node server or the first node in the cluster, enter the IP of your machine. Click Next.
   

5. Select the Java VM installed on your machine for running MCS and click Next. 
   

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

7. Check if everything is correct.

8. Click Install. The installer will install MCS on your machine. 

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

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

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

Post-Install Configuration

...

1. Edit the configuration file: C:\Program Files\MagicCollaborationStudio\configuration\application.conf.  Search for seeds = , located under the section for the persistence Cassandra section, and replace: localhost  with: ip_address_of_cassandra_node. Search for server =, located in the esi.auth section.  Please remove the "#" sign and enter the ip address or FQDN (if accessing via FQDN) of your server.

2. If you are accessing TWCloud Admin via its FQDN, edit the configuration file: C:\Program  Files\MagicCollaborationStudio\AuthServer\config\authserver.properties.  Search for server.public.host and replace the IP address with the FQDN.  Search for authentication.redirect.uri.whitelist, and append the following to the entry, https://FQDN:8443/webapp/

3. Please create a an entry in C:\Windows\System32\drivers\etc\hosts containing the local IP address and the FQDN of your machine, if accessing via FQDN.  For example, if your IP address is 10.1.1.123 and your FQDN is mymachine.mydomain.local, it would be in this form:
   10.1.1.123     mymachine.mydomain.local 

4. Open an administrative command prompt and issue the following commands in order to create service dependencies:

   sc config authserver depend= teamworkcloud

   sc config webapp depend= teamworkcloud

5. Open the Task Manager and restart the authserver, teamworkcloud, and webapp services.

6. In your web browser, go to https://localhost:8443/webapp (if default options are used) to open Magic Collaboration Studio.