Platform: Linux
TeamSite Version: 6.7.1

I was recently involved in a project where I was getting a constant error message appearing in my iwtrace.log (iw-home/local/logs).

The error casued TeamSite not to start correctly.  I was looking up reasons and solutions for the error, and found the below;

Cause:

TeamSite is reading over a 1000+ users and groups. Once a investigation was done on where this came from, it became apparent that the users and groups were for a requirement for a previous project.  Each time the server rebooted, the server would synchronise with the main server, so the configuration of 1000+ users and groups would continue to exist.

Solution:

- Remove group and users’ db on the server, along with reference to the users and group db in the file nscd, located in the /etc directory in the parent directory.
- Also the removal of Server synchronization with users and groups from the main server.

Making these changes helped to resolve the issue, with error message not appearing again

I was recently involved in a project where I was getting a constant error message appearing in my iwtrace.log (iw-home/local/logs).

I was looking up reasons and solutions for the error, and found the below;

Cause:

The error is caused by an attempt to run TeamSite on an NTLM domain. TeamSite no longer supports NTLM domains: you must run TeamSite on a Windows 2000 or later (Active Directory) domain.

Solution:

Add your TeamSite server to a Windows 2000 or later (Active Directory) domain then the error messages should go away.

Also, it is recommended to add the line set domain_list=<DomainName>
under the [iwserver] section of iw.cfg,
located in iw-home/etc.

<DomainName> is the list of domains not including the local machine name the local machine name. If domain_list is incorrect, then you will see a variety of error messages in the iwtrace.log (mostly referencing ADSI problems) and possibly even a server crash.

When doing an upgrade of any Interwoven Software package, it is always handy to know what version you are upgrading from.  This will allow you to plan your upgrade path according to the current version installed.  Finding the exact TeamSite version can be quite tricky.  Below is a way to get the latest TeamSite version

1. Navigate on command line (cmd) to iw-home/bin
2. Run the command iwversion.  If you are running this command on a Linux/Solaris box you would input this as ./iwversion

You will now get the output of the current TeamSite version installed on the server

Setting Environment path variables allows a user to input on command line a Interwoven command line tool rather than also entering the path and the name of the command line tool

e.g. The TeamSite reset command is iwreset.  Without the environmental path variable set, the command on command prompt would be required to be inputted as;

C:/iw-home/bin/iwreset.exe

With the Environmental path variable set, the command on command prompt would be inputted as;

iwreset (This could be from any location on the command line)

Setting Environment Variables

1. Right Click ‘My Computer’.  You will see the properties option in the context menu.  Select this option
2. A properties window will appear.  Select the ‘Advanced Tab’
3. Now select the button ‘Environment Variables’
4. A new window will appear displaying information regarding Environment Variables.  Scroll down to the option path under system variables.  Highlight this option by selecting it
5. Select the edit option for the variable path
   
6. A new window will appear.  This is the area where you add all the Interwoven Command Line Tools paths e.g C:/iw-home/bin.  For each path you add, you need to add a semicolon (;) at the end.  Thereafter you can enter the next path.Depending on the Interwoven Software, there are many Interwoven Command line tools which are in various paths. Entering them all here will save an abundance of time when using the command line for important commands
7. Select ok, close all windows and reboot the server

You can now enter commands such as iwreset without paths on the command line

Below are useful Search Command Line tools.  They will help with managing the index and search servers

iwsrchgethome - Displays the location of the TeamSite Search home directory.
iwndxmgrfreeze - Freezes and unfreezes the index manager.
iwndxmgrstatus - Determines the current status of the index manager (active or frozen).
iwndxmgrstop - Shuts down the index manager.
iwndxstatus - Displays the index status for branches.
iwndxlistbr - Lists all the indexed branches.
iwdxpurgebr - Removes the index collection associated with the branch.
iwndxaddbr - Adds a branch to be indexed by the index manager.
iwndxrmbr - Removes a branch so it is no longer indexed by the index manager.
iwndxfreezebr - Freezes or unfreezes a branch that is being indexed by the index manager.
iwndxrefreshbr - Reindex the branch using either the bulk or incremental queue.
iwndxregsrchsvr - Register a search server with the index manager.
iwsrchndxstatus - Displays the index status for branches from the search server.
iwsrchquery - Returns the first page of the query output in XML format.
iwsrchgetpage - Displays a page of results from a previously performed query.
iwsrchmgrstop - Shuts down the search server.
iwsrchmgrping - Pings the search server.
iwsrchndxstatuschg - Notifies the search server of changes in the index manager status.
iwsrchattrib - Displays a list of field specifications for indexed attributes.

From my experience there are a few things to bear in mind when installing Interwoven Software.  These include

1. Always install your software as administrator or full root (for solaris/Linux).  In respects to root access it must be full root not any sppof such as sudo. At the lease su root would be acceptable.  There have been installs where I have seen the installer not correctly installing, after which issues later arise.  Another reason to install as full root or administrator is that Interwoven will only support the software if they are installed by these users.
2. Always read the release notes, and ensure you fulfill the pre-requisites.
3. When selecting the install path, don’t leave any spaces.  I like to install as below;
   C:/Interwoven/TeamSite or C:/Interwoven/MediaBin
4. Keep a record of your actions whilst the install take place; will come in handy to document and to analyse any potential issues arising at a later date
5. Follow up your installation by executing any actions that are required after the install

Providing you have TeamSite installed along with TeamSite Search (Both in working order), you can configure TeamSite Search to search within a Data Capture Template (DCT)/ TeamSite template for a specified field

e.g. Organisation ID

The file you need to configure to allow this to happen is FieldMapping.xml, located in search-home/etc

An example of the code you would input here can be found below;

<templates>
<!– * Organisation ID * –>
<template>
<templateType>contactinformation/building</templateType>
<templatingFields>
<templatingField>
<xpath>/main/organisation</xpath>
<fieldSpecification>
<fieldName>OrganisationsID</fieldName>
<fieldType>string</fieldType>
<fieldStorage>zone:contact_info_Organisations_ID</fieldStorage>
</fieldSpecification>
</templatingField>
</templatingFields>
</template>
</templates>

For more information on how you would code this, please contact us and we can expand further on this article

Platform: Linux
TeamSite Version: 6.7.1

I was involved in a recent project where each time the client logged out of TeamSite, they would get a log out error.  Initially we weren’t sure why the error was appearing.  After thorough investigation of the TeamSite logs I came across some errors/warnings in the file servletd_out.log (located in logs/iwui).  Errors included;

The errors did not actually say that there was something wrong in respect to the solution given below, but it got me thinking in respects to the locations it mentioned in the log. I did a search of the location;

/iw-home/servletd/work/Catalina/localhost/iw-cc/org/apache/jsp/teamsite/common/

compared them to a working TeamSite directory from Interwoven Support.  I found the files;
start_jsp.class,
start_jsp.java
were missing in that location.

Solution:

- Get the missing files from Interwoven Support and place them in the location above
- Reset user & group permissions from the directory /iw-home/servletd/work/ onwards to the user iwui and group nobody

TeamSite now logged out with no errors

If you have TeamSite or Search installed on seperate servers, you are required to make configuration changes on both servers, so that they communicate with each other.

On the TeamSite Server:

Browse to iw-home/cssdk/cssdk.cfg. Edit the following entries (near the bottom of the file) according to your Search Server

search.server.host: <Search Server Hostname>
search.server.port: 6720

On the TeamSite Search Server:

Browse to search-home/etc/search.properties. Edit the following entries according to your TeamSite Server

iw.teamsite.server.host=<TeamSite Server Hostname>
java.naming.provider.url=tcp://< TeamSite Server Hostname>:3035/

iw.index.agent.idxdir=C:/iw-index
iw.search.agent.idxdir=C:/iw-index