Oracle Java Cloud Service - SaaS Extension

All the productivity of Java, without the IT.

Using javacloud.properties

Using javacloud.properties

The file javacloud.properties can be used to specify command-line argument values for different commands. The file is not passed on the command line. The location of the file is implicit to the tool.

Where should I place javacloud.properties?

You can place it in any of the following locations:

  • User's home directory - You can place it in your home directory, which is returned by the System.getProperty( "user.home" ) call in Java.

    For example:

    • Windows - C:\Documents and Settings\<username>
    • Linux - /home/<username>
    • Mac - /Users/<username>
  • Current working directory - You can place the property file in the same directory where you execute java -jar javacloud.jar ...
    The property file located in the current working directory takes the precedence over the one available in the user's home directory.

What are the keys and values?

The keys are nothing but the argument names. You cannot specify argument shortcuts here. Arguments of multiple commands can be specified here. Unrecognized keys will be ignored.
The value specified is the value of the argument.

The keys can be specified in two forms:

  • Simple form - The name of an argument is specified as it is. For example, identitydomain=mydomain. This is applicable to all the commands that takes the argument identitydomain.
  • Full form - The argument name is specified along with the command name, for example, list-jobs.sorton=STATUS, where list-jobs is a valid command name and sorton is a valid argument supported by the command. This is applicable only to the command specified. The full form takes precedence over the simple form.

Can I specify password type arguments here?

No - Password type arguments cannot be specified here. The value for a password type argument is never read from this file. Please do not specify password type arguments here.

How are the argument values resolved?

The value of an argument is resolved in the following order:

  • Argument value, if specified in the command line.
  • Argument value, if specified in the property file.
  • Default value, if available, of the argument. Please check javacloud-usage.html for the default values.
If the value is not resolved for a mandatory argument, the command line will result in validation error.

Sample property file

File: javacloud.properties


#Note: Values specified here can be overridden on the command line.
user=your-user-name
identitydomain=your-id-domain
serviceinstance=your-svc
#Enable grid if you prefer grid display when applicable
grid=true
gridwidth=120
list-jobs.sorton=STARTTIME
list-applications.sorton=NAME
#Specify http proxy if you are behind a proxy
#httpproxy=your-proxy-host:port
#Enable classpath to be used when local is true. Use ; as the path separator on Windows platforms
#classpath=path-to-weblogic.jar:path-to-localextension.jar