Version Differences for Cloning an AnthillPro Instance

# When prompted, provide the following information:

## '''Directory''': Directory where you would like the server installed on the new machine

-

## '''Confirmation''': Type âyâ if this was the correct directory to install to. Typing ânâ will fail the program out.

+

## '''Confirmation''': Type "y" if this was the correct directory to install to. Typing "n" will fail the program out.

## '''JDK''': Home directory of the JDK

## '''Host''': The hostname of the AnthillPro server (the agents will use this to connect to the server)

## '''JMS''': The port that the agents will be using for communication (Default is 7915)

## '''Devilfish/Remoting''': The port that will be used for remoting connections (Default is 4567)

-

## '''IP Address''': Also known as the âBind-IPâ. This is the address the server will bind to (default is all [0.0.0.0]).

+

## '''IP Address''': Also known as the "Bind-IP". This is the address the server will bind to (default is all [0.0.0.0]).

-

### '''HTTPS (optional)''': Type âyâ if you want to use HTTPS protocol to connect to the WebUI, else type ânâ.

+

### '''HTTPS (optional)''': Type "y" if you want to use HTTPS protocol to connect to the WebUI, else type "n".

### '''HTTPS Port (optional)''': Input the secure port that you want the WebUI to listen on (Default is 8443).

### '''HTTP Port''': Input the port that you want the WebUI to listen on (Default is 8080).

-

### '''SSL (optional)''': Type âyâ if you want to use SSL between Server ? Agents. Else type ânâ.

+

### '''SSL (optional)''': Type "y" if you want to use SSL between Server ? Agents. Else type "n".

-

### '''Mutual Authentication (optional)''': Type âyâ if you want to use mutual authentication. This will require a manual key exchange between server and each agent that will connect to it.

+

### '''Mutual Authentication (optional)''': Type "y" if you want to use mutual authentication. This will require a manual key exchange between server and each agent that will connect to it.

# When prompted for database type, specify derby or just press enter as we want to do a default Derby install.

# Press enter twice to accept defaults (anthill3/password) as the username/password combination.

-

# Once file system installation finishes, select âNâ for the Windows Service install (this can always installed manually later).

+

# Once file system installation finishes, select "N" for the Windows Service install (this can always installed manually later).

# Once the database installation finishes, press enter a couple of times to exit the installer.

== Database Driver Configuration ==

-

# Now that the server is installed, navigate to the serverâs lib directory, and create a subdirectory called âextâ.

+

# Now that the server is installed, navigate to the server"s lib directory, and create a subdirectory called "ext".

# Place your database driver JAR file in this ext directory.

# '''install.db.url''' should get the connection string for your database (for example, one for Oracle might look like jdbc:oracle:thin:@oraclebox:1521/ORCL )

# '''install.db.password''' should be replaced with the plaintext password of the database user.

-

# '''install.db.driver''' needs the class name of the driver (for example, Oracleâs is oracle.jdbc.driver.OracleDriver if using ojdbc6.jar)

+

# '''install.db.driver''' needs the class name of the driver (for example, Oracle"s is oracle.jdbc.driver.OracleDriver if using ojdbc6.jar)

-

# '''install.db.user''' should be replaced with the database userâs username.

+

# '''install.db.user''' should be replaced with the database user"s username.

=== %SERVER_HOME%\conf\spring-server\spy.properties ===

-

# Find line 42 (should say '''realdriver=orgâ¦''') and change the class name of the driver to match with what you specified in the ''install.db.driver'' line in '''installed.properties''' file.

+

# Find line 42 (should say '''realdriver=orgâ?¦''') and change the class name of the driver to match with what you specified in the ''install.db.driver'' line in '''installed.properties''' file.

=== %SERVER_HOME%\conf\base.xml ===

# '''url''' should get changed to the connection string specified in installed.properties

-

# '''username''' should get changed to the database userâs username specified in installed.properties

+

# '''username''' should get changed to the database user"s username specified in installed.properties

-

# '''password''' should get changed to the plaintext database userâs password specified in installed.properties

+

# '''password''' should get changed to the plaintext database user"s password specified in installed.properties

# Finally, ensuring that all the correct values are specified, you should be able to start your server and have it connect to the cloned database (or old database depending if you cloned the database or not).

## Note that if you have any production agents come online (e.g., you restart an agent) while the new instance is running and still set to bind to 0.0.0.0, that agent may bind to the new instance and not the production instance. To prevent accidental binding and/or upgrade, you can give the AnthillPro new instance a unique IP address and then tell its agents only to bind to that IP.

-

Either way, after the clone is complete, you are free to copy over the \var\ directory from the server to the new serverâs \var\ directory. This will copy over all old artifacts, job logs, published reports, etc.

+

Either way, after the clone is complete, you are free to copy over the \var\ directory from the server to the new server"s \var\ directory. This will copy over all old artifacts, job logs, published reports, etc.

= Appendix A: Validation Queries =

 # When prompted, provide the following information:
 ## '''Directory''':  Directory where you would like the server installed on the new machine
-                ## '''Confirmation''':  Type âyâ if this was the correct directory to install to.  Typing ânâ will fail the program out.
+                ## '''Confirmation''':  Type "y" if this was the correct directory to install to.  Typing "n" will fail the program out.
 ## '''JDK''':  Home directory of the JDK
 ## '''Host''':  The hostname of the AnthillPro server (the agents will use this to connect to the server)
 ## '''JMS''':  The port that the agents will be using for communication (Default is 7915)
 ## '''Devilfish/Remoting''':  The port that will be used for remoting connections (Default is 4567)
-                ## '''IP Address''':  Also known as the âBind-IPâ.  This is the address the server will bind to (default is all [0.0.0.0]).
+                ## '''IP Address''':  Also known as the "Bind-IP".  This is the address the server will bind to (default is all [0.0.0.0]).
-                ### '''HTTPS (optional)''':  Type âyâ if you want to use HTTPS protocol to connect to the WebUI, else type ânâ.
+                ### '''HTTPS (optional)''':  Type "y" if you want to use HTTPS protocol to connect to the WebUI, else type "n".
 ### '''HTTPS Port (optional)''':  Input the secure port that you want the WebUI to listen on (Default is 8443).
 ### '''HTTP Port''':  Input the port that you want the WebUI to listen on (Default is 8080).
-                ### '''SSL (optional)''':  Type âyâ if you want to use SSL between Server ? Agents.  Else type ânâ.
+                ### '''SSL (optional)''':  Type "y" if you want to use SSL between Server ? Agents.  Else type "n".
-                ### '''Mutual Authentication (optional)''':  Type âyâ if you want to use mutual authentication.  This will require a manual key exchange between server and each agent that will connect to it.
+                ### '''Mutual Authentication (optional)''':  Type "y" if you want to use mutual authentication.  This will require a manual key exchange between server and each agent that will connect to it.
 # When prompted for database type, specify derby or just press enter as we want to do a default Derby install.
 # Press enter twice to accept defaults (anthill3/password) as the username/password combination.
-                # Once file system installation finishes, select âNâ for the Windows Service install (this can always installed manually later).
+                # Once file system installation finishes, select "N" for the Windows Service install (this can always installed manually later).
 # Once the database installation finishes, press enter a couple of times to exit the installer.
 == Database Driver Configuration ==
-                # Now that the server is installed, navigate to the serverâs lib directory, and create a subdirectory called âextâ.
+                # Now that the server is installed, navigate to the server"s lib directory, and create a subdirectory called "ext".
 # Place your database driver JAR file in this ext directory.
 # '''install.db.url''' should get the connection string for your database (for example, one for Oracle might look like jdbc:oracle:thin:@oraclebox:1521/ORCL )
 # '''install.db.password''' should be replaced with the plaintext password of the database user.
-                # '''install.db.driver''' needs the class name of the driver (for example, Oracleâs is oracle.jdbc.driver.OracleDriver if using ojdbc6.jar)
+                # '''install.db.driver''' needs the class name of the driver (for example, Oracle"s is oracle.jdbc.driver.OracleDriver if using ojdbc6.jar)
-                # '''install.db.user''' should be replaced with the database userâs username.
+                # '''install.db.user''' should be replaced with the database user"s username.
 === %SERVER_HOME%\conf\spring-server\spy.properties ===
-                # Find line 42 (should say '''realdriver=orgâ¦''') and change the class name of the driver to match with what you specified in the ''install.db.driver'' line in '''installed.properties''' file.
+                # Find line 42 (should say '''realdriver=orgâ?¦''') and change the class name of the driver to match with what you specified in the ''install.db.driver'' line in '''installed.properties''' file.
 === %SERVER_HOME%\conf\base.xml ===
 # '''url''' should get changed to the connection string specified in installed.properties
-                # '''username''' should get changed to the database userâs username specified in installed.properties
+                # '''username''' should get changed to the database user"s username specified in installed.properties
-                # '''password''' should get changed to the plaintext database userâs password specified in installed.properties
+                # '''password''' should get changed to the plaintext database user"s password specified in installed.properties
 # Finally, ensuring that all the correct values are specified, you should be able to start your server and have it connect to the cloned database (or old database depending if you cloned the database or not).
 ## Note that if you have any production agents come online (e.g., you restart an agent) while the new instance is running and still set to bind to 0.0.0.0, that agent may bind to the new instance and not the production instance. To prevent accidental binding and/or upgrade, you can give the AnthillPro new instance a unique IP address and then tell its agents only to bind to that IP.
-                Either way, after the clone is complete, you are free to copy over the \var\ directory from the server to the new serverâs \var\ directory.  This will copy over all old artifacts, job logs, published reports, etc.
+                Either way, after the clone is complete, you are free to copy over the \var\ directory from the server to the new server"s \var\ directory.  This will copy over all old artifacts, job logs, published reports, etc.
 = Appendix A:  Validation Queries =