|
|
|
| Line 1: | |||
| - | This section will list important information w.r.t Windows Service installation on AnthillPro. | + | This section will list important information w.r.t Windows Service installation on AnthillPro. All documentation within this wiki was taken directly from the [http://docs.urbancode.com/anthill3-help-3.8/html/default.html 3.8 documentation]. |
| + | = Server Installation = | ||
| + | For newer versions of Windows, you will need to execute an '''Administrator Command Prompt''' to install as a Windows Service. This can be done by ''right clicking'' '''cmd.exe''' and selecting ''"Run As Administrator."'' | ||
| + | To install the AnthillPro server: | ||
| + | Download the anthill3-<version>.zip file. | ||
| + | Expand the zip file using a tool like WinZip. Expanding will create an anthill3-install directory. | ||
| + | Open the anthill3-install directory created in the previous step in Windows. | ||
| + | If you are using a database other than Apache Derby, copy the JDBC driver file(s) into the anthill3-install\lib\ext directory. See Database Requirements. | ||
| + | Run the install script install-server.bat. | ||
| + | Provide the following information: | ||
| + | Directory where the AnthillPro server should be installed. For example: C:\Program Files\anthill3\server. If the directory does not already exist, enter Y to have the installer create the directory. Default is Y. | ||
| + | Home directory of the JRE/JDK used to run the server. For example: C:\Program Files\Java\jre1.6.0_07. | ||
| + | Port used to communicate with the agent(s). Recommended default value is 7915. | ||
| + | Port on which AnthillPro server should listen for remoting or distributed servers. Default is 4567. | ||
| + | IP address that the server web UI should listen on. We suggest leaving this blank so that AnthillPro listens on all available IP addresses. | ||
| + | Secured connections using SSL. If using a secured connection for all web UI communication, enter Y. | ||
| + | When using SSL, you need to turn it on for both the server and the agent -- otherwise the agents will not be able to connect to the server. If you are using the agent relay, ensure that SSL is turned on for all three components: server, agent, and agent relay. This rule also applies if using mutual authentication. | ||
| + | If using a caching proxy, see Caching and SSL before continuing. Under certain conditions, using HTTPS may effect server performance. | ||
| + | If using a secured connection for HTTP requests, give the port the AnthillPro sever should listen on. Recommended default is 8443. | ||
| + | Unsecured HTTP port for the Web UI. This will be used to redirect unsecured requests to the secured HTTPS port when using HTTPS for the Web UI. Default is 8080. | ||
| + | HTTP port for the Web UI (if not using SSL). Default is 8080. | ||
| + | Database type (if other than the embedded Derby database). See Database Requirements. | ||
| + | Database user name. Default is anthill3. | ||
| + | Database password. Default is password. | ||
| + | Install as Windows service (optional). Type Y to install as Windows service. Type N to finish installation process. Note that when installing as a service, AnthillPro only captures the value for the PATH variable. The values captured at installation will always be used, even if you later make changes. | ||
| + | For newer versions of Windows, you will need to execute an Administrator Command Prompt to install as a Windows Service. This can be done by right clicking cmd.exe and selecting "Run As Administrator." | ||
| + | To automatically install the AnthillPro server as a Windows service, enter: | ||
| + | Service name and click OK. Default is ah3server. (A unique name is required for each instance.) | ||
| + | Login for the installed server and click OK. Default is .\localsystem. | ||
| + | Yes to automatically start ah3server service. | ||
| + | To manually install the AnthillPro server as a Windows service (optional): | ||
| + | For newer versions of Windows, you will need to execute an Administrator Command Prompt to install as a Windows Service. This can be done by right clicking cmd.exe and selecting "Run As Administrator." | ||
| + | Run ah3server.cmd install uniqueservicename (located in the server's bin\service directory). | ||
| + | Provide the service name and account information. | ||
| + | To run the AnthillPro server and complete installation: | ||
| + | In Windows, go to the AnthillPro server directory created during installation. For example, C:\Program Files\anthill3\server. Enter the bin directory. | ||
| + | Run: start_ah3server.cmd. | ||
| + | Alternatively, from the command line run the start command bin\ah3server.cmd. | ||
| + | When the AnthillPro server has started, open a web browser and give the AnthillPro URL. For example, http://localhost:8080. | ||
| + | Complete installation: | ||
| + | External URL. Enter the URL users will use to access AnthillPro. This URL will be used to generate links back to the application in e-mail notifications, as well as for some agent communication. The URL may include http(s):// and any non-standard ports. For example http://localhost:8080 if you are using default installation values. | ||
| + | Administrator E-mail Address. Give the e-mail address that should be notified about system issues. The Administrator account will have complete access to AnthillPro, and is the initial user that must set up security. See Security. | ||
| + | Administrator Password. Enter the password the AnthillPro administrator (created above) will use to access AnthillPro. | ||
| + | Note that this password (and the user name admin) will be required to complete installation of the Distributed Web interface if the AnthillPro server is going to be used in conjunction with the Distributed Web product. For information on the Distributes Web interface, contact info@urbancode.com. | ||
| + | Confirm Administrator Password. Enter the password again. | ||
| + | License. Paste your AnthillPro license in the text field after retrieving it from Supportal. | ||
| + | Go to Supportal to retrieve the license from your account. | ||
| + | Go to TEAMS/USERS > Licenses. If you do not see a license, either one does not exist for your account or you do not have permissions to download a license. Please contact your sales representative for more information. | ||
| + | Select the view license link on the right hand side of the appropriate license. | ||
| + | In the pop-up, click download. | ||
| + | Open the license, copy it, and paste it in the License field. | ||
| + | If you are evaluating AnthillPro, you download a 30-day, temporary license. The only difference between this and a production license is the expiration date. If you need a new production license, please contact your sales representative or create a Supportal ticket with your request. | ||
| + | Click Complete. | ||
| + | The application can now be accessed in the web browser. If you log out, give the user name admin and the password set in Item Five to log back in. | ||
| + | Select pre-installed Plugins to activate/deactivate. AnthillPro ships with pre-configured integrations that are written as Plugins. If you choose to deactivate any of the Plugins, you will not be able to use the AnthillPro integration with that tool until you reactivate it. If you don't know what tool integrations you want deactivated, you can leave them all active to start with and then edit the setting later. Click Done to go to the Dashboard. | ||
| + | = Agent Installation = | ||
