Start App Studio

Version 4.1 and later

App Studio has two scripts for startup and shutdown in the root directory of an App Studio project (app-studio):

  • app-studio.sh – A Bash script for Linux and macOS

  • app-studio.bat – A batch file for Windows

You also use these scripts to build an app from source.

Obtain usage information about the scripts

For usage information, enter:

  • Linux and macOS: ./app-studio.sh -help

  • Windows: app-studio.bat -help

For command-specific usage information, enter:

  • Linux and macOS: ./app-studio command -help

  • Windows: app-studio.bat command -help

Below, optional parameters are indicated by square brackets, which you don’t type.

Startup commands

  • Linux and macOS: ./app-studio start [--production] [-f] [-p port] [-m memory] [-t timeout] [-V]

  • Windows: app-studio.bat start [-f] [-p port] [-m memory] [-t timeout] [-V]

Parameters

Bold italic text is a placeholder for a value. For example, for -m memory you might use -m 4g.

Parameter Description

--production

Start the app in production mode, which disables the configuration wizard and the code editor.

-f

Start App Studio in the foreground. By default, App Studio starts in the background.

-p port

Specify the port on which the App Studio web server will listen. The default port is 8080.

-m memory

Set the minimum (-Xms) and maximum (-Xmx) heap size for the JVM. For example, -m 4g results in: -Xms4g -Xmx4g. The default heap size is 512m.

-t timeout

Set the startup timeout in seconds.

-V

Output verbose messages from the script.

Starting multiple App Studio instances

You can run multiple instances of App Studio on a single host by specifying different ports for all instances. Do this on startup, at the command line, using the -p parameter, for example:

./app-studio.sh start -p 9000

Version 4.0

Before starting App Studio, verify that Fusion Server is running and that it has one or more collections of indexed data.

Run App Studio at the command line from the app-studio directory, like this:

Unix Windows

Start the server

./app-studio.sh start

Options:

  • --production

    Run the server in production mode.

  • --extraJvmArguments

    Space character-delimited additional JVM arguments; multiple arguments must be quoted. Example: "-Xms2G -Xmx5G"

  • -p or --port

    The port on which to run the server.

  • -s or --stop-port

    The port to use when issuing the stop command; it must be re-specified when running stop.

app-studio-start.bat

Stop the server

./app-studio.sh stop

Optionally:

  • -s or --stop-port

    The port to use when issuing the stop command.

app-studio-standalone-stop.bat

Restart the server

./app-studio.sh restart

app-studio-stop.bat
app-studio-start.bat

Starting in production mode

App Studio’s standalone mode can be used for small production deployments, by starting in production mode.

Production mode disables the configuration wizard and the code editor.

To use standalone mode in a production environment, start App Studio with the --production flag:

./app-studio-standalone.sh start --production

What’s next