Installation FAQ

[EZ Suite - multiple products] How do I install my software?

• Download File:

  Save the YtriaEZSuite.zip file to your computer.

• Decompress File:

  Unzip (or extract) the YtriaEZSuite.zip file, which contains a YtriaEZSuite.nsf file, to a folder of your choice. Strongly recommended: use your local Notes\data directory

• Open database and install:

  In your Notes client open the YtriaEZSuite.nsf database, click the "Install" button and follow the instructions to complete your installation.

• Note (for first time users):

  After clicking "Install", IBM Notes will show an "Execution Security Alert" dialog box. Choose "Start trusting the signer to execute this action". You only need to do this once. This will only appear for first time users.

• Activation:

  The "Ytria Key Management System" process starts after installation completes. Now you will need to activate your software (see the Activation FAQ for more details).

[Single product] How do I install my software?

• Download File:

  Save the [productname].zip to your computer.

• Decompress File:

  Unzip (or extract) the [productname].zip file, which contains a [productname].nsf file, to a folder of your choice. Strongly recommended: use your local Notes\data directory

• Open database and install:

  In your Notes client open the [productname].nsf database, click the "Install" button and follow the instructions to complete your installation.

• Note (for first time users):

  After clicking "Install", IBM Notes will show an "Execution Security Alert" dialog box. Choose "Start trusting the signer to execute this action". You only need to do this once. This will only appear for first time users.

• Activation:

  A splash screen appears after installation completes. Now you will need to activate your software (see the Activation FAQ for more details).

Toolbar installation issues

"Software is unable to update the ToolBar/SmartIcon during installation"

Updating the SmartIcon or Toolbar is the last step in the installation process. Usually this warning message simply means that the product installation went fine, except for the Toolbar update. This may mean that you have slightly corrupted bookmarks (see below) and it is preventing the software from installing the Ytria toolbar properly.

Corrupted Bookmarks

IBM Notes users may have slightly corrupted bookmarks, without even knowing it (since they can still work properly from an end-user point of view). If you suspect this, see "How do I manually install the Ytria toolbar?" to create a Ytria toolbar yourself with a formula similar to the one below. After you create the Toolbar or SmartIcon everything should be fine.

scanEZ @DbLookup( "Ytria" : "NoCache"; "scanez.exe" : "")

Known Toolbar Issue When Installing on Notes 8

Sometimes after successfully installing our software on Notes 8, the Ytria toolbar will not appear. In this case, try to right-click the toolbar in the Notes client and de-select/re-select the Ytria toolbar option.

If that fails to work (or if the Ytria toolbar is not even available as an option) then in your Notes client go to: File > Preferences > Toolbar > Toolbars and de-select/re-select the Ytria toolbar again; in the end making sure that it is set to Visible. The toolbar should now appear.

Changing the Toolbar Formula

If you are still able to run our products directly from their .exe file then it is likely a Toolbar or SmartIcon problem. Some users may need to change the formula to point directly to the executable file, example:

@DbLookup( "Ytria" : "NoCache"; "C:\\Lotus\\Notes\\scanez.exe" : @Text(@DocumentUniqueID))

Refreshing the Toolbar

Often a toolbar refresh is all that is needed to display your Ytria toolbar. Right-click the toolbar in the Notes client and toggle the Ytria toolbar option.

IBM Notes 5 (formerly IBM Lotus Notes 5) clients and lower: Close & open Notes to make your new SmartIcon available in the Universal toolbar. Ytria SmartIcons are placed under the Universal setting and should be located there (if not, they should be found as one of the Available icons). Therefore, if you are using some other setting you will need to add the SmartIcons yourself manually (go to File > Preferences > SmartIcon Settings).

IBM Notes (formerly IBM Lotus Notes) 6.x clients: To make the toolbar visible go to: File > Preferences > Toolbar preferences > Toolbars Tab and select the Ytria toolbar.

Unable to write to the following notes.exe directory: C:\notes\

As the message indicates, our tool is "unable to write to your notes.exe directory"...this has to do with your Windows administration rights on your PC...

Our tools must be installed to the same directory as the notes.exe file. If you cannot change the folder permission, then you will not be able to use our tools (similar to other Notes products). You will need to ask your administrator to give you the rights to install our files to the notes.exe directory.

We have a online FAQ for this, it's for R6 but it's the same idea for R5 users, click here...

After you create the SmartIcon or Toolbar everything should be fine.

Cannot write or create file (file or disk is read-only)

If you see the error message: "Cannot write or create file (file or disk is read-only)", it could be one of two things:

• You do not have write access to your notes.exe directory. If you do not have Windows manager access, ask your Administrator to install our software for you (or whoever has the proper permissions to write to your registry).
• Installation file in is read-only mode. Make sure that the Ytria installation file (for example: scanEZ.nsf) is not set to read-only. In Windows, you can verify this by right-clicking the file and go to Properties > General tab.

Unable to save the license information

The message you see during registration: "Unable to save the license information", probably means that you do not have the rights to write to your workstation's Windows registry. It likely means that you do not have Windows manager access, ask your Administrator to install our software for you (or whoever has the proper permissions to write to your registry).

How do I manually install the Ytria toolbar?

• In File->Preferences->Toolbar preferences, click on the Customize tab.


• Select the Ytria toolbar from the list (Select the Toolbar to Modify) at the top of the Customize tab. Note: If the Ytria toolbar does not exist, you will have to create it. Go to the Toolbars tab, click the New Toolbar button and enter the title: Ytria.


• Click on the New button and select Button from the dropdown menu.


• Enter the product name in the Button caption text and the Popup help text fields. The next step will be to enter the formula.


• Copy the appropriate formula in the formula field :
  
  

  Product	Formula
  scanEZ	@DbLookup( "Ytria" : "NoCache"; "scanez.exe" : @Text(@DocumentUniqueID))
  aclEZ	@DbLookup( "Ytria" : "NoCache"; "aclez.exe" : "")
  agentEZ	@DbLookup( "Ytria" : "NoCache"; "agentez.exe" : "")
  databaseEZ	@DbLookup( "Ytria" : "NoCache"; "databaseez.exe" : "")
  consoleEZ	@DbLookup( "Ytria" : "NoCache"; "consoleez.exe" : "")
  replicationEZ	@DbLookup( "Ytria" : "NoCache"; "replicationez.exe" : "")
  signEZ	@DbLookup( "Ytria" : "NoCache"; "signez.exe" : "")
  viewEZ	@DbLookup( "Ytria" : "NoCache"; "viewez.exe" : "")
  actionBarEZ	@DbLookup( "Ytria" : "NoCache"; "actionbarez.exe" : "")
  designPropEZ	@DbLookup( "Ytria" : "NoCache"; "designpropez.exe" : "")
  formEZ	@DbLookup( "Ytria" : "NoCache"; "formez.exe" : "")
  Additional
  signEZ Hotspot	@DbLookup( "Ytria" : "NoCache"; "signez.exe" : @Text("HOTSPOT_" + @Text(@NoteID)))
  signEZ Direct	@DbLookup( "Ytria" : "NoCache"; "signez.exe" : @Text("DIRECT_" + @Text(@NoteID)))
  scanEZ multiSelection	tgt:=@Environment("YtriaScanEZExtensionDB"); @If(tgt="";@Return(@Prompt([Ok];"Error";"scanEZ Extension Database cannot be found. Please re-install it."));""); @If(@NoteID="NT00000000"; @If(@ViewTitle!="";@SetEnvironment("YtriaScanEZLaunchParam";@Implode(@DbName;"!!")); @Do( @Command([OpenView]); @UpdateFormulaContext; curDB:=@Implode(@DbName;"!!"); @If(curDB!="!!";@Command([CloseWindow]);""); @SetEnvironment("YtriaScanEZLaunchParam";curDB) ) );@SetEnvironment("YtriaScanEZLaunchParam";@NoteID) ); @URLOpen("notes://"+tgt+"/scanEZ?openform")



• Click on the Change Icon button and select the appropriate image name. Note: If the image does not exist, you will need to copy one of the images below, right-click on the image and select "Save image as".
  
  

  scanEZ			viewEZ
  aclEZ			actionBarEZ
  agentEZ			designPropEZ
  databaseEZ			formEZ
  consoleEZ			signEZ Hotspot
  replicationEZ			signEZ Direct
  signEZ			formEZ

  
  Note: If you are using IBM Notes version 7 and lower, use the icon images below:

  scanEZ			signEZ
  aclEZ			viewEZ
  agentEZ			actionBarEZ
  databaseEZ			designPropEZ
  consoleEZ			formEZ
  replicationEZ			signEZ Hotspot
  			signEZ Direct

  
  To add it to the list of images, click on the New button and select the file you just copied.


• Click "Ok" twice to close the two popups and then click on the "Save toolbar" to save your changes. You should now be able to access your software directly from Notes ND6.

"Install" button fails. Status-bar: "Error when writing to Log. No logs open (4430)"

By default, we try to put the install error log file in the C: drive. The error message means that we are not allowed to write to the root of your C: drive. Which implies that it could be a permission issue.

If you can rectify the permission issue, it should then be able to install on to your computer. Or, you can try to see if redirecting where the log file will be created (somewhere we can write to) helps. To do this add a line in your notes.ini file: $YtriaInstallLog=parameter

Parameters

• mail – Will send the log to email support@ytria.com
• mail:123@123.com – Will send the log to email address 123@123.com
• file —Will put log in file C:\YtriaInstall.log
• file:log123 — Will put log in file specified log123. If no path is given, it will save it in the current directory of Notes.

If the mail or file parameters are followed by a colon (:) then it MUST have some value set (unless it will display an errror).

Do Ytria tools require anything to be installed on my Domino servers?

No, Ytria tools never require anything to be installed on a Domino server.

Is Windows 7 (or Windows Vista) supported?

Yes, our products support both Windows Vista and Windows 7. Having said that, read the next FAQ item below if you encounter any installation issues.

Windows 7 (or Windows Vista) and other general hints

Windows Vista/7 and IBM Notes (formerly IBM Lotus Notes) 8 installed is supported

This means that Ytria products must be installed on a fresh install of IBM Notes 8 (and NOT on previous versions of Notes that have been upgraded to 8).

Windows Vista/7 and IBM Notes 4.6x to 7.x Installed

Possible Windows Vista/7 workarounds...

As stated by the IBM Technote above: "Windows Vista locks down the C:\Program Files directory". So if you are a Windows Vista /7 user, you should install IBM Notes in a directory other than C:\Program Files. Once this is done Ytria software can install normally.

Some background: Windows Vista/7 seems to have an issue when using the basic IBM Notes detach function (all our files are attachments in special notes), it fails for all the exe files that need to be placed with your Notes application and also if your Notes is installed in the Program Directory. For some reason, Vista will not pop-up and ask you if you want to put something in the directory.

However, there is a workaround for installing Ytria software. There's a notes.ini entry (see help page: YtriaInstalRedirectNotesExeDir) that lets you direct the installation to a temporary folder before manually copying the files to the notes.exe directory.

Corrupted Bookmarks

IBM Notes R6 (formerly IBM Lotus Notes 6) users may have slightly corrupted bookmarks, without even knowing it (since they work properly from an end-user point of view). If you suspect this, see "How do I manually install a Ytria toolbar for Notes ND6?" to create a toolbar icon yourself with a formula similar to this one: scanEZ @DbLookup( "Ytria" : "NoCache"; "scanez.exe" : "")

Also, uncheck the "Redo the installation of the Toolbar icon for scanEZ" in the installation window. Bookmark databases are often corrupted, and you can possibly avoid installation crashes by removing this option.

Loaded .dll files

*It is more convenient to start with a "fresh" Notes client. After opening your Notes client, (without doing anything else) proceed directly to the [productname].nsf database, open it, and then click the "Install" button. The reason is that if you have been using any Ytria products during a session, certain .dll files are loaded into memory which cannot be written over during an installation. By not using any tools during a session, you can install all our products one after another (or better yet just use the EZ Suite install) and then close Notes just once for the installation settings to take effect.

"Sign this database with your current ID" button

Normally, most users should simply use the "Install" button to install Ytria products. However, if the need ever arises you can use the "Sign this database with your current ID" button to sign the database with your ID (or a general authorized ID, if installation database is on a server) to avoid all the security alerts (i.e. ECL and cross certification alerts).

Force-reinstall of all files

Normally, you will never need to use this option. This option is mainly used to downgrade your Ytria software. It replaces any existing files with ones provided by the installation database, (even if the installing files are out of date).

What do I do with the .nsf installation files?

We recommend that you keep the files handy somewhere in case you ever need to install from them again. However, after installlation, you can delete the .nsf files for all Ytria software except for signEZ and designPropEZ (and YtriaEZSuite.nsf if using the suite installation file).

The signEZ database is used to keep signatures and logs and the designPropEZ database is used for updating design element properties across multiple databases. If these tools were installed using the EZ Suite Installer the YtriaEZSuite.nsf file serves as the database for both designPropEZ and signEZ and thus should not be deleted if you'd like to use those tool's features. For all other tools you can delete their respective .nsf files after they have been properly installed (if you wish).

How do I install a localized version of the software?

This feature is only supported in:

• Ytria software version 9.1.3 and up
• Full version software (Lite users will not be able to use a localized version)

If the above criteria are met, then you can download the localized file for your Ytria software. Click here for further instructions.

How can I manually update the software?

The latest executable files are available for download here.

I have Windows 7/Vista, but my scanEZ interface looks "messy" (i.e buttons are out of reach)

In rare instances, some users have reported font sizes that look a little too large, or buttons that are unreachable, or some large empty spaces (mostly in scanEZ). We found an article regarding a known Windows font issue that could make software (not just ours) look a bit "messy". The workaround reported in this article is something to try until a fix is made.

If all else fails send us the C:\YtriaInstall.log file

If you still have problems after trying the hints above send the install log to support@ytria.com, which should be found in the root directory of your C: drive.

C:\YtriaInstall.log

It should help us find out what exactly went wrong with the installation.

How do I uninstall the software?

Important Note: Below are all the files that you should delete, however, depending on the product installed it may not exist for you (which is normal).

FOR R5.x users

1. Delete the smarticon for [Productname]
2. Delete the [Productname].exe, ndbYtria.dll, scanEZ.ini, scanEZMulti.dll in your notes.exe directory
3. Delete the Ytria "something" .mac and .bmp files in your W32 directory (in the Notes\Data directory)
4. Delete the Ytria "something" lines in your notes.ini file

FOR ND6.x+ users

1. Remove the toolbar icon for [Productname], File>Preferences>Toolbar Preferences > Customize > and remove the icon.
2. Delete the following files in your notes.exe directory:
   • ndbYtria.dll
   • YtriaUpdate.exe
   • YtriaRegister.dll
   • YtriaLang.loc (if localized version is installed)
   • [Productname].exe
   • scanEZMulti.dll (if scanEZ is installed)
   • YtriaRegex.sfd
   • YtriaFormula.sfd
   • scanEZ.ini (if installed)
   • scanEZ.sfd (if installed)
3. Delete the Ytria and $Ytria "something" lines in your notes.ini file
4. Delete the Notes\data\YTRIA_TECHNICAL_SUPPORT subdirectory, where dbghelp.dll, and crash logs are stored