Versions Compared

Old Version 1

changes.mady.by.user Former user

Saved on

compared with

New Version Current

changes.mady.by.user Stonebranch

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Anchor
Installing Universal Agent for SOA
Installing Universal Agent for SOA
Installing Universal Agent for SOA

Step 1

Download the Universal Agent for SOA for Windows product distribution file, sb-soa-6.7.0.<level>-windows-x64.exe, to your work station.

Anchor
execute
execute
Step 2

Execute the distribution file from the command line, and include all appropriate command line switches and parameters.
 
The installation process determines whether a Windows Installer update is needed. The process then extracts and saves a Windows installer package file (.msi) to this location.
 
After all files (including the .msi) are extracted from the distribution file, the installation process verifies that your machine meets the minimum installation requirements. If the requirements are met, the installation begins.

Anchor
Command Line Syntax
Command Line Syntax
Command Line Syntax

The following illustrates the command line syntax used to install Universal Agent for SOA:

Panel
sb-soa-6.7.0.-windows-x64.exe [/v"command line parameters"] [/s] [/w] [/x]

In this syntax:

  • <level> is the numeric package level.

...

The following table describes the command line switches available for a command line installation:
 

Anchor
/v
/v
/v

Passes parameters to the Windows Installer (msiexec).
 
The list of parameters must be enclosed in double (") quotation marks. See

#Command

Command Line Parameters for available parameters.

Anchor
/s
/s
/s

Suppresses the initialization and extraction dialogs displayed before the product install Welcome dialog."
 
If you are using the #/q command line parameter, use this switch additionally for a completely silent install.

/w

Instructs the Windows Setup application to wait until the installation completes.
 
Use this switch when launching the installation from a script file. Without it, the Setup application may return immediately after launching Windows Installer.

/x

Uninstalls Universal Agent for SOA for Windows.

Anchor
Command Line Parameters
Command Line Parameters
Command Line Parameters

...

The parameters can be specified in any order, with the following exceptions:

  • If the Repair (#/fom) or Remove (#/x) parameter is used, it must be specified before all other parameters.
  • If the Silent install (#/q) and/or Log file (#/L) parameters are used, they can be specified in any order, but they must be specified after all other parameters.

These parameters are preceded by the #/v command line switch and must be enclosed in double (") quotation marks.
 

Parameter

Description

Default

Anchor
/fom
/fom
/fom

Repairs a Universal Agent for SOA for Windows installation.
 
om (after the /f) are options used by the repair. There are other options available, but for behavior that matches the repair done from the graphical install, the om options must be used.
 
/fom cannot be used with the /x (remove) parameter.

n/a

Anchor
/x
/x
/x

Removes a Universal Agent for SOA for Windows installation.
 
/x cannot be used with the /fom (repair) parameter.

n/a

INSTALLDIR=installdir

Sets the root installation directory to <installdir>. All components are installed in this directory.
 
INSTALLDIR is required if you want to install Universal Agent for SOA for Windows under a directory different from the one specified by the PROGRAMFILES environment variable (typically C:\Program Files\Universal). If the directory contains spaces, you must use double (") quotation marks around the path name.

(none)

/q

Suppresses the product installation dialogs.
 
Use this parameter in addition to the

#

/s command line switch for a completely silent install.
 
See

#Command

Command Line Switches,

#Command

Command Line Installation Examples, and

#Detecting

Detecting the Completion of a Silent Install for additional information regarding silent installs.

n/a

/L*v

Instructs the installation process to create an installation log file named <logfilepath> (full path name). If <logfilepath> contains spaces, you must enclose it with double ( " ) quotation marks.
 
*v are flags used to specify the level of detail (verbose) contained in the log file. To reduce the amount of output generated, *v can be omitted. However, using these options is good practice; they can assist Stonebranch Customer Support with problem determination should any errors occur during installation.

n/a

Anchor
Command Line Installation Examples
Command Line Installation Examples
Command Line Installation Examples

...

To install all Universal Agent for SOA components via the graphical user interface, issue the following command:

Panel

...


Html bobswift
<pre>
sb-soa-6.7.0.x-windows-x64.exe
</pre>



Silent Install

To silently install all Universal Agent for SOA components, issue the following command:

Panel

...


Html bobswift
<pre>
sb-soa-6.7.0.x-windows-x64.exe /s /v"/qn"
</pre>



Graphical User Interface Install, All Components, with Log File

To install all Universal Agent for SOA components using the Windows Installer graphical user interface and write a log file to C:\temp\install.log during the installation, issue the following command:

Panel

...


Html bobswift
<pre>
sb-soa-6.7.0.x-windows-x64.exe /v"/l*v C:\Temp\install.log"
</pre>



Silent Install, Different Installation Directory

To silently install all Universal Agent for SOA components to a non-default location, issue the following command:

Panel


Html bobswift
<pre>
sb-soa-6.7.0.x-windows-x64.exe /s /v"/qn INSTALLDIR=D:\Universal"
</pre>


Anchor
Detecting the Completion of a Silent Install
Detecting the Completion of a Silent Install
Detecting the Completion of a Silent Install

...

For example, from the command prompt, issue the following command to start the Universal Agent for SOA installation and wait for it to finish:

Panel


Html bobswift
<pre>
start /b /wait sb-soa-6.7.0.x-windows-x64.exe /w /s /v"/qn"
</pre>


  • The /b switch prevents the start command from opening a new window.
  • The /wait parameter causes the start command to start the application, sb-soa-6.7.0.x-windows-x64.exe, and then wait for it to finish.

...