Command-line interface

Prerequisites

The following prerequisites are required to use the command line tools:

• Windows®, Linux®, or Mac operating system
• Java SE Development Kit (JDK) 5.0 or 6.0

  IBM employees should download the Java SDK from the IBM internal site.

Installation

1. Download the zero-<version>.zip . Accept the license agreement, then click zero-<version>.zip to download.
2. Unzip zero-<version>.zip into any directory. The root directory after unzipping is called zero. Refer to this directory as <zerohome> .

   WebSphere sMash does not support double-byte character sets on the installation path.

3. Configure the Java command by setting the environment variable JAVA_HOME.
   
   The zero scripts determine the Java command to use by first using the environment variable JAVA_HOME. JAVA_HOME should be set to the directory where the JDK is installed. The scripts append bin/java to JAVA_HOME and verify whether the file exists. If JAVA_HOME is not set, or if ${JAVA_HOME}/bin/java does not exist, then the script uses the Java command found using the configured path. The recommendation is to set JAVA_HOME.
4. If a proxy is required to access external sites, then modify the zero scripts for the proxy. For example, set the proxyHost and proxyPort. The zero commands will download required modules, so ensure the proxy is configured.
5. (Optional) Add <zerohome> to the PATH environment variable.
6. If you plan to use the App Builder, you can proceed to the App Builder Quick-start tutorial section of this guide. If you would like to try out the command line, proceed to Getting started, below.

Getting started

The instructions below show you how to create a simple application using the command line interface.

1. Open a command prompt.
2. Type the following:

   zero create demo

   This creates a new WebSphere sMash application, which is created in a new subdirectory named demo.

3. Change directory into demo .
4. Type zero start to start the application. Log messages are printed showing that the HTTP adapter has started, as shown in the following screen capture:
   
   
5. Open a browser and type http://localhost:8080/. A default page is shown with status and links for additional information, as shown in the following screen capture:
   
   
6. The application you just created is using port 8080 for communication. All WebSphere sMash applications use port 8080 by default, but only one application can use it at a time. Stop this application using zero stop to free the port for use by another WebSphere sMash application.

Adding PHP support (Optional)

If you want to add PHP support for your application, complete the following steps:

1. Stop the application.
   zero stop
2. Add the PHP dependency to the application. Within your application's directory, edit config/ivy.xml . Add the entry <dependency name="zero.php" org="zero" rev="[1.0.0.0, 2.0.0.0["/> to the dependencies element.
3. Find the new dependency and associate it with your application. This step is called resolving the dependency.
   zero resolve
4. Add PHP scripts to the application's public directory.
5. Optionally, modify the settings in the PHP configuration file config/php.ini .
6. Start the application.
7. From the browser, type "http://localhost:8080/<name of script>.php" to run the script.