ScrumWorks Pro - Documentation - Port Configuration

Quick Links

Using the predefined configurations
Using a custom port

Customizing the Configuration

Port Configuration

The ports ScrumWorks Pro server listens to by default should be fine for most users. If you have pre-existing software installed on your machine, such as IIS or another copy of JBoss, you may need to change the ports ScrumWorks uses.

Using the predefined configurations

Note: this solution assumes you have systems administration and XML skills.

Stop your ScrumWorks server.
Edit the file <SW Installation Directory>/server/scrumworks/conf/bindingservice.beans/META-INF/bindings-jboss-beans.xml.
Change ports-default around line 24 to ports-01, ports-02, or ports-03. For each, the port increases by 100. Changing to ports-01 would make ScrumWorks listen on port 8180. Using ports-03 would make ScrumWorks listen on port 8380.
Save the file and restart the server.

» top

Using a custom port

Note: this solution assumes you have systems administration and XML skills.

Stop your ScrumWorks server.
Edit the file <SW Installation Directory>/server/scrumworks/conf/bindingservice.beans/META-INF/bindings-jboss-beans.xml.
On or near line 284, there a line that looks like: <property name="port">8080</property>. Change the 8080 to your desired port. Make sure that on line 24, you are using ports-default. If you are on Linux or Mac OS X, you may run into problems if you choose a port less than 1024.
Save the file and restart the server.

» top

HTTPS Configuration

ScrumWorks Pro supports access through a secure HTTPS connection.

The configuration outlined below is intended as a sample. You should modify it according to the configuration used by your organization.

This guide is intended to be used by your organization's system administrator.

Customizing the Configuration

Note: this solution assumes you have systems administration and XML skills.

To add HTTPS to your ScrumWorks Pro installation, you will need to edit the file

<SW Installation Directory>/server/scrumworks/deploy/jbossweb.sar/server.xml

There is a section of the XML at about line 32 that is commented out. You will need to uncomment the section and change the organization-specific parameters.

The specific XML section you are looking for looks like:

               <!-- SSL/TLS Connector configuration using the admin devl guide keystore
               <Connector protocol="HTTP/1.1" SSLEnabled="true"
                    port="${jboss.web.https.port}" address="${jboss.bind.address}"
                    maxThreads="100" strategy="ms" maxHttpHeaderSize="8192"
                    emptySessionPath="true"
                    scheme="https" secure="true" clientAuth="false"
                    keystoreFile="${jboss.server.home.dir}/conf/chap8.keystore"
                    keystorePass="rmi+ssl" sslProtocol = "TLS" />
               -->

. The tags you will need to change are keystoreFile and keystorePass.

keystoreFile is the path to the file containing your SSL certificate.
keystorePass is the password required to use the SSL certificate.

Other parameters should not need to be modified.

Once the configuration has been changed, restart the ScrumWorks Pro server. You should then be able to access ScrumWorks using HTTPS:

https://<hostname>:8443/scrumworks

» top