Page tree
Skip to end of metadata
Go to start of metadata

Please replace $tomcat with the correct Tomcat installation folder name, such as C:\Program Files\Apache Software Foundation\Tomcat 8.5.

 

With Tomcat fully configured, it's now time to deploy the MyTimetable application.

  1. If the Tomcat service is currently running, please stop it first (see Configuring Apache Tomcat for instructions).

  2. In the Tomcat base directory, create a new directory called mytimetable, which will be the directory that holds the application archive. Also create a directory mytimetable/config to hold the configuration files.

  3. Now, copy the web application archive into this directory and name it mytimetable-web-server.war.

  4. Edit $tomcat/conf/Catalina/localhost/ROOT.xml.
    This file should map the application to the application server's root URL, as follows:

    $tomcat/conf/Catalina/localhost/ROOT.xml (Example configuration with one data source)
    <Context docBase="../mytimetable/mytimetable-web-server.war">
    	<Resources cacheMaxSize="50000" />
    	<JarScanner scanClassPath="false">
        	<JarScanFilter defaultTldScan="false" defaultPluggabilityScan="false" />
    	</JarScanner>
    </Context>
  5. Set custom MyTimetable properties, such as the various database connection settings, in a file $tomcat/mytimetable/config/mytimetable.properties (all .properties files from this directory will be read by MyTimetable). See Data source configuration (on-premises) for more information on the configuration of the data sources.
    The code block below shows a basic version of the file, configuring a single Scientia Syllabus Plus data source and SAML authentication:

    $tomcat/mytimetable/config/mytimetable.properties
    spring.profiles.active = auth-saml
    requiresChannel = https
     
    Database.Components = DS_2016
    
    Database.DataSources.2016.Label = 2016/2017
    
    Database.DataSources.2016.ContextConfiguration = classpath:nl/eveoh/mytimetable/dataprovider/syllabus/syllabus.xml
    Database.DataSources.2016.Syllabus.ServerName = {servername}
    Database.DataSources.2016.Syllabus.DatabaseName = {databasename}
    Database.DataSources.2016.Syllabus.User = {username}
    Database.DataSources.2016.Syllabus.Password = {password}
    
    saml.keystore = file:{saml_keystore_path}
    saml.keyname = {keyname}
    saml.keypass = {keypass}
    saml.entity_id = {entity_id}
    saml.entity_baseurl = {baseurl}
    saml.idp_url = {idp_url}
    saml.idp_entity_id = {entity_id}
  6. Start the Tomcat service. The application will now be deployed, which could take some minutes.