Version Differences for Comments:Cloning an AnthillPro Instance

(Initial Paste)
Line 1:
    + Process for Hooking Up AHP to Customer Databases  
    + by Brad Galla — last modified Jul 25, 2011 10:29 AM  
       
    + This is a short guide that instructs how to take a database received from a customer and have anthillpro connect to it so that it can be used.  
    + RETRIEVE DATABASE  
       
    + Have customer send fresh dump of database via FTP or Supportal Ticket  
    + Set up instance of Database's application with Database and prepare for usage (open any ports needed to connect; etc.)  
       
    +  
    + ASSEMBLE CONNECTION  
       
    + Install the version of anthillpro server that matches the version they were using with their database  
    + One method for finding this is analyzing the DB_VERSION table in the database.  
    + Use derby as the installation database; we will change this afterwards  
    + Install an agent that matches that version of the server (if necessary).  
    + Download/obtain the driver for the database type that was being used and copy it to the %SERVER_HOME%\lib\ext directory  
    + For example, if using Oracle, you could be using http://www.oracle.com/technetwork/database/enterprise-edition/jdbc-111060-084321.html (ojdbc5.jar)  
    + Modify the %SERVER_HOME%\conf\server\installed.properties file with the following values:  
    + install.db.schema=null  
    + install.db.url=[[database's url connection string]]  
    + install.db.password=[[database user's password]]  
    + install.db.driver=[[database driver's terminology name]]  
    + Example for oracle: oracle.jdbc.driver.OracleDriver  
    + install.db.user=[[database user's username]]  
    + install.db.type=[[type of database installed]]  
    + Example for oracle: oracle  
    + Modify %SERVER_HOME%\conf\spring-server\base.xml file and change any occurrences of:  
    + url to [[database's url connection string]]  
    + username to [[database user's username]]  
    + password to [[database user's password]]  
    + Modify %SERVER_HOME%\conf\server\spy.properties file by changing line 42:  
    + realdriver=[[database driver's terminology name]]  
    + After making the modifications above, navigate to the anthill installer that you downloaded and extract the conf.zip archive somewhere where you can access the files contained inside it. Grab any *.xml files that pertain to the database type (subdirectory would be the database type...for example 'oracle' for Oracle) and place them in the %SERVER_HOME%\conf\sql directory.  
       
    +  
    + UPGRADE PROCEDURE  
       
    + Place the database driver in the new anthill installer's lib\ext directory (create it if it doesn't exist) prior to running installation.  
    + Run the upgrade on the %SERVER_HOME% directory so that the old server gets upgraded.  
    + Start the upgraded server and proceed with the auto-agent upgrade through the UI to continue using anthillpro.  
       
    +  
       
    +  
    + CHANGES TO PROCEDURE  
    + If you should notice any errors listed in this procedure please immediately report them to bmg@urbancode.com citing a link to this page. Thanks.