Error rendering macro 'rw-search'

null

Downloads

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

MarvelClient can be customized for your environment based on the following notes.ini entries. 

notes.ini entries for customizing MarvelClient

notes.ini entryDescriptionExample value(s)
MC_DB

Mandatory if the Configuration database is not installed in the default location
%notes_homeserver%!!panagenda\panagenda.nsf

The Configuration database that MarvelClient shall synchronize new, changed, removed and enabled/disabled Actions and Conditions with

If %notes_homeserver% can not be resolved from the user's current location, it attempts to resolve it from notes.ini MailServer=

If neither results in a respective home/mail server, MarvelClient will attempt to open the database according to MC_DB_LastReachable

%notes_homeserver%!!panagenda\mc_config.nsf
if not specific defaults to
%notes_homeserver%!!panagenda\panagenda.nsf

%notes_homeserver% is resolved at runtime from the MailServer in the then current location document

MC_DB_NotResolvable

Recommended for initial client setups

If the Configuration database server is configured as %notes_homeserver% and a homeserver is not configured in the user's then current location (or there is not location document yet), the download procedure will fallback to the server and database specified through this notes.ini parameter

NOTE: this setting is only applicable if MC_DB= contains %notes_homeserver%, which should be the case for just about any production rollout

WorldWideAvailableServerName/ACME!!panagenda\panagenda.nsf
MC_DB_UnavailableIf the Configuration database cannot be opened, MarvelClient will fall back to the server and database specified through this notes.ini entry

NOTE: be careful with IP timeout settings - the default is 90 seconds; if it takes 90 seconds to discover that MC_DB cannot be opened, another 90 seconds might be added via MC_DB_Unavailable.
See also mc:db_dbopentimeout and mc:db_checktimedout

WorldWideAvailableServerName/ACME!!panagenda\panagenda.nsf
MC_UploadDB

Usually configured through notes.ini management Actions when running HW/SW inventory and/or collection location/connection documents

Only needed for optional HW & SW inventory and for when collecting Location & Connection documents%notes_homeserver%!!panagenda\mc_analyze.nsf
no default; must be specified when collecting HW & SW inventory and/or Location/Connection documents
MC_WorkingDirectorySpecifies the location of the panagenda MarvelClient Working Directory%notes_data%\mc

defaults to
%os_local_app_data%\panagenda\marvel on Windows
/tmp/panagenda/marvel on Linux and Mac

MC_NetworkDirectory

Mandatory for MarvelClient Roaming

Specifies the location of the panagenda MarvelClient Network Directory;
The actions.xml file is copied from/to this location at every client start/shutdown as to ensure that (MarvelClient) roaming clients can re-use instructions across multiple computers
H:\NotesBackup

%ENV_USERHOMESHARE%\Roaming

\\uncpath\%OS_USER%\directory

MC_AllowSyncDuringSetup

Recommended to set to 2 for initial client setups

By default, panagenda MarvelClient does nothing if the notes.ini Setup= entry is missing when starting an IBM Notes client, leaving initial client setup entirely to IBM and the respective deployment configuration.

In order to use MarvelClient to fully configure IBM Notes clients during the very first client start, set MC_AllowSyncDuringSetup=2 in notes.ini

0 (or not set)=by default, panagenda MarvelClient does nothing if the notes.ini Setup= entry is missing during client startup

1=if MC_AllowSyncDuringSetup is set to 1, MarvelClient will synchronize during every client start, irregardless of whether that is a good idea or not
NOTE: you are advised to NOT set MC_AllowSyncDuringSetup to 1 unless so instructed by support

 

2=recommended; MarvelCient will synchronize during initial client setup if KeyFileName= is specified in notes.ini (or via ConfigFile=) and points to an existing / accessible file

defaults to not set

MC_AllowSyncDuringSetup_FixPrompt

Recommended for initial client setups

Prevents IBM Notes from prompting users for a password twice during initial client setup

1

only use in combination with MC_AllowSyncDuringSetup=2 


defaults to not set

MC_SupportIDVault

Mandatory for when using ID vault and MarvelClient should automatically download a user's ID file during initial client startup/setup

By default, MarvelClient does not download user ids from ID vault. In order to enable IDVault support, set this entry to 1 in notes.ini

MC_SupportIDVault must only be used in combination with MC_AllowSyncDuringSetup=2

In addition, the following notes.ini entries must be set:
KeyFileName, KeyFileName_Owner, MailServer

If any of these settings are missing in notes.ini and a ConfigFile configuration is used, they will be obtained from the ConfigFile entries
Username, KeyFileName, Domino.Name

Note: KeyFileName will default to "user.id" if missing in notes.ini and ConfigFile

1
defaults to not set
MC_SupportIDVault_PromptWhen set to 1 will prompt end users for a user name if not specified in notes.ini via KeyFileName_Owner or in ConfigFile via Username

Requires MC_SupportIDVault to be set to 1

1
defaults to not set
MC_IDVault_UserDiag_Message_Top,
MC_IDVault_UserDiag_Message_Name,
and
MC_IDVault_UserDiag_Message_Example
Allows for customizing the ID Vault prompt (see above)User ID?
Please enter your operating system user name:

e.g. panusr0007, panusr4711, tfusr9999

MC_CopyIDFileToDataWhen set to 1, MarvelClient will copy the user's id file to the IBM Notes client data directory, if it resides outside of the data directory. Naturally, MarvelClient will adjust KeyFileName= in notes.ini accordingly.1
defaults to not set
MC_UseStandardZOrder

Recommended for customers who use MarvelClient on Citrix together with Citrix password manager

Customers who are using Citrix Password Manager for Single Sign On in Citrix environments are instructed to add
ENABLE_EARLY_AUTHENTICATION=0
to notes.ini by Citrix Support. This has various negative side effects (not just for MarvelClient).
(for further details, see http://www-01.ibm.com/support/docview.wss?uid=swg21438725)

MarvelClient customers are advised to remove above line from notes.ini and use
MC_UseStandardZOrder=1
instead for a then proper IBM Notes 9 client install together with Citrix Password Manager and MarvelClient.

1
default to not set
MC_Msg_Suppress_0d4eSuppresses the "Notes setup is complete!" dialog after an initial client start1
defaults to not set
MC_Msg_Suppress_001
MC_Msg_Suppress_002
MC_Msg_Suppress_...
MC_Msg_Suppress_009
Allows to prevent or automatically answer any messages that are raised from client start to shutdown:

MC_Msg_suppress_001=
decimal_resource_string_number

The resource strings themselves are stored in different locations such as nstrings.dll, nnotesws.dll, ... - you can use a tool like Resource Hacker (old, but still useful:http://angusj.com/resourcehacker/) to find the number of the corresponding resource string.



Note: This is not restricted to setup itself, but will prevent/autoanswer any such message raised by notes

Note: Check if there's any helpful IBM setting in notes.ini or ConfigFile that can be used before you consider this approach
MC_Msg_Suppress_001=5591
MC_Msg_Suppress_001_ret=6

will automatically answer the "Failed to replicate with roaming server. Abort the next scheduled clean up?" IBM Notes client roaming message box with "Yes".

Note: This feature is only available on Windows

MC_Msg_Suppress_001_ret
MC_Msg_Suppress_002_ret
MC_Msg_Suppress_###_ret ...
MC_Msg_Suppress_009_ret
Will automatically answer a messagebox (see above) as follows:

1=OK
2=CANCEL


3=ABORT
4=RETRY
5=IGNORE
6=YES
7=NO
see above
MC_CheckCreateMissingSuppresses automatic creation of missing bookmark.nsf, desktop?.dsk/ndk and names.nsf0
defaults to not set
MC_CheckCreateMissing_NoBookmarkSuppresses automatic creation of missing bookmark.nsf only (superseded by MC_CheckCreateMissing)1
defaults to not set
MC_CheckCreateMissing_NoNamesSuppresses automatic creation of missing desktop?.dsk/ndk only (superseded by MC_CheckCreateMissing)1
defaults to not set
MC_CheckCreateMissing_NoNamesSuppresses automatic creation of missing names.nsf only (superseded by MC_CheckCreateMissing)1
defaults to not set
MC_ZapNotesDisplays a message box during client startup for when hanging tasks from a previous Notes session are detected, asking the user whether s/he wants to end them (if a user chooses "Yes", s/he must then double click on the Notes shortcut again).1
defaults to not set/disabled
MC_ZapNotes_IgnoreTasksAllows to exclude custom processes that MarvelClient should not check for as to whether they are considered orphaned from the previous Notes sessionconnecter.exe
nminder.exe,connector.exe
default to not set

Note: This feature is only available on Windows

MC_LogLevelThresholdThe default log level for panagenda MarvelClient is 2; increase to 3 or 4 only when so instructed by support3
defaults to not set = 2
MC_LogToConsoleLogs all MarvelClient log.xml output into IBM Notes console.log, too1
defaults to not set/disabled
MC_RR_EnabledEn- or disabled the MarvelClient Realtime engine1
defaults to 1 for clients with Realtime Actions (and a valid realtime license)
defaults to not set for clients without any Realtime Actions
MC_RR_UseTray

Recommended to set to 0 for normal end users in production

Defines whether the Real-time engine is supposed to show a "lock icon"  in the Windows system tray - this allows for easy testing of realtime Actions
(e.g. enable/disable engine entirely, select different realtime rulesets).
0
defaults to 1 for clients with Realtime Actions (and a valid realtime license)
defaults to not set for clients without any Realtime Actions

It is recommended to set this to 0 for normal end users.

MC_RR_Profile_CurrentSpecifies the currently active real-time rule-setdefaults to 00_Default for clients with Realtime Actions (and a valid realtime license)
defaults to not set for clients without any Realtime Actions
MC_Addon*notes.ini entries for optional collection of HW & SW inventory and/or location/connection documents
MC_SkinningDirectoryEnables optional skinning of the IBM Notes workspace; for further details see
http://blog.panagenda.com/pub/panablog.nsf/d6plinks/FLOR-7DRBHC

NOTE that you do NOT need the mc_skinning.dll since MarvelClient has skinning built in already.

defaults to
%notes_data%\skinning
--> as soon as corresponding skinning files are deployed into this directory, skinning is applied to the IBM Notes client workspace automatically

Note: This feature is only available on Windows

MC_MB_Init_Before
MC_MB_Init_After
MC_MB_BeforeLoginPre_Before
MC_MB_BeforeLoginPre_After
MC_MB_BeforeLogin_Before
MC_MB_BeforeLogin_After
MC_MB_AfterLogin_Before
MC_MB_AfterLogin_After
MC_MB_Shutdown_Before
MC_MB_Shutdown_After
For debugging purposes only; displays a message box before/after the respective Runtype1
defaults to not set

In addition to above notes.ini entries, MarvelClient may maintain the following notes.ini entries depending on used (and licensed) modules and/or Actions: 

notes.ini entries that are maintained by MarvelClient automatically

notes.ini entryDescriptionExample value(s)
MC_DB_LastReachableThe Configuration database MarvelClient was last able to connect to

MC_DB_LastReachable is automatically memorized in notes.ini after a successful connect to the MarvelClient Configuration database (respectively a replica of it)

CN=servername/O=ACME!!panagenda\panagenda.nsf
MC_LastActionUpdateUTC date/time of when the local actions.xml was last updated20130921T145923Z
$MC_DB_LanguageLanguage chosen for the MarvelClient Configuration and Analyze database
(defaults to ENglish)
EN, DE
$MC_DBLastViewThe view that was last opened in the MarvelClient Configuration database; when closing and re-opening the Configuration database, this view will be re-opened automaticallyv_actions_all
$MC_UploadDBLastViewThe view that was last opened in the MarvelClient Analyze database;
when closing and re-opening the Analyze database, this view will be re-opened automatically
v_users_by_notes_username
$MC_HelpKeyKey of last focused object (field/form/tab/...) in the MarvelClient Configuration or Analyze database6000000
MC_LastBackupDateUTC date/time of when the last backup or roaming Action was performed (for MarvelClient Roaming); used to determine whether the client has written the most recent backup or not (if yes, no MarvelClient Roaming will occur during client startup - if the most recent backup was created on a different machine, MarvelClient Roaming will take place)20130923T121507Z
MC_LastProfilingKey(non-converted) key of last executed backup action for MarvelClient Roaming; used to determine whether the roaming backup key has changed%OS_USER%\%NOTES_USER_ABBREVIATED%\%OS_COMPUTER%\%NOTES_VERSION%
MC_LastProfilingKey_ConvConverted key of last executed backup action for MarvelClient Roaming; used to determine whether a data directory has been copied to a different machine, or a user is using the same notes.ini from a different machine (if so detected, MarvelClient Roaming is enforced)osusername\notesfirst_noteslast!organization\computer-name\9-0-0
MC_RR_RunningShows whether the real-time engine is currently running (which it either is throughout an entire client session, or is not - this does not show whether a real-time Action is currently being executed or not).1 for clients with Realtime Actions, a valid realtime license, and enabled real-time engine
defaults to not set for all other clients



See Also
Installing panagenda MarvelClient
Installation Types
Getting started in just 20 minutes (Install Wizard)
Performing a manual install of panagenda MarvelClient
Configuring the ACL of the MarvelClient Configuration database
Configuring the ACL of the MarvelClient Analyze database
Final steps for initial server-side installation
Rollout of the MarvelClient databases across multiple Domino servers
Rollout of panagenda MarvelClient to multiple end users