RHAMT Web Console

Migration Tools Web Interface

License	License Public Domain
Categories	Categories JBoss Container Application Servers
GroupId	GroupId org.jboss.windup.web
ArtifactId	ArtifactId windup-web-ear
Last Version	Last Version 4.0.0.Beta2.1
Release Date	Release Date Jun 7, 2017
Type	Type ear
Description	Description RHAMT Web Console Migration Tools Web Interface
Project Organization	Project Organization JBoss by Red Hat

Download windup-web-ear

Filename	Size
windup-web-ear-4.0.0.Beta2.1.pom
windup-web-ear-4.0.0.Beta2.1.ear	266 MB
Browse

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.jboss.windup.web/windup-web-ear/ -->
<dependency>
    <groupId>org.jboss.windup.web</groupId>
    <artifactId>windup-web-ear</artifactId>
    <version>4.0.0.Beta2.1</version>
    <type>ear</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.jboss.windup.web/windup-web-ear/
implementation 'org.jboss.windup.web:windup-web-ear:4.0.0.Beta2.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.jboss.windup.web/windup-web-ear/
implementation ("org.jboss.windup.web:windup-web-ear:4.0.0.Beta2.1")

Apache Buildr

'org.jboss.windup.web:windup-web-ear:ear:4.0.0.Beta2.1'

Apache Ivy

<dependency org="org.jboss.windup.web" name="windup-web-ear" rev="4.0.0.Beta2.1">
  <artifact name="windup-web-ear" type="ear" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.jboss.windup.web', module='windup-web-ear', version='4.0.0.Beta2.1')
)

Scala SBT

libraryDependencies += "org.jboss.windup.web" % "windup-web-ear" % "4.0.0.Beta2.1"

Leiningen

[org.jboss.windup.web/windup-web-ear "4.0.0.Beta2.1"]

Dependencies

compile (2)

Group / Artifact	Type	Version
org.jboss.windup.web : windup-web-ui	war	4.0.0.Beta2.1
org.jboss.windup.web : windup-web-services	war	4.0.0.Beta2.1

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.11

Project Modules

There are no modules declared in this project.

Trying out MTA Web Console

If you just want to run MTA Web Console, not build or modify it, the simplest way is to use the docker image at https://hub.docker.com/r/windup3/windup-web_nightly/.

If you want to build MTA Web Console yourself and run it without setting up a WildFly server and Keycloak, you can build windup-web-distribution after building windup-web to create a self-contained distribution.

Setting up the development environment

Requirements

JDK 8
Maven 3.2.5+ (3.3.x recommended)

Environment setup

Set your local Maven setting.xml by copying file settings.xml from checked out sources into $HOME/.m2/ or use it directly while calling maven with option -s settings.xml
Install NodeJS Package Manager (npm)
- Debian/Ubuntu: sudo apt-get install npm
- RHEL 7: 1) Install EPEL 2) sudo yum install npm
- Fedora: sudo dnf install npm
NOTE: If npm is version is less than 3.8.8, try the following to force an update:
```
   sudo npm install -g npm
```
Install yarn package manager

Note: Check that your installed version of yarn is at least v0.22.0 (yarn --version)
Install Bower using NPM
- sudo npm install -g bower
- If you run into problems with permissions (typically EACCES error), use this guide to fix it.
- npm install command should be replaceable with yarn add.
- For global packages, use sudo yarn global add. Yarn should be faster, but if there is any problem with it, use NPM. Here is nice comparison of npm and yarn commands.

Get current version of phantomjs

if phantomjs is not installed yet, run

  sudo npm install -g phantomjs-prebuilt

  sudo npm install -g phantomjs-prebuilt --unsafe-perm

else run

  sudo npm update -g phantomjs-prebuilt

For development purpose and regular redeployment, raise the Metaspace limit. In wildfly-10.1.0.Final/bin/standalone.conf, change the MaxMetaspaceSize value to 2048:
```
JAVA_OPTS="-Xms64m -Xmx512m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=2048m -Djava.net.preferIPv4Stack=true"
```

Building the Windup project

To build Windup, you need to clone and build several git repositories:

If you want to contribute to Windup development, here is a script which clones the repositories, adds the upstream and sets up the remote tracking branches. First, you'll need to fork all the repositories to your user account. Then, change your GitHub.com user name in the script below.

GITHUB_USER="OndraZizka"
BASEDIR=$(pwd)
for i in \
windup \
windup-rulesets \
windup-quickstarts \
windup-distribution \
maven-indexer \
windup-maven-plugin \
; do 
    cd $BASEDIR
    git clone [email protected]:$GITHUB_USER/$i.git
    cd $i
    git remote add upstream https://github.com/windup/$i.git
    git fetch upstream
    git branch --set-upstream-to=upstream/master
    git pull
    mvn clean install -DskipTests
done
cd $BASEDIR

# Install NodeJS 6+
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt-get install -y nodejs
# Install NPM
sudo apt-get install npm
sudo npm install -g npm

#sudo apt install yarn
sudo npm install -g yarn
sudo npm install -g bower
sudo npm install -g phantomjs-prebuilt
## Then fix NPM permissions, basically by downloading and installing it just for one user…
## https://docs.npmjs.com/getting-started/fixing-npm-permissions

BASEDIR=$(pwd)
for i in \
windup-keycloak-tool \
windup-web \
windup-web-distribution \
; do 
    cd $BASEDIR
    git clone [email protected]:$GITHUB_USER/$i.git
    cd $i
    git remote add upstream https://github.com/windup/$i.git
    git fetch upstream
    git branch --set-upstream-to=upstream/master
    git pull
    mvn clean install -DskipTests
done
cd $BASEDIR

Running the webapp

Build: mvn clean install -DskipTests
Wildfly/EAP 7 must be run with -c standalone-full.xml as Messaging subsystem is required.
Execute the CLI script at: scripts/eap-setup.cli on Wildfly/EAP 7

bin/jboss-cli.sh -c --file=scripts/eap-setup.cli

Deploy the exploded services/target/mta-web/api and ui/target/mta-web to EAP 7.

There are 3 possible ways how to do it.

Manual copying:

cp -r services/target/mta-web/api ~/apps/wildfly-10.1.0.Final/standalone/deployments/mta-web/api.war;
touch ~/apps/wildfly-10.1.0.Final/standalone/deployments/rmaht-web/api.war.dodeploy;
cp -r ui/target/mta-web ~/apps/wildfly-10.1.0.Final/standalone/deployments/mta-web.war;
touch ~/apps/wildfly-10.1.0.Final/standalone/deployments/mta-web.war.dodeploy;

JBoss CLI deployment, deploy the target directory directly - see WildFly docs:

deploy services/target/mta-web/api --unmanaged;
deploy ui/target/mta-web --unmanaged;

Editing profile configuration and adding the following block to standalone-full.xml under <server>, at the end of the file:

<deployments>
    <deployment name="mta-web/api" runtime-name="api.war">
        <fs-exploded path=".../windup-web/services/target/mta-web/api"/>
    </deployment>
    <deployment name="mta-web" runtime-name="mta-web.war">
        <fs-exploded path=".../windup-web/ui/target/mta-web"/>
    </deployment>
</deployments>

Note: Replace ... with real absolute path on your local environment.

Follow the steps for deploying keycloak in Keycloak Setup
Access the webapp: http://localhost:8080/mta-web

Deploy your changes while coding

Follow the previous step (use the 3rd way of running the webapp: edit standalone-full.xml)
Install webpack: sudo npm install --global [email protected]. You can also install webpack-cli instead of webpack: sudo npm install --global [email protected]
Move to webapp folder: cd windup-web/ui/src/main/webapp
Execute webpack -w or webpack-cli -w

Adding Swagging Core

Swagger Core is an open source Java implementation of Swagger/OpenAPI.
It resolves JAX-RS annotated resources and Java annotated POJOs into OpenAPI schemas, handles serialization/deserialization and provides an integration mechanism.

To get the OpenAPI specifications file, you can compile this project enabling the swagger profile:

from windup-web/services folder execute the command mvn clean compile -Pswagger
in windup-web/services/target/swagger folder you'll find openapi.json and openapi.yaml files with the OpenAPI specifications

If you want to create a MTA Web application that provides the openapi.json and openapi.yaml files at runtime:

build this project enabling the swagger profile, executing -from windup-web folder- the mvn -DskipTests clean install -Pswagger command
the files will be available at http://localhost:8080/mta-web/api/openapi.json and http://localhost:8080/mta-web/api/openapi.yaml

Windup

Windup - upstream project for Red Hat Application Migration Toolkit

Versions

Version
4.0.0.Beta2.1 Jun 7, 2017

RHAMT Web Console

License

Categories

GroupId

ArtifactId

Last Version

Release Date

Type

Description

Project Organization