AppServerMigration, an open-source software solution, analyses Java applications to deliver precise effort estimations in person-days, facilitating a seamless transition from source to target states. This tool adeptly identifies necessary modifications, offers insightful recommendations, and presents a comprehensive HTML report for a well-guided migration. It accelerates the migration journey, eliminating the necessity for re-work, ensuring a successful and efficient transition with minimal setbacks. AppServerMigration employs a rule-based analysis, meticulously examining Java applications according to predefined rules. This method ensures a thorough assessment, enabling precise identification of necessary changes and providing accurate effort estimations. Effort estimations in AppServerMigration leverate QSM's (Quantitative Software Management) industry-standard metrics and incorporate the backtracking technique. Customizations are then applied, drawing from firsthand migration experiences. This tailored approach ensures precise calculations, aligning with project nuances and enhancing the accuracy of migration effort predictions.
git clone git@github.com:awslabs/app-server-migration.git
cd app-server-migration
Prior to building the project, ensure that you have the following tools installed in your machine:
- Java 8
- Docker
- Maven
- Git
For Linux (Ubuntu, CentOS and RHEL) and Mac OS, you may execute the ./setup.sh
script to install the above dependencies.
For Windows, kindly follow their official documentation guide for installation.
- Java 8
- Docker
- Maven
- Git
Build the project using mvn package
command.
# Run Database
# During installation script may ask for password, enter your system password.
# After installation AurangoDB Web interface is accessible on http://localhost:8529 (using default user name: root and password: openSesame)
bash arangoDB.sh
# Run Analyzer
Option 1:
# This option is helpful when you want to check out projects from SCM and run the scan
# In this mode we provide repository details of projects(which needs to be scanned)
# in the configuration file and provide path of configuration file as shown below
./run.sh config:<path/to/configurationfile> <destination/path/> <ARANGO_USERNAME> <ARANGO_ROOT_PASSWORD> <Single or multiple comma separated rule names>
or
Option 2:
# This option is helpful when you already have source code downloaded on your machine
# In this mode we provide local path of the project
./run.sh source:<path/to/project> <destination/path/> <ARANGO_USERNAME> <ARANGO_ROOT_PASSWORD> <Single or multiple comma separated rule names>
e.g.
./run.sh source:/usr/example/project/ ~/test-directory root openSesame oracle-to-postgres,weblogic-to-tomcat
# Run Database (default root password will be openSesame)
powershell ./arangoDB.ps1 config:<path/to/configurationfile> <destination/path/> <ARANGO_USERNAME> <ARANGO_ROOT_PASSWORD>
# Run Analyzer
Option 1:
# This option is helpful when you want to check out projects from SCM and run the scan
# In this mode we provide repository details of projects(which needs to be scanned)
# in the configuration file and provide path of configuration file as shown below
powershell ./run.ps1 config:<path/to/configurationfile> <destination/path/> <ARANGO_USERNAME> <ARANGO_ROOT_PASSWORD> <Single or multiple comma separated rule names>
or
Option 2:
# This option is helpful when you already have source code downloaded on your machine
# In this mode we provide local path of the project
powershell ./run.ps1 source:<path/to/project> <destination/path/> <ARANGO_USERNAME> <ARANGO_ROOT_PASSWORD> <Single or multiple comma separated rule names>
e.g.
powershell ./run.ps1 source:/usr/example/project/ /usr/example/project/reports root openSesame oracle-to-postgres,weblogic-to-tomcat
You may create your own rules which can be fed to the rule engine in order to assess to your source files based on your rules. There are 2 files which you need to create rules.json
and recommendations.json
. For reference, you can check oracle-to-postgres-javarules.json and oracle-to-postgres-recommendations.json respectively.
The rules.json
file would look like:
{
"analyzer": "com.amazon.aws.am2.appmig.estimate.java.JavaFileAnalyzer",
"file_type": "java",
"rules": [
{
"id": 1,
"name": "Name",
"description": "Detailed Description",
"complexity": "minor",
"rule_type": "package",
"remove": {
"import": ["java.sql.DriverManager","oracle.jdbc.driver.OracleDriver"]
},
"recommendation": 12
},
]
}
Understanding each key of above JSON file:
analyzer
: Canonical name of the analyzer class. In the above example, we are using JavaFileAnalyzer.java. You may create your own Analyzer by implementingIAnalyzer
interface.file_type
: Type of source files which will be assessedrules
: Array of objects, each corresonding to arule
id
: Rule identifiername
: Name of the ruledescription
: A verbose rule descriptioncomplexity
: AppServerMigration identifies the complexity of migration per application either as minor, major or critical, depending on the features that need to be converted to make the application target compatible. If the changes are only in the configurations and not in the code, then it is minor. Major category involves code changes. There might be features specific to the source server which are not supported on the target server. In such scenarios, the whole functionality needs to be re-written. Such categories fall under critical complexity. For instance, trying to migrate a web application from Oracle WebLogic to Apache Tomcat, which has EJB code.rule_type
: Denotes where to search to find a rule match. In the above example rule, it will look forimport
statements to search for imported packages. The processing logic is coded in the Analyzer.remove
: Action denoting elimination of attributes present inside it. In the above example, the rule will match against anyimport
statement havingpackage
name eitherjava.sql.DriverManager
ororacle.jdbc.driver.OracleDriver
.recommendation
: Maps to the identifier of recommendation present in the associatedrecommendations.json
file.
The recommendations.json
file would look like:
"recommendations": [
{
"id": 1,
"name": "Replace Oracle database driver with Postgres database driver",
"description": "Review the driver being loaded in this block of code and change the driver from oracle.jdbc.driver.OracleDriver to org.postgresql.Driver"
},
]
Understanding each key of above JSON file:
recommendations
: Array of objects, each representing a recommendation.id
: Recommendation identifiername
: Name of the recommendation, which will be displayed on the reportdescription
: A verbose recommendation description, which will be displayed on the report
docker run -p 8529:8529 -e ARANGO_ROOT_PASSWORD=openSesame arangodb/arangodb:3.8.3
http://localhost:8529/
docker ps
To retrieve the HOST run the following command with container ID obtained from docker ps
docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' <<CONTAINER ID>>
docker stop CONTAINER_NAME
See CONTRIBUTING for more information.
This project is licensed under the Apache-2.0 License.