Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
maxLevel2

The FlexDeploy Virtual Machine provides fully configured and executable samples, enabling users to examine the features and use as reference for full implementation.

Virtual Machine Configuration

  • 1 CPU
  • 4 GB RAM
  • FlexDeploy installed on Tomcat 8.5.15
  • Oracle XE database with FlexDeploy schemas installed
  • Two Tomcat 8.5.15 servers for deploying sample applications
  • Apache JMeter for unit testing sample applications
  • Connection to GitHub repository containing sample source code

Install Oracle VirtualBox

Download and Install Oracle VirtualBox from https://www.virtualbox.org/wiki/Downloads. Next steps will explain how to use FlexDeploy OVA image file with VirtualBox.

Importing VM Appliance

These The steps are for shown use Oracle VM VirtualBox for the Host, but there are other options. Feel free to use any host capable of importing OVA images. You may need to unzip the file you downloaded before you are able to import it.

  1. Open VirtualBox. 
    Open VirtualboxImage Removed

    Image Added

  2. Click File - Import Appliance. 

    Import applianceImage RemovedImage Added

  3. Select the VM image (.ova file), Click Next. 
    Select Appliance to importImage Removed File name of ova file depends on the version of FlexDeploy you have downloaded.

    Image Added

  4. Click Import
    1. It is here where settings can be adjusted, you can change the VM name or give it more CPU, etc
    2. If Memory is reduced below 3 GB, the VM will not work correctly 

      Click ImportImage RemovedImage Added

       Once Import

Starting FlexDeploy VM  

  1. Once the Import process has finished, start the VM.
    1. This can be done by clicking on the VM and clicking start Start on the top bar OR
    2. Right click on the VM, go to Start > Normal Start 

      Start the VMImage Removed

  2. Once the system has started, login with provided credentials. You can login using putty as well, just use port 222.

    LoginImage Removed

  3. Run start command.
    1. ./start_flexdeploy.sh
    2. Because the database can take some time to initialize there may be a small delay, the startup script will let to you know it's waiting to connect 

      Start FlexdeployImage Removed

      Flexdeploy startedImage Removed

      .
      Image Added 
  4. Once the virtual machine has started, FlexDeploy tomcat server will also automatically start and you will see screen shown below and you can login using http://localhost:8000/flexdeploy. It takes some time for Tomcat server to start application, so give few minutes before you launch application in browser.

    Image Added

    Tip

    FlexDeploy can be started using start_flexdeploy.sh script as well. Login using flexuser/flexdeploy1 credentials. You can do this on Virtual Box window or using Putty (localhost with port 222).


  5. After few minutes, Open your browser to http://localhost:8000/flexdeploy. 
  6. Once FlexDeploy has loaded, you can log in and explore. FlexDeploy User credentials are fdadmin/welcome1

    LoadingImage Removed

    Log in and exploreImage Removed

    LoadingImage Added


    Log in and exploreImage Added

Stopping FlexDeploy VM

  1. Run stop command.
    1. Start SSH session on port 222 and login as flexuser.
    2. cd
    3. ./stop_flexdeploy.sh
  2. Power Off VM in VirtualBox Manager. 
    Image Added

Installation Details

Credentials

Note

Once you have started your VM, it is HIGHLY recommended that you change the default passwords.

...

FlexDeploy Credentials

FlexDeploy UserPasswordFlexDeploy GroupDescription
fdadminwelcome1FD AdministratorsThe default FlexDeploy admin user. The FD Administrators group has all available permissions in FlexDeploy.
operatorwelcome1OperatorsThe operator user can manage projects, create or update notifications, scheduled tasks, and windows, as well as approve deployments to the Production environment.
developerwelcome1DevelopersThe developer user has permission to build projects, and deploy applications to the Development environment.
releasemanagerwelcome1Release ManagersThis user can create or update releases and pipelines, as well as creating a new snapshot for a release.

Other Credentials

Account TypeUserPassword
Tomcat Management Consoletomcattomcat
Linux VM Operating Systemflexuserflexdeploy1
Databasefd_adminwelcome1
DatabasesysFL289267Vx

Ports

You can SSH using port 222 and if you interested in running Queries using SQL Developer connect to database on port 1525. See port mapping details below.

Image Removed

Folders

...

Host Port
Purpose
Port in VM
8010DEV Tomcat Server8090
8020PROD Tomcat Server8070
8000FlexDeploy Server8000
222SSH Daemon22
1525Database Instance1521

Image Added

FlexDeploy Details

PropertyValue
Root Installation Directory/u01/app/flexdeploy
Server Working Directory/u01/app/flexdeploy/working
Artifact Repository/u01/app/flexdeploy/artifacts
FlexDeploy Tomcat Installation Directory/u01/app/flexdeploy/apache-tomcat-flexdeploy
FlexDeploy Tomcat Logs directory/u01/app/flexdeploy/apache-tomcat-flexdeploy/logs

...

Tomcat Development Server

PropertyValue
Catalina Base/u01/app/DEV-tomcat
Catalina Home/u01/app/DEV-tomcat
Catalina Temp/u01/app/

...

DEV-tomcat/temp

Tomcat Production Server

PropertyValue
Catalina Base/u01/app/PROD-tomcat
Catalina Home/u01/app/PROD-tomcat
Catalina Temp/u01/app/PROD-tomcat/temp

Application URLs

URL
Application
http://[host]:8000/flexdeploy

...

FlexDeploy Application
http://[host]:8010/petclinicPetClinic on DEV
http://[host]:8020/petclinicPetClinic on PROD
http://[host]:8010/jetDemoJetApp on DEV
http://[host]:8020/jetDemoJetApp on PROD


Info

The hostname of the virtual machine is flexdeploy, however, some network configurations do not allow access using a hostname. If you are unable to connect to FlexDeploy, try using the IP address of the host machine in place of [host] in the examples above.

Expand
titleClick here to show info about finding your IP address...
  • If the host machine is running Linux run this command:

    Code Block
    ifconfig | grep -Eo 'inet (addr:)?([0-9]*\.){3}[0-9]*' | grep -Eo '([0-9]*\.){3}[0-9]*' | grep -v '127.0.0.1'


  • For Windows, run this:

    Code Block
    ipconfig | find "IPv4 Address"


  • You should see one or more IP addresses printed off, one of these will be the address to connect to.

Please note that you will be unable to connect to the virtual machine from the host machine using an IP address or hostname, to connect from the host machine, replace [host] with localhost.

Include Page
FlexDeploy Demo Details
FlexDeploy Demo Details