FAQs

Wiki Home ▸ FAQs

Applications and Deployment FAQs

Q: How do I deploy an example Java application?
git clone https://github.com/cloudfoundry-samples/spring-music.git cd spring-music ./gradlew assemble cf push

If you are developing your own application with Maven:

vim manifest.yml # see https://github.com/cloudfoundry-samples/spring-music/blob/master/manifest.yml for reference
mvn clean package
cf push -n [hostname] # your application will be visible under [hostname].domain.com

Q: My application didn't run on CF. What should I do?

• Check if your jar is working:
  java -jar target/[jar-name].jar

• Check cf logs
  cf logs [app-name] --recent

• If you get ERR Instance (index 0) failed to start accepting connections...

  • try to change the memory in manifest to 512 MB or 1 GB; or
  • verify that you didn't use a specific port.

Q: How do I provision a sample (PostgreSQL) service?

cf create-service postgresql93 free spring-music-pg
cf bind-service spring-music spring-music-pg
cf restart spring-music

Q: How can I get a shell session for my application?

You can get a new container in Cloud Foundry containing your application code with the cf-ssh tool. See https://blog.starkandwayne.com/2014/07/14/running-one-time-tasks-in-cloud-foundry/

Q: How do I run Warden on the runner machine to troubleshoot a container?

On the jump box:

`bosh ssh runner_z1/0`
`export PATH=/var/vcap/packages/ruby/bin:$PATH`
`cd /var/vcap/data/packages/warden/<TAB>/warden`
`./bin/warden --socket /var/vcap/data/warden/warden.sock`

From that point, you can do the things as specified in [the Cloud Foundry troubleshooting docs] (http://docs.cloudfoundry.org/running/troubleshooting/troubleshooting-warden-services.html).

Q: Where do I get cf-ssh?

You can read a blog post about it or you can just do the following:

cd ~/bin  
wget https://raw.githubusercontent.com/danhigham/tmate-bootstrap/master/scripts/cf-ssh -O cf-ssh  
chmod +x cf-ssh 

Q: How do I view the current memory and disk usage of Cloud Foundry?

Log on to the jumpbox and run the dea_ads command.

Q: How do I view all the current logs within Cloud Foundry?

Log on to the jumpbox and run the nats_sub command.

Q: What languages and frameworks are inherently supported with Trusted Analytics Platform?
Java, python, nodejs, scala, go, ruby, PHP

Language Runtime Framework
Java Java 6, Java 7, Java 8 Spring Framework 3.x, 4.x
Ruby Ruby 1.8, Ruby 1.9, Ruby 2.0 Rails, Sinatra
Node.js V8 JavaScript Engine (from Google Chrome) Node.js
Scala Scala 2.x Play 2.x, Lift
Python Python
PHP PHP

Q: Does Trusted Analytics Platform support all common buildpacks traditionally supported with Cloud Foundry?
YES:

• java_buildpack java-buildpack-v3.0.zip
• ruby_buildpack ruby_buildpack-cached-v1.3.0.zip
• nodejs_buildpack nodejs_buildpack-cached-v1.2.1.zip
• go_buildpack go_buildpack-cached-v1.2.0.zip
• python_buildpack python_buildpack-cached-v1.2.0.zip
• php_buildpack php_buildpack-offline-v3.1.0.zip
• staticfile_buildpack staticfile_buildpack-cached-v1.0.0.zip

Q: What is the dependency of Trusted Analytics Platform on CDH?
The platform depends on CDH to provide big data capabilities and to be able to use the Analytics Toolkit (ATK). At this moment, TAP doesn't support any other distribution of Apache Hadoop.

Q: What tools can be used with the Analytics Toolkit?
The Analytics Toolkit can be accessed using Python. The Analytics Toolkit also requires CDH with Spark running on it.

Q: What data is supported in the Console > Data Catalog > Submit Transfer?
Any data set that is publicly available via http protocol, can be downloaded to TAP. Additional ways to obtain data include

• Client (Data producers) —> Websocket —> Kafka —> HDFS
• Client (Data producers) —> MQTT broker —> HDFS

Q: Where can I find a list of all supported CF commands?
All Cloud Foundry cli commands documentation can be found at www.cloudfoundry.org Also cf —help will list all available commands.

Admin and User Management FAQs

Q: In Console > User management, what is the difference between “space” and “organization”?
Hierarchy is that an organization contains a space. You can think of a space much like a department within an organization. There is no fixed meaning to space; you may use this subdivision as you wish. For instance, “dev”, “test”, or “prod” are be good spaces. a user must be a "space developer" in order to deploy applications.

Q: How do I add new services to Console > Marketplace?
There are Cloud Foundry commands to add services to Marketplace. Please refer to Cloud Foundry documentation for development of new services (how to code a new service).

Q: How much time should I give an application to re-stage?
It depends on the application start-up procedure. If the application start-up procedure is long, it will take time.

Q: How do I configure an application to automatically re-stage or deploy another instance of itself?

• Write scripts on Unix to automatically re-stage using cf command line.
• There is automatic pay increase or decrease instance. Cf command line can be used to deploy another instance.
• There are ample opportunities to write application-specific scaling scripts.

Open Source FAQs

Q. What is the governance model of this project?

It is our intention in the Trusted Analytics Platform engineering community to follow an open and democratic model found in many of the Apache Foundation's open source projects. The model is based on earned leadership.

As developers demonstrate their abilities by contributing new code and documentation to the Trusted Analytics project, and their contributions are acknowledged by the existing members by pulling their requests, the individual contributor will gain greater responsibility in decision-making of our project. See How the Apache Software Foundation Works

Q. What part of the project needs the most contributions?

Analytical Tooling

• The Analytics Toolkit
• The Analytics Toolkit Buildpack

Installer Tools

• Platform Parent

Others

• App Launching
• Service Catalog
• Data Acquisition

Q. What elements of this project are in use by other projects?

Many of the ~30 projects comprising the Trusted Analytics Platform depend on each other; some can stand on their own. All of the projects are developed in a way that should minimize the effort to use them independently.