{"id":2552,"date":"2015-10-23T13:54:48","date_gmt":"2015-10-23T13:54:48","guid":{"rendered":"https:\/\/twproject.com\/support\/using-twproject\/installation\/handcustom-install\/"},"modified":"2022-05-30T07:50:43","modified_gmt":"2022-05-30T07:50:43","slug":"handcustom-install","status":"publish","type":"page","link":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/installation\/handcustom-install\/","title":{"rendered":"Hand\/custom install"},"content":{"rendered":"<p>You may want to install Twproject by hand because of your network or server settings, or because you are using an operating system without the graphic interface.<br \/>\nThere are two ways to complete\u00a0the installation: copying an existing one (easier) or doing it completely by hand (much complex).<\/p>\n<p>&nbsp;<\/p>\n<h2>Copying a graphical installation<\/h2>\n<p>If possible, do the graphical installation on a\u00a0client machine that can access the database server, so that the installer can configure for your db access, license, http port and the other settings; doing all this by hand can be not trivial; then copy on the server. This is the simplest way.<\/p>\n<p>Manual installation covers different cases : one is that you have already a web server running and a Java 1.8 JDK installed, and you want to add Twproject as a web app. The simplest way is to install using the installer on a client machine, with access to real database, as the installer will:<\/p>\n<ol>\n<li>create the database\u00a0tables<\/li>\n<li>fill sample data<\/li>\n<li>create a global.properties file with SMTP and similar settings<\/li>\n<li>create a config.properties with the JDBC connection parameters<\/li>\n<li><span style=\"line-height: 1.5;\">create a lic.properties file with the license data supplied<\/span><\/li>\n<\/ol>\n<p>As all the files created are fine on any O.S., just copy the resulting webapp from webapps\/ROOT in the webapp folder for Twproject. Otherwise you will need to create all these by hand. A sample complete global.properties can be found as<\/p>\n<p>webapps\/ROOT\/commons\/settings\/sampleGlobal.properties<\/p>\n<h2>Complete installation by hand<\/h2>\n<p>We assume that you have Java\u2019s JDK 8 already installed, and also a Tomcat (9 or higher) running. If you don\u2019t, download and install those first.<\/p>\n<p>We are assuming that you are not deploying as an unpacked war, as the web app needs to write in its folders, so you must use a \u201cunpacked\u201d war.<\/p>\n<ul>\n<li>Download and extract the archive version (zip, gz, or rpm)<\/li>\n<li><span style=\"line-height: 1.5;\">Take the folder Twproject, it contains subfolders:<\/span><\/li>\n<\/ul>\n<p>applications commons mobile WEB-INF<\/p>\n<p>plus a few root files. This is the web app you need to install. Now:<\/p>\n<ul>\n<li>Copy the web application inside your Tomcat webapps, in a folder with the name you please, say \u201ctwproject\u201d. You must ensure that it is using JDK 8.<\/li>\n<li>In WEB-INF\/config.properties you must write the JDBC connection data and other configurations, several example configs:<\/li>\n<\/ul>\n<p><strong>MySQL 8 + :<\/strong><\/p>\n<blockquote>\n<pre><code>user=root   \r\npassword=[yourpassword]    \r\nurl=jdbc:mySql:\/\/localhost\/twproject\r\ndialect=org.hibernate.dialect.MySQL8InnoDBUTF8Dialect\r\ndriver=com.mysql.cj.jdbc.Driver\r\n<\/code><\/pre>\n<\/blockquote>\n<p><strong>MySQL 5.6.24 + :<\/strong><\/p>\n<blockquote>\n<pre><code>user=root   \r\npassword=[yourpassword]    \r\nurl=jdbc:mySql:\/\/localhost\/twproject\r\ndialect=org.hibernate.dialect.MySQL57InnoDBUTF8Dialect\r\ndriver=com.mysql.cj.jdbc.Driver\r\n<\/code><\/pre>\n<\/blockquote>\n<p><strong>MySQL 5.6.23 and before:<\/strong><\/p>\n<blockquote>\n<pre><code>user=root   \r\npassword=[yourpassword]    \r\nurl=jdbc:mySql:\/\/localhost\/twproject\r\ndialect=org.hibernate.dialect.MySQL5InnoDBUTF8Dialect   \r\ndriver=com.mysql.cj.jdbc.Driver\r\n<\/code><\/pre>\n<\/blockquote>\n<p><strong>SQLServer 2012+\u00a0 mixed authentication:<\/strong><\/p>\n<blockquote>\n<pre><code>user=sa\r\npassword=[yourpassword]    \r\nurl=jdbc:sqlserver:\/\/myserver:1433;databaseName=twproject\r\ndialect=org.hibernate.dialect.SQLServer2012UnicodeDialect\r\ndriver=com.microsoft.sqlserver.jdbc.SQLServerDriver\r\n\r\n#if it is an instance:\r\nurl=jdbc:sqlserver:\/\/myserver\\\\your_instance_name;databaseName=twproject<\/code><\/pre>\n<\/blockquote>\n<p><strong>SQLServer 2008 mixed authentication:<\/strong><\/p>\n<blockquote>\n<pre><code>user=sa\r\npassword=[yourpassword]    \r\nurl=jdbc:jtds:sqlserver:\/\/myserver:1433\/twproject\r\ndialect=org.hibernate.dialect.SQLServer2008UnicodeDialect\r\ndriver=net.sourceforge.jtds.jdbc.Driver\r\n\r\n#if it is an instance:\r\nurl=jdbc:jtds:sqlserver:\/\/myserver:1433\/twproject;instance=yourinstance<\/code><\/pre>\n<\/blockquote>\n<p>for the complete list of SQL Server options see\u00a0<a title=\"jTDS driver specs\" href=\"http:\/\/jtds.sourceforge.net\/faq.html\" target=\"_blank\" rel=\"noopener\">http:\/\/jtds.sourceforge.net\/faq.html<\/a><\/p>\n<p><strong>Oracle 12+:<\/strong><\/p>\n<blockquote>\n<pre><code>schemaName=tw52setup\r\nuser=tw52setup\r\npassword=[yourpassword]    \r\nurl=jdbc:oracle:thin:@oldb02:1521:XE[ put your SID]    \r\ndialect=org.hibernate.dialect.Oracle12cDialect   \r\ndriver=oracle.jdbc.driver.OracleDriver<\/code><\/pre>\n<\/blockquote>\n<p><strong>Oracle 10+:<\/strong><\/p>\n<blockquote>\n<pre><code>schemaName=tw52setup\r\nuser=tw52setup\r\npassword=[yourpassword]    \r\nurl=jdbc:oracle:thin:@oldb02:1521:XE[ put your SID]    \r\ndialect=org.hibernate.dialect.Oracle10gDialectDBText   \r\ndriver=oracle.jdbc.driver.OracleDriver\r\n<\/code><\/pre>\n<\/blockquote>\n<p><strong>PostgreSQL 9+:<\/strong><\/p>\n<blockquote>\n<pre><code>user=postgres\r\npassword=[yourpassword]    \r\nurl=jdbc:postgresql:\/\/localhost\/twproject\r\ndialect=org.hibernate.dialect.PostgreSQLDialectMultiSequence9\r\ndriver=org.postgresql.Driver<\/code><\/pre>\n<\/blockquote>\n<p><strong>PostgreSQL 8:<\/strong><\/p>\n<blockquote>\n<pre><code>user=postgres\r\npassword=[yourpassword]    \r\nurl=jdbc:postgresql:\/\/localhost\/twproject\r\ndialect=org.hibernate.dialect.PostgreSQLDialectDBBlobs\r\ndriver=org.postgresql.Driver\r\n<\/code><\/pre>\n<\/blockquote>\n<p>For other databases \/ versions, please submit a ticket for updated connection strings. Again, actually the simplest way to be sure about Java connecting to the database is to do a graphical installation from a client and check the resulting config.properties file from there.<\/p>\n<ul>\n<li>In WEB-INF you must also create a file lic.properties file in which you paste the evaluation license, for example<br \/>\n<blockquote>\n<pre><code style=\"font-size: 11px;\">----- BEGIN TWPROJECT KEY -----\r\nPUbyP5tbmgGoAYQK3PIjcBhWOgdv7SDFM31bIV+LJZx\/5xD2c7YGH0TzOByF\/3Bc\r\newmde\/QL6nmQEa0vx9xfcHTYacNoXfEDul8l1gCvqbM15vEH\/YpiNDlGi+WPb7IN\r\nuH8XtbCBW3buXWS3Ctre4PxsPYf+bRE+m6cI8+CRROPI1M80f\/G6sqKt0w9jhgBJ\r\nY88EZ2puHlGeiojEhrQtd3fHN1As7bx9snMWZvD9\/XvBRrYLQ7x47Egekz564NVT\r\nO6c2LCsndeY5Xz9WsJFg0tfJVTUfwd8MkWd\/+BbRMjRUGvZk0Q4iGvf6qFpBpVrS\r\nPG6tFUI1HOWV13qgistINQ==\r\n----- END TWPROJECT KEY -----\r\n<\/code><\/pre>\n<\/blockquote>\n<\/li>\n<\/ul>\n<p>Note: this is not a valid license, generate it here: <a href=\"https:\/\/twproject.com\/on-your-server\/\">https:\/\/twproject.com\/on-your-server\/<\/a><\/p>\n<ul>\n<li>This done, you may launch the web app; if you did the deploy operations while Tomcat was running, you may need to restart the web app. If the JDBC configuration is correct (this is most frequent mistake), the application will start, create the tables and insert sample data.<\/li>\n<li>DEBUG If the web application \u201cstarted too soon\u201d, and say the insertion of sample data failed, open Commons\/settings\/global.properties remove the lines<\/li>\n<\/ul>\n<blockquote>\n<pre><code>SETUP_DB_UPDATE_DONE=yes\r\n<\/code><\/pre>\n<\/blockquote>\n<p>And restart the web app.<\/p>\n<ul>\n<li>Remember to set the repository, file storage, indexing etc . paths in the admin pages.<\/li>\n<\/ul>\n<p>If you are deploying under JBoss, take care of the Hibernate (including Annotations and Search) version you are using, Twproject provides its own, and it must be the same.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>You may want to install Twproject by hand because of your network or server settings, or because you are using an operating system without the graphic interface. There are two ways to complete\u00a0the installation: copying an existing one (easier) or doing it completely by hand (much complex). &nbsp; Copying a graphical installation If possible, do [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":2524,"menu_order":12,"comment_status":"closed","ping_status":"open","template":"","meta":{"footnotes":""},"class_list":["post-2552","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v25.4 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Hand\/custom install | Twproject support<\/title>\n<meta name=\"description\" content=\"You may want to install Twproject by hand because of your network or server settings, or because you are using an operating system without the graphic\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/installation\/handcustom-install\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Hand\/custom install | Twproject support\" \/>\n<meta property=\"og:description\" content=\"You may want to install Twproject by hand because of your network or server settings, or because you are using an operating system without the graphic\" \/>\n<meta property=\"og:url\" content=\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/installation\/handcustom-install\/\" \/>\n<meta property=\"og:site_name\" content=\"Twproject support\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/twproject\" \/>\n<meta property=\"article:modified_time\" content=\"2022-05-30T07:50:43+00:00\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/installation\/handcustom-install\/\",\"url\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/installation\/handcustom-install\/\",\"name\":\"Hand\/custom install | Twproject support\",\"isPartOf\":{\"@id\":\"https:\/\/twproject.com\/support\/#website\"},\"datePublished\":\"2015-10-23T13:54:48+00:00\",\"dateModified\":\"2022-05-30T07:50:43+00:00\",\"description\":\"You may want to install Twproject by hand because of your network or server settings, or because you are using an operating system without the graphic\",\"breadcrumb\":{\"@id\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/installation\/handcustom-install\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/installation\/handcustom-install\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/installation\/handcustom-install\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/twproject.com\/support\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Advanced usage\",\"item\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Install Twproject\",\"item\":\"https:\/\/twproject.com\/support\/twproject-advanced-usage\/installation\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Hand\/custom install\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/twproject.com\/support\/#website\",\"url\":\"https:\/\/twproject.com\/support\/\",\"name\":\"Twproject support\",\"description\":\"Twproject documentation online\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/twproject.com\/support\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Hand\/custom install | Twproject support","description":"You may want to install Twproject by hand because of your network or server settings, or because you are using an operating system without the graphic","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/installation\/handcustom-install\/","og_locale":"en_US","og_type":"article","og_title":"Hand\/custom install | Twproject support","og_description":"You may want to install Twproject by hand because of your network or server settings, or because you are using an operating system without the graphic","og_url":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/installation\/handcustom-install\/","og_site_name":"Twproject support","article_publisher":"https:\/\/www.facebook.com\/twproject","article_modified_time":"2022-05-30T07:50:43+00:00","twitter_misc":{"Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/installation\/handcustom-install\/","url":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/installation\/handcustom-install\/","name":"Hand\/custom install | Twproject support","isPartOf":{"@id":"https:\/\/twproject.com\/support\/#website"},"datePublished":"2015-10-23T13:54:48+00:00","dateModified":"2022-05-30T07:50:43+00:00","description":"You may want to install Twproject by hand because of your network or server settings, or because you are using an operating system without the graphic","breadcrumb":{"@id":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/installation\/handcustom-install\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/twproject.com\/support\/twproject-advanced-usage\/installation\/handcustom-install\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/installation\/handcustom-install\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/twproject.com\/support\/"},{"@type":"ListItem","position":2,"name":"Advanced usage","item":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/"},{"@type":"ListItem","position":3,"name":"Install Twproject","item":"https:\/\/twproject.com\/support\/twproject-advanced-usage\/installation\/"},{"@type":"ListItem","position":4,"name":"Hand\/custom install"}]},{"@type":"WebSite","@id":"https:\/\/twproject.com\/support\/#website","url":"https:\/\/twproject.com\/support\/","name":"Twproject support","description":"Twproject documentation online","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/twproject.com\/support\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/pages\/2552","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/comments?post=2552"}],"version-history":[{"count":0,"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/pages\/2552\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/pages\/2524"}],"wp:attachment":[{"href":"https:\/\/twproject.com\/support\/wp-json\/wp\/v2\/media?parent=2552"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}