Topic
  • 5 replies
  • Latest Post - ‏2012-09-25T11:00:06Z by Jacek_Laskowski
Jacek_Laskowski
Jacek_Laskowski
133 Posts

Pinned topic Why is run not listed in server help?

‏2012-09-06T10:52:12Z |
Hi,

I seem to be unable to find it anywhere explained, but I can run a server with run action so the server runs in foreground. Why is this not listed in server help? Are there any other commands available?

[root@was8 wlp]# ./bin/server help Usage: ./bin/server action serverName [options] serverName A locally unique name 

for the server; the name can be constructed using ASCII alphanumeric characters (A-Za-z0-9), the underscore (_), dash (-), and period (.).   Actions:   create Create a 

new server 

if the specified server does not exist.   dump Dump diagnostic information from the server into an archive.   

package Package a server to an archive.   start Start the named server.   status Check the status of the named server.   stop Stop the running instance of the named server.   version Show server version information and exit.   Options:   --archive=
"path to the target archive file" Specify the archive target to be generated by the 

package or dump action. The target can be specified either as an absolute path or as a relative path. If 

this option is ommitted, the archive file will be created in the server output directory. The target file name extension may influence the format of the generated archive. The 

default archive format 

for the 

package action is 
"pax" on z/OS and 
"zip" on all other platforms.   --clean Clean all cached information related to 

this server instance.   --include=all/usr Specify whether packaging all the files in the wlp installation directory or only the files in usr directory. If the WLP_USER_DIR, WLP_OUTPUT_DIR are set in server.env file, the files under them are packaged. The files linked in the config files are not processed, so may not be packaged.


Jacek
Japila :: verba docent, exempla trahunt
  • SystemAdmin
    SystemAdmin
    590 Posts

    Re: Why is run not listed in server help?

    ‏2012-09-06T11:52:59Z  
    Hi Jacek,

    The run command not being in the server help output was an oversight on our part. The command is documented in the README.TXT for the profile though.

    Other than the run command the server help outputs all the available commands.

    Thanks
    Alasdair
  • Jacek_Laskowski
    Jacek_Laskowski
    133 Posts

    Re: Why is run not listed in server help?

    ‏2012-09-06T21:20:40Z  
    Hi Jacek,

    The run command not being in the server help output was an oversight on our part. The command is documented in the README.TXT for the profile though.

    Other than the run command the server help outputs all the available commands.

    Thanks
    Alasdair
    Hi,

    Thanks for the answer. I checked the README.txt file and found that the debug is not in the list either.

    Jacek
    Japila :: verba docent, exempla trahunt
  • Jacek_Laskowski
    Jacek_Laskowski
    133 Posts

    Re: Why is run not listed in server help?

    ‏2012-09-24T12:05:27Z  
    Hi Jacek,

    The run command not being in the server help output was an oversight on our part. The command is documented in the README.TXT for the profile though.

    Other than the run command the server help outputs all the available commands.

    Thanks
    Alasdair
    Hi Alasdair,

    I also found today that there's status:fast command to use likely in scripts checking exit codes. Think it could be useful to announce, too.

    Jacek
    Japila :: verba docent, exempla trahunt
  • SystemAdmin
    SystemAdmin
    590 Posts

    Re: Why is run not listed in server help?

    ‏2012-09-25T10:25:43Z  
    Hi Alasdair,

    I also found today that there's status:fast command to use likely in scripts checking exit codes. Think it could be useful to announce, too.

    Jacek
    Japila :: verba docent, exempla trahunt
    Jacek,

    It is quite common for IBM products to have undocumented options. These options exist for a variety of reasons and there may be good reasons for them not being documented. As an example once we document an option we are bound to support that option and its behaviour for several releases. We can only remove it from the product after following a deprecation process which is documented in the infocenter here: http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-nd-mp&topic=rmig_deprecationlist

    Undocumented features are not a part of the product externals and are therefore subject to change without notice at any time. Unlike with the run and debug options which were documented, just not in server help, this option is not part of our externals and should not be used. The server script is documented in the infocenter here:

    http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-base-dist&topic=twlp_admin_script

    Alasdair
  • Jacek_Laskowski
    Jacek_Laskowski
    133 Posts

    Re: Why is run not listed in server help?

    ‏2012-09-25T11:00:06Z  
    Jacek,

    It is quite common for IBM products to have undocumented options. These options exist for a variety of reasons and there may be good reasons for them not being documented. As an example once we document an option we are bound to support that option and its behaviour for several releases. We can only remove it from the product after following a deprecation process which is documented in the infocenter here: http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-nd-mp&topic=rmig_deprecationlist

    Undocumented features are not a part of the product externals and are therefore subject to change without notice at any time. Unlike with the run and debug options which were documented, just not in server help, this option is not part of our externals and should not be used. The server script is documented in the infocenter here:

    http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-base-dist&topic=twlp_admin_script

    Alasdair
    Hi,

    A fair explanation. I've never looked at Liberty Profile as a product with the release process similar to other IBM products. Even though I'm also IBMer I was mistaken to think about Liberty Profile more as a fun (almost toy) server to use. It's always pleasant to work with it after days with the full WAS ;-)

    With that said, it's gonna be tough to judge when to report a finding - an unsupported feature - if it should stay as unsupported and hence only be known to a very limited number of people.

    Jacek
    Japila :: verba docent, exempla trahunt