Troubleshooting the Single-User Installation

Canceling the Start Servers Command

The Start Servers command runs automatically when you start the Smart Client in the standard single-user install or when you press the "Start" button. The command then shows a series of progress prompts in a popup dialog, which dismisses itself if the startup is successful.

If the progress dialog stops, note the error. Then press the "Cancel" button on the dialog, and correct the error.

Identifying Startup Errors

If you need more information on startup errors, open the Web Central log file (the archibus\WEB-INF\config\archibus.log file beneath c:\Documents and Settings or c:\users\public ) in Notepad and search for the word "ERROR".

If you are using a different text editor, and the log file comes up as all special characters, make certain you are using a text editor that can read Unicode text.

Checking for a Missing License File

Make certain that your license file (ai-licenses.bin) is in your configuration folder (webapps\archibus\WEB-INF\config\). If not, copy this file from your license DVD and restart the application server.

Checking the List of Active Projects

Some start-up problems are due to issues with the list of active projects to which the application connects when it starts.

You can review the list of projects with the Smart Client Project Preferences command (shown above) or by examining the project configuration file (WEB-INF\config\afm-projects.xml) directly.

When reviewing the list, consider these conditions.

You must have at least one active project when you start the application servers. Otherwise, the application will not connect to any database.
Only one Sybase Adaptive Server Anywhere Runtime project can be active at once.
You cannot run the Sybase Runtime project and another local project (e.g. a Sybase Adaptive Server Anywhere or a Microsoft SQL Server Express project) at the same time.
Your Database Type in the project preference must match the actual server type you are running. For instance, suppose you shut down your Sybase Runtime and start your Sybase Adaptive Server Anywhere server. You must deactivate the HQ-Sybase-Runtime project, and activate the HQ-Sybase project.

The ARCHIBUS Ribbon Does Not Show in DWG Editor

If you find that the ARCHIBUS ribbon menu does not show in DWG Editor when using the Administrator or Guest profiles, items were not added to the registry in the correct order, which results with an incorrect search path for support files. For example, you will encounter this problem if the Smart Client's CAD Application preference was set before you launched your CAD application for the first time.

To resolve this issue:

Click Preferences in SmartClient.
For the CAD Application preference, deselect DWG Editor. Choose None.
Click on Preference again and re-select DWG Editor.

You Receive an "Out of Database Connections" Message

If you are using the Sybase Runtime server and you receive an error message stating that it is out of database connections, try these steps.

Close other programs that are using the database, such as the ARCHIBUS Windows Client/Server program or the Sybase Interactive SQL program. These programs use database connections.
Close other Windows programs. If the Sybase Runtime server cannot allocate enough memory to itself, it will start refusing connections.
Start the Sybase Runtime from an icon. When you do so, you can optionally try increasing the memory switch in this start-up line (e.g. from "-c 300M" to "-c 512M"). Please see Alternate Startup Procedures for Standard Single-User Installation.
Verify that your Sybase database is installed correctly. For instance, if you have both the Sybase Runtime and the Sybase Authoring or Multi-User program both installed, verify that their shared files are separated (e.g. that the environment search path or the ASAANY9 OR SQLANYSH10 paths are not cross-linked). The programs use subtly different versions of the support DLLs.

You Receive a "Port In Use" Message

If you start the application server and you see an error stating that port 8080 is in use, change the port at which the application server listens for requests.

In the Smart Client, use the Applications tab of the Preferences dialog to change the Port for Local Application Server to another value (e.g. 8081).
Use the Stop and Start buttons to restart the application server.

Use this new port number in the URL you use to Sign In to ARCHIBUS, e.g. http::\\myworkstation:8081\archibus or http::\\localhost:8081\archibus

Proxy Server Blocking Access

If you have a proxy set up for all HTTP services, it may be blocking access even to a local server. To remedy this situation:

In Internet Explorer, use the Tools/Internet Options/Connections tab; select the Advanced button; enter localhost and 127.0.0.1 (or your server information) in the Exceptions box.

If you continue to have difficulties, be sure to check the following:

If you are logging in remotely, check that you can access the host computer by using ping <servername> or ping <server IP address> at the command line.
If you are logging in locally, check that your host file (e.g. c:\windows\system32\drivers\etc\hosts) has an entry for: "127.0.0.1 localhost".

Stopping the Database and Application Servers

If you have started the database and application servers using the Start button on the Smart Client, the easiest way to stop them is to again run the Smart Client application, then press the Stop button to invoke the Stop Servers command

If this command does not work, or if you are experiencing start-up problems and you want to verify that any previous database and application services are stopped, use these procedures.

Stopping the Smart Client

If the Smart Client ever becomes unresponsive, you can stop it using the Task Manager.

Right-click on the Windows task bar at the bottom of your screen.
Select the Windows Task Manager.
On the Applications tab, select the Smart Client; and then select the End Task button.

Stopping the Server Console Processes

The database and application servers run as separate processes.

If you are using the Sybase Runtime database from the standard single-user installation, the Smart Client program starts these servers as console processes, which you can also stop using the Task Manager.

Right-click on the Windows task bar at the bottom of your screen.
Select the Windows Task Manager.
On the Processes tab, select the Sybase Runtime process (rteng9.exe) and then select the End Process button.
Also on the Processes tab, select the Java runtime environment (java.exe or javaw.exe) and again select the End Process button.Smart Client; and then select the End Task button.
On some rare occasions, the Jetty application server launcher (JettyService.exe) will also appear. End that process as well.

There is no need to stop the Java Quick Start (jqs.exe) or Java Scheduler (jusched.exe).

Stopping the Services

If you have started the servers with the Sybase Authoring, the Sybase Multi-User, or the Microsoft SQL Server Express database; the Smart Client program starts these servers as services, which you can stop using the Services Manager.

Run the Services Manager by using the Start/Run button and invoking services.msc.

To stop the Jetty application service, select the Jetty_for_ARCHIBUS_191 entry, right-click, then select the Stop button.
To stop the Sybase database service, select the SybaseASA_for_ARCHIBUS_191 entry, right-click, then select the Stop button.
To stop the Microsoft SQL Server Express service, select the SQLEXPRESS entry, right-click, then select the Stop button.

Changing your Application Preferences Manually

The ARCHIBUS setup program configures the program automatically. In particular, it configures the program to run with any copy of Sybase Adaptive Server Anywhere or Microsoft SQL Server Express it finds on the workstation.

If you install these programs after you install ARCHIBUS, reinstalling ARCHIBUS will update these settings.

Experienced users may prefer to update the application configuration file themselves. To do so:

Open the c:\Program Files\archibus\19.1\SmartClient\SmartClient.Common.dll.config file for editing. (On 64-bit workstations, the program will be in the c:\Program Files (x86)\archibus folder.)
Edit the MsSqlExpress Installed attribute, as appropriate.
Edit the Sybase ASA Installed and the Sybase Home attribute, as appropriate.

The application configuration file (SmartClient.Common.dll.config) holds read-only preferences that the application establishes on installation.

If you edit preferences from the Preferences dialog to override any of the application defaults, the Smart Client stores your new preferences in c:\Documents and Settings\<username>\Local Settings\Application Data\archibus\SmartClient\user.config. If you ever want to restore the Smart Client to the default values, delete this user.config file.