Note: Before starting your on-premise installation, be sure that you meet all System Requirements
and that you have performed all of the prerequisite tasks from the On-Premise Installation Prerequisites article. If you are utilizing Amazon hosting, ensure that you meet all of the Amazon Hosting System Requirements. These steps assume that AnswerHub is the only application to be installed into your Tomcat server.
and that you have performed all of the prerequisite tasks from the On-Premise Installation Prerequisites article. If you are utilizing Amazon hosting, ensure that you meet all of the Amazon Hosting System Requirements. These steps assume that AnswerHub is the only application to be installed into your Tomcat server.
- Unpack and move AnswerHub into the /ops directory.
Note: At this point the /ops directory should contain the teamhub.war folder that contains the application, and the teamhub.home folder that contains your additional data, such as available themes and plugins, and temporary files. - Configure the AnswerHub config.properties in teamhub.war/WEB-INF/classes/META-INF/config.properties with the following settings:
teamhub.home=/opt/answerhub-x.x.x/teamhub.home teamhub.forceSetup=false database.engine=mysql database.name=[Database name you created in your mysql server] database.user=[Username of the administrator of your mysql server] database.password=[password for the Administrator user in your mysql server] database.url=[hostname for your mysql server]<br>
Note: If after loading this file you have issues, verify you have no typos in the previous entries, trailing spaces, or invisible characters for any of the parameters. - In the Tomcat webapps directory, perform the following steps:
- Remove everything in the directory.
- Create a symbolic link named ROOT which points to teamhub.war.
- Verify that the Tomcat user has read permissions to ROOT and teamhub.war and write permission to teamhub.home.
- Start Tomcat.
Note: At this point, it's best practice to tail the tomcat log to see if there are any errors as the application starts up. You should see some basic logging from AnswerHub. - Direct your web browser to the URL you created in for your AnswerHub instance. If you are running locally, the default URL will be http://localhost:8080.
Result: You should see an installation screen for AnswerHub in your browser. The system will default to the current user running Tomcat and the default hostname of the system you are running on. - During the installation, you need to set an overall AnswerHub server admin username and password, the first AnswerHub site admin username and password, the domain name [steps1, 2, and 3 need separate bullets].
Best practice: Be sure to record these usernames and passwords in a safe, accessible place. For the admin domain, it is best to add the admin prefix to your AnswerHub site domain name.
Result: Your AnswerHub instance should now be up and running.
Note: You should use the system administrator username and password you used in step 2. During installation, you may see some migration errors but they can be ignored. - You can now log in to your AnswerHub site. You will need to use the admin site credentials for the server admin site, and the site credentials for your site log in.
Note: It may take a while for the site's styles to compile when you open the site for the first time.
Contributors
