iwodstart - Return Values

Hi All,

We are trying to invoke the command iwodstart from a perl script. Based on the return value of the command we have a success loop as well as a failure loop in our perl script.

What are the possible return values for the command iwodstart. If there are many what is the success value?

We are usign Interwoven Teamsite version 5.5.2

Thanks in Advance.

Find more posts tagged with

Comments

Dwayne

You don't say what platform (Windows, Solaris) or which version of OpenDeploy.

I believe that, for the Windows version at least, there is a problem with the iwodstart that "lives" in the bin directory - it doesn't set error levels can can be detected via your script. So, as far as your code is concerned, every deployment would succeed. This may be a result of the fact that iwodstart is actually a batch file (.cmd) rather than an executable.

There's a perl script in the solutions directory that can be used as a replacement for iwodstart.cmd. This one does set error levels correctly.

I don't know if any of this is required with the non-Windows implementations of OpenDeploy.

As far as the meaning of the various return codes: I don't remember off the top of my head, other than zero(0) is success, and various non-zero values mean different sorts of failures.

--

Current project: TS 5.5.2/6.1 W2K

Adam Stoller

To clarify a bit:

OD 5.x where x < 6:

Windows
- NT: Use ODHOME/solutions/perl/iwodstart.ipl rather than ODHOME/bin/iwodstart.bat (I can't remember whether it's a .bat or a .cmd file - I think it's .bat)
- 2000(+): Use either iwodstart.ipl or iwodstart.bat
Unix
- Use ODHOME/bin/iwodstart

OD 5.6 or later

Any OS
- Use ODHOME/bin/iwodcmd start

I'm pretty sure that iwodcmd will work on Windows correctly - if not, you'll have to go back to using ODHOME/solutions/perl/iwodstart.ipl

As for exit values - if you run '-h' on the iwodstart or iwodcmd (with the 'start' mode-flag) CLTs you'll see: exit code:
0 - succeeded
1 - starting of the deployment failed
2 - deployment ran and returned a failed status
9 - deployment completed with errorsHope that helps

--fish
Senior Consultant, Quotient Inc.
http://www.quotient-inc.com

Migrateduser

Hi All,

Thanks for your reply.

The Teamsite server is on Solaris.

Now, I have another issue. How do I trap the return value of the iwodstart command?

Here's the test script that I wrote...

#!/opt/iw-home/iw-perl/bin/iwperl -w

my $com = "/opt/iw-home/OpenDeployNG/bin/iwodstart somebranch";
my $result= `$com`;
print "The Result is $result";

The result is getting printed as the entire chunk of string instead of just 1 or 2 or 9.

Please let me know how to trap the actual return values of iwodstart from the perl script.

Thanks in advance.

pras_tm

Dwayne

The backtick operator (``) is designed to give you the text that the child process sent to STDOUT, so your script is doing exactly what you told it to do.

The $? variable contains the return code from the last backtick or system call that's been run. So try something like this:

#!/opt/iw-home/iw-perl/bin/iwperl -w

my $com = "/opt/iw-home/OpenDeployNG/bin/iwodstart somebranch";
my $result= `$com`;
print "The Result is $result\n";
print "The return code is $?\n";

Current project: TS 5.5.2/6.1 W2K

Migrateduser

Hi Dwayne,

I tried executing the script with $?. It is always returning 256. I am not sure why. Please find below the modified. Actually, it is the same code that you had posted. Anyways, I am giving it here just for the reference.

my $com = "/opt/iw-home/OpenDeployNG/bin/iwodstart somebranch";
my $result= `$com`;
print "The Result is $result\n";
print "The return code is $?\n";

Find below the results after executing this script.

###################################################################################
***ERROR - Starting deployment.
Reason from server: DEPLOY_CONFIG_FILE
Details : Deployment config file not found (/opt/iw-home/OpenDeployNG/conf/somebranch.xml)

The Result is
Locating OpenDeploy service.
OpenDeploy server host: localhost, RMI registry port: 9173
Got OpenDeploy service.
>>>>>-- Start deployment somebranch.
iwodstart running in default synchronous mode.
Need to wait for deployment to complete.

The return code is 256

Dwayne

It's doing exactly what it's supposed to do. Had the deployment succeeded, then the return code would have been 0.

If you want the return code (256, in this case) to match the actual return code set by the child process, then divide by 256 (or shift by 8 - same thing). So, in your case, iwodstart used a call of exit 1.

--

Current project: TS 5.5.2/6.1 W2K