Version Differences for AnthillPro Upgrade Checklist

* <font size=4 color=indigo>Upgrade a copy of your database to ensure no problems will occur with this portion of the upgrade</font>

* <font size=4 color=navy>Scheduling on-call support during your upgrade window</font>

-

Backup the database. Use the tools that come with your database vendor to perform this, and consult your vendorâs documentation on how to use them.

+

Backup the database. Use the tools that come with your database vendor to perform this, and consult your vendor’s documentation on how to use them.

Backup the file-system. At a minimum, backup the anthill installation location. '''This contains not only AnthillPro, but your artifacts and job logs (''ATTENTION: var DIRECTORY'')'''.

These steps will ensure you have a copy of the current state. If for any reason you need to revert the upgrade, you will need this information to do so.

# Shutdown the server

# Ensure the installer archive is extracted to an accessible directory.

-

# Copy your database driver to the installerâs lib\ext directory (create \ext\ if it doesnât exist).

+

# Copy your database driver to the installer’s lib\ext directory (create \ext\ if it doesn’t exist).

# From an Administrative Command Prompt (or shell in *nix), navigate to the anthill3-install directory and run install-server.bat (or ./install-server.sh in *nix).

# When prompted, give the currently installed AnthillPro server directory.

-

# You will be prompted if you would like to upgrade. Input âYâ (inputting âNâ will fail out the program).

+

# You will be prompted if you would like to upgrade. Input ‘Y’ (inputting ‘N’ will fail out the program).

# Provide the JDK location you wish to use (usually %JAVA_HOME%).

# Provide any additional information the installer requests (such as hostname, Windows Service name, etc.).

# Select one or more agents to test the upgrade

# Hit the upgrade arrow

-

# The upgrade was successful if the agent shows âonlineâ and has the proper version (i.e. the agent version matches the âcurrent acceptable agent versionâ listed at the top of the agents page).

+

# The upgrade was successful if the agent shows ‘online’ and has the proper version (i.e. the agent version matches the ‘current acceptable agent version’ listed at the top of the agents page).

Now you can run some tests using that agent, and decide to upgrade the rest.

-

To upgrade the rest, select all of the agents and choose âupgrade agentsâ. This will upgrade 5 at a time. Individually upgrade in a few minutes.

+

To upgrade the rest, select all of the agents and choose ‘upgrade agents’. This will upgrade 5 at a time. Individually upgrade in a few minutes.

=== Formula ===

<pre>(CEILING(num-agents)sig5 / 5 agents-concurrent) * 2 minutes-per-upgrade = total-minutes-needed</pre>

-

<pre>? ? ? ?

+

<pre>┌ ┌ ┐ ┐

-

? ?num-agents?sig5 ?

+

│ │num-agents│sig5 │

-

? ----------------------? * 2 minutes per upgrade = total minutes needed

+

│ ----------------------│ * 2 minutes per upgrade = total minutes needed

-

? 5 agents concurrent ?

+

│ 5 agents concurrent │

-

? ?</pre>

+

└ ┘</pre>

* The actual agent upgrade might actually run quicker depending on network, processor, disk speed, etc.

The next section lists some applications of this formula:

# Restore the old file system (i.e. AnthillPro installation directory)

# Start AnthillPro and clear your browser cache

-

# Navigate to the agents page and follow the upgrade process (which will âupgradeâ your agents to the AnthillPro version you are using).

+

# Navigate to the agents page and follow the upgrade process (which will “upgrade” your agents to the AnthillPro version you are using).

= Appendix A: Database Moving =

 * <font size=4 color=indigo>Upgrade a copy of your database to ensure no problems will occur with this portion of the upgrade</font>
 * <font size=4 color=navy>Scheduling on-call support during your upgrade window</font>
-                Backup the database.  Use the tools that come with your database vendor to perform this, and consult your vendorâs documentation on how to use them.
+                Backup the database.  Use the tools that come with your database vendor to perform this, and consult your vendor’s documentation on how to use them.
 Backup the file-system.  At a minimum, backup the anthill installation location.  '''This contains not only AnthillPro, but your artifacts and job logs (''ATTENTION:  var DIRECTORY'')'''.
 These steps will ensure you have a copy of the current state.  If for any reason you need to revert the upgrade, you will need this information to do so.
 # Shutdown the server
 # Ensure the installer archive is extracted to an accessible directory.
-                # Copy your database driver to the installerâs lib\ext directory (create \ext\ if it doesnât exist).
+                # Copy your database driver to the installer’s lib\ext directory (create \ext\ if it doesn’t exist).
 # From an Administrative Command Prompt (or shell in *nix), navigate to the anthill3-install directory and run install-server.bat (or ./install-server.sh in *nix).
 # When prompted, give the currently installed AnthillPro server directory.
-                # You will be prompted if you would like to upgrade.  Input âYâ (inputting âNâ will fail out the program).
+                # You will be prompted if you would like to upgrade.  Input ‘Y’ (inputting ‘N’ will fail out the program).
 # Provide the JDK location you wish to use (usually %JAVA_HOME%).
 # Provide any additional information the installer requests (such as hostname, Windows Service name, etc.).
 # Select one or more agents to test the upgrade
 # Hit the upgrade arrow
-                # The upgrade was successful if the agent shows âonlineâ and has the proper version (i.e. the agent version matches the âcurrent acceptable agent versionâ listed at the top of the agents page).
+                # The upgrade was successful if the agent shows ‘online’ and has the proper version (i.e. the agent version matches the ‘current acceptable agent version’ listed at the top of the agents page).
 Now you can run some tests using that agent, and decide to upgrade the rest.
-                To upgrade the rest, select all of the agents and choose âupgrade agentsâ.  This will upgrade 5 at a time.  Individually upgrade in a few minutes.
+                To upgrade the rest, select all of the agents and choose ‘upgrade agents’.  This will upgrade 5 at a time.  Individually upgrade in a few minutes.
 === Formula ===
 <pre>(CEILING(num-agents)sig5 / 5 agents-concurrent) * 2 minutes-per-upgrade = total-minutes-needed</pre>
-                <pre>?    ?          ?       ?
+                <pre>┌    ┌          ┐       ┐
-                ?    ?num-agents?sig5   ?
+                │    │num-agents│sig5   │
-                ? ----------------------? * 2 minutes per upgrade = total minutes needed
+                │ ----------------------│ * 2 minutes per upgrade = total minutes needed
-                ?  5 agents concurrent  ?
+                │  5 agents concurrent  │
-                ?                       ?</pre>
+                └                       ┘</pre>
 * The actual agent upgrade might actually run quicker depending on network, processor, disk speed, etc.
 The next section lists some applications of this formula:
 # Restore the old file system (i.e. AnthillPro installation directory)
 # Start AnthillPro and clear your browser cache
-                # Navigate to the agents page and follow the upgrade process (which will âupgradeâ your agents to the AnthillPro version you are using).
+                # Navigate to the agents page and follow the upgrade process (which will “upgrade” your agents to the AnthillPro version you are using).
 = Appendix A:  Database Moving =