Tivoli wep command

Performs actions on endpoint information contained in the endpoint list.

Syntax

wep

wep ep_label

wep ep_label get {suboptions}

wep help [option]

wep ls [-d delimiter][-g gw_label][-i suboptions]

wep ep_label migrate [-f] gw_label

wep migrate_to_pref {-a | -d|-n} [-f] [-g gw_label]

wep ep_label set {suboptions}

wep set gateway {-e ep_label | -g gw_label}

wep set interfaces {-e ep_label | -g gw_label} gw_label+port [:gw_label+port]...

wep ep_label set_config suboption

wep ep_label set_crypt_mode {DES|NONE}

wep ep_label set_label [-s] new_label

wep ep_label status

wep sync_gateways

wep ep_label upgrade {disable|enable}

Advanced Options

wep boot_method add tag prototype_object method_name ep_oid...

wep boot_method list tag ep_oid...

wep boot_method remove tag ep_oid...

wep boot_method test tag ep_oid...

wep del ep_oid gw_label...

wep view ep_oid gw_label...

Note:

Advanced options are described on Advanced Options.

Description

The wep command performs actions on the endpoint information contained in the endpoint list maintained by the endpoint manager. Using this command, you can list the endpoints in a Tivoli management region (Tivoli region) and their assigned gateway, retrieve and set endpoint information, migrate an endpoint from one gateway to another, or update other endpoint data within a Tivoli region.

The wep ep_label get command gets information for the specified endpoint, the wep ls -g gw_label command gets information for the specified gateway and its endpoints, and the wep ls command gets information for all endpoints on multiple gateways.

Note:

When specifying the object identifier (OID) of an endpoint, remember to append a plus sign (+) as shown in Examples.

Options

 

get {suboption,...}

Retrieves specific information from the endpoint list for the endpoint named ep_label. You can specify multiple suboptions by separating each with a comma.

Note:

You can shorten an attribute name, but the abbreviation must be unambiguous. For example, you can type last_l for last_login_time, but not last.

Suboptions are as follows:

 

address

Gets the network address.

 

all

Gets all attributes for the specified endpoint.

 

gateway

Gets the assigned gateway.

 

httpd

Gets the HTTP password. The HTTP password is used to modify endpoint information through a Web browser.

 

id

Gets the unique inventory identifier for the specified endpoint.

 

interp

Gets the interpreter type or operating system running on the specified endpoint.

 

label

Gets the endpoint label.

 

last_login_time

Gets the last login time of an endpoint.

 

last_method_time

Gets the time of the last method call on an endpoint.

 

last_migration_time

Gets the last time the endpoint migrated.

 

login_mode

For Windows operating systems only, displays whether the endpoint is enabled to control distributions using the Mobile Computing console. If the endpoint is operating in mobile mode, the endpoint is enabled. If the endpoint is operating in desktop mode, it is not enabled. This option also displays whether the user can change the endpoint mode.

Note:

To change an endpoint mode or to enable a user to change the mode of an endpoint, use the wep ep_label set login_mode command.

 

netload

Displays the current netload setting.

 

object

Displays the object ID of the specified endpoint.

 

policy

Displays the policy region in which the endpoint resides. If you have not added the endpoint to a policy region, the result of this command is OBJECT_NIL.

 

preferred_gateway

Displays the preferred gateway for the endpoint. If there is no preferred gateway for the endpoint, this command results in OBJECT_NIL.

 

protocol

Displays the network protocol used by the endpoint.

 

upgrade_mode

Displays whether the endpoint is enabled or disabled for upgrades.

 

version

Displays the version number of the endpoint.

 

help [option]

Displays the usage statement for the wep command. If you specify a wep option, such as wep help get, lists help for the specified option.

 

ls [-d delimiter][-g gw_label][-i suboption,...]

Lists information for gateways and their associated endpoints. Options are as follows:

 

-d delimiter

Changes the delimiter used in displaying data with the -i option. The default delimiter is a comma.

Note:

The HTTP password field does not contain tabs but can contain commas or other commonly used delimiters.

 

-g gw_label

Displays information only for the gateway specified by gw_label and its endpoints.

 

-i {suboption,...}

Retrieves additional information from the endpoint list for gateways and associated endpoints. Use suboptions listed for the wep get option. You can specify multiple suboptions by separating each with a comma. For suboptions and their descriptions, see the wep get option on ***.

Note:

You can shorten an attribute name, but the abbreviation must be unambiguous. For example, you can type last_l for last_login_time, but not last.

 

migrate [-f] gw_label

Migrates an endpoint from its assigned gateway to the gateway specified by gw_label. There is no contact with the endpoint. The endpoint detects that it was migrated the next time that there is communication between the endpoint and a gateway. Specifying the -f option forces the migration of an endpoint even if the gateway is down.

 

migrate_to_pref {-a | -d|-n}[-f] [-g gw_label]

Migrates endpoints to their preferred gateway if the gateway is available. This migration is similar to the wep migrate command. There is no communication with the endpoint. Only endpoint manager and gateway data are updated.

 

-a

Causes all endpoints to migrate to their preferred gateway.

 

-d

Displays a list of endpoints not currently assigned to their preferred gateway, but does not migrate.

 

-f

Forces migration, even if the preferred gateway is down.

 

-g gw_label

Restricts migrations to the preferred gateway specified by gw_label.

 

-n

Causes all nonmobile endpoints to migrate to their preferred gateway.

 

set {suboptions...}

Sets the following information for the endpoint named ep_label.

Note:

You can shorten an attribute name, but the abbreviation must be unambiguous. For example, you can type last_l for last_login_time, but not last.

Suboptions are as follows:

 

address ep_address

Changes the IP address of an endpoint.

 

httpd [user:password]

Sets the HTTP password for the specified endpoint. The HTTP password is used to modify endpoint information through a Web browser. You must use the sync_gateways option to synchronize changes between the endpoint, gateway, and endpoint manager after making password changes.

 

login_mode -m {mobile|desktop} -s {variable|constant}

For Windows endpoints with the Mobile Computing console, sets the operating mode of the endpoint specified by ep_label. Specify the -m mobile option to designate an endpoint as mobile. This option allows a user at the specified endpoint to receive and control MDist 2 distributions through the console. Specify the -m desktop option to disable console functions on the endpoint.

Note:

To synchronize changes with the gateway when setting login_mode, use the sync_gateways option.

Use the -s option to allow or prohibit users from changing the login mode of an endpoint. Specify the -s variable option if you want the endpoint to be able to change its login mode. If you specify the -s constant option, changes to the login mode are ignored. For more information about the Mobile Computing console, see the Tivoli Management Framework User's Guide.

 

preferred_gateway {gw_label|nil}

Sets the preferred gateway field to the specified gateway. Use nil to clear a preferred gateway.

 

upgrade_mode {enable|disable}

Sets whether the endpoint is upgradable.

 

set_config suboption

Allows you to set endpoint options from any managed node in the Tivoli region without having to stop and start the endpoint. You can specify only one of the following options on a single wep set_config command:

 

allow_proxy_upcalls={true|false}

Specifies whether all communication between the endpoint and its assigned gateway use the configured target port on the endpoint. If set to true, the endpoint and gateway communicate using the target port only. Before endpoint can use proxy upcalls, the endpoint must establish a connection to a proxy-capable gateway. If set to false, the endpoint and its assigned gateway communication as usual. This option modifies the value of the allow_proxy_upcalls in the last.cfg file. The default is false.

 

depot_dir=path

Specifies the directory on the identified endpoint where multicast distributions are stored until they are installed. This option modifies the value of depot_dir in the last.cfg file. The default directory is $LCF_DATDIR/depot. If a relative path is specified, the depot directory is relative to $LCF_DATDIR.

 

log_threshold=integer

Specifies the level of detail written to trace files for the identified endpoint. This option modifies the value of log_threshold in the last.cfg file. The integer value specified can be in the range of 1>=integer<=4, where 1 provides the least level of detail and 4 provides the most. The default logging threshold is 1.

 

set_crypt_mode {NONE|DES}

Specifies whether the endpoint uses 56-bit DES encryption when communicating with its gateway. When set to DES, the communication is encrypted. When set to NONE, the communication is not encrypted.

Note:

To synchronize changes with the gateway when setting set_crypt_mode, use the sync_gateways option.

 

set gateway {-e ep_label|-g gw_label}

Informs the endpoint of its currently assigned gateway. Use the -e option to update the endpoint specified by ep_label. Use the -g option to update all endpoints assigned to the gateway specified by gw_label.

 

set interfaces {-e ep_label | -g gw_label} gw_hostname+port gw_IP_address+port [:gw_hostname+port|:gw_IP_address+port]...

Sets the address and port of one or more gateways to which an endpoint can log in. This set of interfaces becomes the gateway list for an endpoint that the endpoint uses when it becomes isolated. Use the -e option to invoke this command on the endpoint specified by ep_label. Use the -g option to invoke this command on all the endpoints assigned to the gateway specified by gw_label. You can specify more than one gateway address. Multiple addresses must be separated by colons.

 

set_label [-s] new_label

Changes the current label (ep_label) of an endpoint to a new label specified by new_label. Use the -s option to synchronize the gateway and update the endpoint with the new label. This command contacts the endpoint.

 

status

Lists the status of the specified endpoint. An status for an endpoint can be either "alive" or "endpoint may be unreachable" if the status could not be determined. This command contacts the endpoint.

 

sync_gateways

Synchronizes the endpoint data stored by the endpoint manager, gateways, and endpoints within a Tivoli region. If you make changes to an HTTP password for the endpoint or policy region, change encryption settings, or decide to use one of the options listed in Advanced Options, you must use this option for updates to take effect. This option is useful in a scheduled job that updates several endpoint data updates at once.

Note:

To change the policy region of an endpoint, use the wmv command.

 

upgrade {disable | enable}

Specifies whether the endpoint is upgradable.

 

ep_label

Identifies the endpoint on which other wep suboptions are run. Without suboptions, wep ep_label displays all information for the endpoint in a tabular format.

Advanced Options

If you are not explicitly familiar with the advanced implications of the wep command, call your Customer Support provider before attempting to perform any of the following wep operations:

 

del ep_oid gw_label

Deletes the endpoint from an epmgr.bdb file. Because there are separate .bdb files for each gateway, it is necessary to specify the endpoint's assigned gateway. gw_label can be found by issuing the wep ls command. The wep del command does not completely delete all references to the endpoint. To delete all references to an endpoint, use the wdelep command.

 

view ep_oid gw_label

Displays endpoint information stored in the .bdb file associated with the gateway and located in the $DBDIR/epmgr.bdb directory. Unlike the wep ep_label command, the wep view command does not search the endpoint manager's internal cache. gw_label can be found by issuing the wep ls command.

The following commands are used to configure boot methods created by application developers (using Tivoli Application Development Environment [ADE]) to run on an endpoint. Use these options to configure boot methods during the installation of an endpoint or during the distribution of application profiles. These methods run every time an endpoint logs in to a gateway.

 

boot_method add tag prototype_object method_name ep_oid...

Adds the specified boot method to the endpoint, where:

 

tag

Specifies the user specified name.

 

prototype_object

Specifies the prototype OID, which implements the method.

 

method_name

Specifies the name of the method.

 

ep_oid...

Specifies the OID of one of several endpoints on which the method will run. Separate OIDs with spaces.

 

boot_method list tag ep_oid

Lists the prototype object number and method name of the specified boot method on the endpoint.

 

boot_method remove tag ep_oid...

Removes the specified boot method from the endpoint.

 

boot_method test tag ep_oid

Starts the specified boot method on the endpoint.

Authorization

• To view endpoint information with the wep ep_label, wep ep_label get, wep ep_label status, or wep ls command: user or admin
• To set the gateway for an endpoint with the wep set gateway -e command: senior or super
• To use the wep help command: user, admin, senior, or super
• To set the HTTP password with the wep ep_label set httpd command senior or super in the policy region of the endpoint.
• To view the HTTP password with the wep ep_label get httpd command: admin in the policy region of the endpoint.
• To migrate an endpoint, set all endpoints' gateway, or synchronize endpoint data with the wep migrate, wep set interfaces, wep set gateway -g, or wep sync_gateways command: senior or super in the Tivoli region

Examples

1. The following example lists the endpoints assigned to the jadams-gateway:

   wep ls -g jadams-gateway
    
        1122334455.1.512  jadams-gateway
        1122334455.10.500+ cookU
        1122334455.11.500+ cookA
        1122334455.12.500+ jadams
        1122334455.13.500+ jadamsM
        1122334455.15.500+ jadamsG
   

2. The following example returns all information contained in the endpoint list regarding endpoint cookG:

    wep cookG
    
                  object 1196743040.13.517+#TMF_Endpoint::Endpoint#
                   label ep7612
                 version 41000
                      id 001454ED4C00
                 gateway 1196743040.1.578
            pref_gateway OBJECT_NIL
                 netload OBJECT_NIL
                  interp aix4-r1
              login_mode desktop, constant
                protocol TCPIP
                 address garlic.dev.tivoli.com+7612+146.84.42.86
                  policy OBJECT_NIL
                   httpd tivoli:@+`t<XIr
                   alias OBJECT_NIL
              crypt_mode NONE
            upgrade_mode enable
         last_login_time 2000/11/17-11:11:08
     last_migration_time 2000/11/17-11:11:06
        last_method_time 2000/11/17-11:11:09
   

3. The following example returns the network address of endpoint cookG:

   wep cookG get lab,address
    
   cookG,146.84.26.26+9494
   

4. The following example returns the randomly generated HTTP password for endpoint cookG:

   wep cookG get httpd
    
   tivoli:WBHtK'y3 
   

   where:

    

   tivoli

   Represents the user name

    

   :

   Is the separator

    

   wBHtK'y3

   Represents the password

5. The following example returns the prototype object and method name of the test18 boot method on endpoint 1802218143.13.500:

   wep boot_method list test18 1802218143.13.500+
    
   Boot Method(s) for Endpoint 1802218143.13.500+
   TagPrototype ObjectMethod Name
   test181802218143.13.500admin
   

6. The following example gets the current login mode on endpoint msistrunk:

   wep msistrunk get login_mode
    
   desktop, constant
   

7. The following example clears the preferred gateway on the msistrunk endpoint:

   wep msistrunk set preferred_gateway nil
   

See Also

wdelep, wmdist, wmv

Etc

Society

Groupthink : Two Party System as Polyarchy : Corruption of Regulators : Bureaucracies : Understanding Micromanagers and Control Freaks : Toxic Managers :   Harvard Mafia : Diplomatic Communication : Surviving a Bad Performance Review : Insufficient Retirement Funds as Immanent Problem of Neoliberal Regime : PseudoScience : Who Rules America : Neoliberalism  : The Iron Law of Oligarchy : Libertarian Philosophy

Quotes

War and Peace : Skeptical Finance : John Kenneth Galbraith :Talleyrand : Oscar Wilde : Otto Von Bismarck : Keynes : George Carlin : Skeptics : Propaganda  : SE quotes : Language Design and Programming Quotes : Random IT-related quotes :  Somerset Maugham : Marcus Aurelius : Kurt Vonnegut : Eric Hoffer : Winston Churchill : Napoleon Bonaparte : Ambrose Bierce :  Bernard Shaw : Mark Twain Quotes

Bulletin:

Vol 25, No.12 (December, 2013) Rational Fools vs. Efficient Crooks The efficient markets hypothesis : Political Skeptic Bulletin, 2013 : Unemployment Bulletin, 2010 :  Vol 23, No.10 (October, 2011) An observation about corporate security departments : Slightly Skeptical Euromaydan Chronicles, June 2014 : Greenspan legacy bulletin, 2008 : Vol 25, No.10 (October, 2013) Cryptolocker Trojan (Win32/Crilock.A) : Vol 25, No.08 (August, 2013) Cloud providers as intelligence collection hubs : Financial Humor Bulletin, 2010 : Inequality Bulletin, 2009 : Financial Humor Bulletin, 2008 : Copyleft Problems Bulletin, 2004 : Financial Humor Bulletin, 2011 : Energy Bulletin, 2010 : Malware Protection Bulletin, 2010 : Vol 26, No.1 (January, 2013) Object-Oriented Cult : Political Skeptic Bulletin, 2011 : Vol 23, No.11 (November, 2011) Softpanorama classification of sysadmin horror stories : Vol 25, No.05 (May, 2013) Corporate bullshit as a communication method  : Vol 25, No.06 (June, 2013) A Note on the Relationship of Brooks Law and Conway Law

History:

Fifty glorious years (1950-2000): the triumph of the US computer engineering : Donald Knuth : TAoCP and its Influence of Computer Science : Richard Stallman : Linus Torvalds  : Larry Wall  : John K. Ousterhout : CTSS : Multix OS Unix History : Unix shell history : VI editor : History of pipes concept : Solaris : MS DOS :  Programming Languages History : PL/1 : Simula 67 : C : History of GCC development :  Scripting Languages : Perl history   : OS History : Mail : DNS : SSH : CPU Instruction Sets : SPARC systems 1987-2006 : Norton Commander : Norton Utilities : Norton Ghost : Frontpage history : Malware Defense History : GNU Screen : OSS early history

Classic books:

The Peter Principle : Parkinson Law : 1984 : The Mythical Man-Month :  How to Solve It by George Polya : The Art of Computer Programming : The Elements of Programming Style : The Unix Hater’s Handbook : The Jargon file : The True Believer : Programming Pearls : The Good Soldier Svejk : The Power Elite

Most popular humor pages:

Manifest of the Softpanorama IT Slacker Society : Ten Commandments of the IT Slackers Society : Computer Humor Collection : BSD Logo Story : The Cuckoo's Egg : IT Slang : C++ Humor : ARE YOU A BBS ADDICT? : The Perl Purity Test : Object oriented programmers of all nations : Financial Humor : Financial Humor Bulletin, 2008 : Financial Humor Bulletin, 2010 : The Most Comprehensive Collection of Editor-related Humor : Programming Language Humor : Goldman Sachs related humor : Greenspan humor : C Humor : Scripting Humor : Real Programmers Humor : Web Humor : GPL-related Humor : OFM Humor : Politically Incorrect Humor : IDS Humor : "Linux Sucks" Humor : Russian Musical Humor : Best Russian Programmer Humor : Microsoft plans to buy Catholic Church : Richard Stallman Related Humor : Admin Humor : Perl-related Humor : Linus Torvalds Related humor : PseudoScience Related Humor : Networking Humor : Shell Humor : Financial Humor Bulletin, 2011 : Financial Humor Bulletin, 2012 : Financial Humor Bulletin, 2013 : Java Humor : Software Engineering Humor : Sun Solaris Related Humor : Education Humor : IBM Humor : Assembler-related Humor : VIM Humor : Computer Viruses Humor : Bright tomorrow is rescheduled to a day after tomorrow : Classic Computer Humor

The Last but not Least Technology is dominated by two types of people: those who understand what they do not manage and those who manage what they do not understand ~Archibald Putt. Ph.D

The statements, views and opinions presented on this web page are those of the author (or referenced source) and are not endorsed by, nor do they necessarily reflect, the opinions of the Softpanorama society. We do not warrant the correctness of the information provided or its fitness for any purpose. The site uses AdSense so you need to be aware of Google privacy policy. You you do not want to be tracked by Google please disable Javascript for this site. This site is perfectly usable without Javascript.

Last modified: March 12, 2019