Getting Started Guide

Get RapidDeploy running in 5 minutes.

1. Downloading

You can download the RapidDeploy binaries from the download page (click on the button to the right) by selecting from the appropriate Windows, Linux or Mac OS/X distribution for your architecture.

rapiddeploy

Download RapidDeploy from the download pages.

2.Installing and Starting RapidDeploy

The software distribution is shipped with an embedded hypersonic database (HSQL-DB) and is preconfigured to use this database for the community edition. The framework server application is a web application and runs within a Tomcat 9 application server running on Java 1.8, both also shipped in the software distribution. Therefore the basic installation is to simply unzip the MidVision binary to a directory of your choosing. This will create a midvision directory structure.

Start and stop scripts for the web application are contained within the midvision bin directory. Running these scripts will, by default, extract a Java Runtime Environment specific to your platform and start the Tomcat Server which in turn will deploy the framework server including RapidDeploy and HSQL-DB.

3. Verifying Startup

3.1 Access the RapidDeploy Web Application

By default the framework server web application is configured to listen on port 9090. The quickest verification is to navigate to your host address in a web browser:

e.g

http://host-address:9090/MidVision

You should then see the MidVision login prompt

The default username/password is: mvadmin/mvadmin  It is recommended that you change this password at the earliest opportunity.

3.2 Stopping RapidDeploy

By default, RapidDeploy comes pre-configured with an in-memory database. When using this database, you need to stop RapidDeploy using the provided script, which will write the in-memory data to a file. Killing RapidDeploy by another means may result in data loss when using the in-memory database. We recommend using an enterprise database such as Oracle or DB2 if running RapidDeploy in a production setting.

Navigate to the  ${MV_HOME}/bin  directory.

stop-web-app.bat (double click the icon on windows)
./stop-web-app.sh (execute as written on Unix, Linux, Mac OS/X)

3.3 Licensing

 The RapidDeploy community edition comes with a community license and can be used for free for the free usage tier. When you try to enter an additional endpoint above the free usage tier, you will be prompted to enter a license key.

Once you have reached the limit of the free usage tier (number of endpoints), you will be presented with a license form. You should apply for a new license key from MidVision. Please send an email to sales@midvision.com.  When you receive the key, simply paste in the sections of the key into the appropriate input fields on the form, no formatting is required.

3.4 Troubleshooting

The basic installation typically works straight out of the box. Logfiles should be investigated and some platform features should be noted

Logfiles are located in ${MV_HOME}/logs. There are 2 files that you may need to investigate in the event of problems

rapiddeploy-web-app.log
hsqldb-web-app.log

4. Common Installation Problems

4.1 Installations on IBM AIX

AIX typically does not apply appropriate permissions to execute scripts and binaries for newly created files. In that instance when the software distribution package is unzipped the start-web-app.sh and stop-web-app.sh scripts are not executable. Furthermore when the start script is run, if you are relying on the shipped Java Runtime Environment you may need to ensure that the Java executable is executable (this is extracted from a zip file the first time the start-web-app.sh is run). Therefore you may need to run a chmod command a number of times.

e.g.

chmod -R 755 MV_HOME

4.2 Port Conflicts

The RapidDeploy ports may already be in use by other applications, preventing the Tomcat server from starting. See advanced configurations for details about changing ports. HSQL uses port  9001 . The framework server GUI application uses ports  9090, 8005 ,  9443

4.3 JVM Heap exhaustion causes the start script to fail silently

The RapidDeploy application sets the minimum heap size to 1024M. If your system cannot provide this level of heap, the start-web-app.bat or start-web-app.sh script  may fail silently as the JVM crashes. Ensure you have enough heap, or  edit the start-web-app.bat/sh script and amend  JAVA_OPTS as follows:

e.g. change:

export JAVA_OPTS="-Dcom.sun.xml.bind.v2.bytecode.ClassTailor.noOptimize=true -Xms1024m -Xmx1024m -XX:NewSize=512m -XX:MaxNewSize=512m -XX:MetaspaceSize=100m -XX:+CMSClassUnloadingEnabled -XX:+UseConcMarkSweepGC -XX:+CMSParallelRemarkEnabled -XX:+UseCMSInitiatingOccupancyOnly -XX:CMSInitiatingOccupancyFraction=70 -XX:+ScavengeBeforeFullGC -XX:+CMSScavengeBeforeRemark -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=$MV_HOME/logs/midvisionhd1.hprof -DMV_HOME=$MV_HOME -Drapiddeploy.properties=$MV_HOME/bin/rapiddeploy.properties -Djava.net.preferIPv4Stack=true"

to:

export JAVA_OPTS="-Dcom.sun.xml.bind.v2.bytecode.ClassTailor.noOptimize=true -Xms256m -Xmx1024m -XX:NewSize=512m -XX:MaxNewSize=512m -XX:MetaspaceSize=100m -XX:+CMSClassUnloadingEnabled -XX:+UseConcMarkSweepGC -XX:+CMSParallelRemarkEnabled -XX:+UseCMSInitiatingOccupancyOnly -XX:CMSInitiatingOccupancyFraction=70 -XX:+ScavengeBeforeFullGC -XX:+CMSScavengeBeforeRemark -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=$MV_HOME/logs/midvisionhd1.hprof -DMV_HOME=$MV_HOME -Drapiddeploy.properties=$MV_HOME/bin/rapiddeploy.properties -Djava.net.preferIPv4Stack=true"

4.4 Contacting MidVision support

Please visit our support website.