Service

To access this screen: Select the Start menu, and then in the Run box type: services.msc     Press the Enter key, and the Service Manager (shown below) will open. Note: You may need to be logged in as an Administrator to see or edit these settings.

 

 

Note, the ShipRush Service listens on port 3841 by default. This port needs to be open on the local firewall for other PC's to be able to connect to the ShipRush 'server' PC

 

The ShipRush Service performs a few roles:

 

1) In a multi-user environment, the ShipRush service can act as a database server for the other PC's, so workstations can connect to a central ShipRush database by specifying the name of the ShipRush server PC.

 

2) ShipRush SDK users using the SOAP Server entry point are communicating with the ShipRush service.

 

In most single user environments, the ShipRush service is not present. That is normal and fine.

 

 

The ShipRush service connects to the ShipRush database by referencing the ShipRushServer.ini file. This file is in the ShipRush program directory, which is typically:

 

"C:\Program Files\Z-Firm LLC\ShipRush vX\"

 

The ShipRushServer.ini specifies:

 

 

 

 

 

In rare cases, the service may be running, but there is no ShipRushServer.ini present. In this case, the service runs with default values, which is normally fine. The database in this case will be here (note, these directories are hidden):

 

Vista & Windows7:

C:\Users\Public\Documents\Z-Firm LLC\ShipRush\database\

 

XP:

C:\Documents and Settings\All Users\Documents\Z-Firm LLC\ShipRush\Database\

 

Older versions of ShipRush:

C:\Documents and Settings\<USER NAME>\Application Data\Z-Firm LLC\ShipRush v5\Database.v4\

 

 

Note that the ShipRushserver.ini is only used if the server is running as LocalSystem and there is no ShipRushConnectionSettings.ini accessible by the service. If ShipRushConnectionSettings.ini is found by the service, the database connection values found there will control.

 

Service Log File: ShipRushServer.log

 

The Service keeps its log file in the \dblock\ subdirectory under the database. If there is a problem with the service (it fails to start, or other troubleshooting is needed), identify the database directory in use. The log file is named: ShipRushServer.log (another strategy is to search the hard drive for this file name).

 

The ShipRushServer.log file specifies the ports the service is listening on, and other details.

 

As the log file fills, it is rotated into a .001 and .002 file. The kit of .log + .001 + .002 is the complete kit of logs.

 

Creating the ShipRush Service Manually

 

If the service is not present, and you need to install it, this can be done via the command line. Steps:

 

1) Do this at the computer that has the database on it. (The service should not try to access a database over the network.)

 

2) ShipRush needs to be installed and operational on this PC.

 

3) On Vista & Windows7

Click Start

In the "Start Search" box, type: command

A list of of matches will appear above the box.

Right-click Command Prompt in the Programs list, and then click Run as administrator.

(Click here to see this sequence)

Continue at Step 5 below

 

4) On XP: 

Open the Start Menu
Select 'Run...'
Type in cmd <enter>  (this will open a command prompt)

Continue at Step 5 below

 

5)Use the following command to change the directory to the ShipRush v9 program folder:

cd c:\program files\z-firm llc\shiprush v9

 

NOTE: If the machine is 64-bit, the path is slightly different:

cd C:\Program Files (x86)\Z-Firm LLC\ShipRush v9

 

Note: This needs to be typed exactly, so copy and paste!

Now that the prompt is showing us in this directory, type:

shiprushserver.exe /install

Should get a pop-up after a minute that the service installed

 

6) Go into the Control Panel | Administrative Tools | Services

Find the Z-Firm ShipRush service - right-click and select Start
Make sure it's set to Automatic as the start up type

7) Check the Windows Firewall

Windows7 & Vista: http://windows.microsoft.com/en-US/windows7/Open-a-port-in-Windows-Firewall

 

Windows XP:

Go to the Control Panel | Windows Firewall
If the firewall is set to be On, go to the exceptions tab
Select 'Add Port..."
Name: ShipRush
Port Number: 3841
TCP

 

(If using Zone Alarm or Norton Personal Firewall, refer to those applications)

 

 

Uninstalling the ShipRush Service Manually

 

If the service is not present, and you need to install it, this can be done via the command line. Steps:

 

1) Do this at the computer that has the database on it. (The service should not try to access a database over the network.)

 

2) Confirm that the service is listed in the Service Manager:

 

 

3) Get to a command prompt that is running as an Administrator

 

On Vista & Windows7:

 

On XP and Windows 2003:

 

 

4) Use the following command to change the directory to the ShipRush v9 program folder:

 

cd c:\program files\z-firm llc\shiprush vX       // Note that X is referring to the version of the service you are uninstalling

 

NOTE: If the machine is 64-bit, the path is slightly different:

 

cd C:\Program Files (x86)\Z-Firm LLC\ShipRush vX

 

Note: This needs to be typed exactly, so copy and paste!

 

5) Now that the prompt is showing us in this directory, type:

 

shiprushserver.exe /uninstall

 

6) Done!  Press the F5 key to refresh the Service Control list, and the "Z-Firm ShipRush" service should now be gone.