- Java JDK 1.8+ (http://www.oracle.com/technetwork/java/javase/downloads/index.html)
- Maven 2/3 (http://maven.apache.org/ -- To install from source)
- Tomcat 7+ (http://tomcat.apache.org/)
- Graphviz (http://www.graphviz.org/)
- Unix/OSX environment (The portal will run in Windows, but we don't have windows compatible domains right now)
Alternative A): Use our Docker image (you need to have Docker installed: https://www.docker.com/):
docker pull kcapd/wings-base
- Or build it with additional software using our proposed Docker files. (See https://github.com/KnowledgeCaptureAndDiscovery/wings-docker for additional instructions.)
Alternative B): Follow the steps below to install WINGS locally:
- Get war file. Choose from one of the options below: a. If installing from source. Download source from https://github.com/IKCAP/wings
mvn install
(Do this if you are installing from source and don't already have a war file). If you find any encoding issues, try "export MAVEN_OPTS= -Dfile.encoding=UTF-8" before the mvn command- This will create a wings-portal-.war file in portal/target b. Or, Download from http://www.wings-workflows.org/download-wings-portal
- Move the war file to a Servlet container (Tomcat) and rename to wings-portal.war
- $ mv /path/to/wings-portal-.war /path/to/tomcat/webapps/wings-portal.war
- Setup an admin user in /path/to/tomcat/conf/tomcat-users.xml
- Wings admin users need to have the "WingsUser" and "WingsAdmin" roles Example: (The following needs to go inside the <tomcat-users ..> Section.
<user name="adminUser" password="adminPassword" roles="WingsUser,WingsAdmin" />
- In /path/to/tomcat/conf/server.xml, add 'readonly="false"' to the UserDatabase Resource
<Resource name="UserDatabase" ... readonly="false"/>
- The add the following to the "Context" section if it exists, if not create one
<Context>
<ResourceLink name="users" global="UserDatabase" type="org.apache.catalina.UserDatabase" />
</Context>
- Start tomcat
$ /path/to/tomcat/bin/catalina.sh start
- Login to the server from http://:8080/wings-portal/login
- Note: 8080 is the default Tomcat port, but this can be changed in server.xml
- After first Login, go to $HOME/.wings directory and open portal.properties
- Change /path/to/dot (graphviz) if it is set incorrectly
- Check that the server name is set correctly
- (Optional) Change any other settings if needed
- Manage users at http://:8080/wings-portal/users/common/list
- From this UI, you can add or remove more users.
- To see a list of domains to download, please go to the "Manage Domains" interface
- To Import a domain: From the "Manage Domains" interface, do the following:
- Add -> Import Domain
- Enter Domain Location: the url (or path) to the domain zip file
- Note that some domains might require installation of infrastructure software on your server