Wired Server for Mac OS X

The Mac OS X version of Wired Server is a distribution made up by a Wired Server and a graphical control interface in the form of standalone Cocoa application. The server is built especially for Mac OS X and includes support for extras like Bonjour.

The application includes a regular Wired Server, and can thus also be configured entirely via the Terminal. The Wired Server part is installed into ~/Library/Wired.

It is important to know that Wired Server for Mac OS X runs several processes on your system:

I. Requirements

II. Installation

It is strongly recommanded to install Wired Server on a clean operating system, especially cleared of old versions of Wired Server.

  1. Download latest Wired Server for Mac OS X here.
  2. Unarchive the package and drop Wired Server.app into your /Applications directory.
  3. Open Wired Server.app and click the Install button of the General panel.
  4. When finished, click on the Start button to launch your new Wired Server 2.0.
  5. Try to connect with Wired Client at localhost with admin login and without password.

wired server mac 1

If you experiment any trouble, please check the Troubleshootings section to maybe found a clue for your issue.

III. Uninstallation

Uninstalling Wired Server entirely will delete the server database and all configuration files. It is recommended to export your data before uninstalling. For that, have a look to the Import/Export section.

  1. Open Wired Server.app and click the Uninstall button of the General panel.
  2. When finished, qui the application and move it to the Trash.

wired server mac 2

NOTE: If you enabled the status menu, it's recommended to disable it from the Wired Server.app user interface before moving Wired Server to the Trash.

IV. Settings

Wired Server for Mac OS X provides controls to manage server settings and features. Several of these features are regrouped into several panels.

General

wired server mac 1

The General panel gives an overview of the server status and minimal controls to manage the server process.

wired server mac 1.1

Network

wired server mac 3

The Network panel provides server port settings, port status and port mapping.

Files

wired server mac 4

Here you can manage shared files that are available to connected and authorized clients.

Advanced

wired server mac 5

Logs

wired server mac 6

Update

wired server mac 7

Import/Export

Wired Server for Mac OS X supports import and export of the server configuration and database in a single archive file, to facilitate migration process.

Administrate from Wired Client

Most of the Wired Server administration is available from Wired Client for Mac OSX.

V. Migration

If you are currently using an older version of Wired Server and you want to migrate to this new version, have a look to this how-to.

VI. Troubleshootings

CPU overload and you can't connect to the server

This is probably because you have the old zankasoftware.com LaunchAgent still loaded by launchctl. The easy way to fix this is to remove the following file ~/Library/LaunchAgents/com.zankasoftware.WiredServer.plist then to restart the system.

If you wont restart you can try to unload the agent in command-line:

$ launchctl unload ~/Library/LaunchAgents/com.zankasoftware.WiredServer.plist

$ rm ~/Library/LaunchAgents/com.zankasoftware.WiredServer.plist

Kill wired process (kill -9 <PID>) then restart it. Should be fine.

You have the following error: database disk image is malformed

This error message wants to say that your database is corrupted. This can be due to suddent terminasion of the system or other unpredictable behavior. Fortunately, there are many chances you can restore it.

This exemple is for Mac OS X, but works the same with UNIX-like OS. Just use the right paths.

  1. Stop Wired server.

  2. In a terminal, backup you corrupted database (we never know…):

    $ cp ~/Library/Wired/database.sqlite3 ~/Library/Wired/database.sqlite3.old
    
  3. Load you database file with sqlite3:

    $ sqlite3 ~/Library/Wired/database.sqlite3
    
  4. This will open you the sqlite shell. Now execute the following in order to dump the content of your database:

    sqlite > .mode insert
    sqlite > .output /tmp/database.sqlite3.dump
    sqlite > .dump
    sqlite > .exit
    
  5. Clear the database file, we will recreate it:

    $ rm ~/Library/Wired/database.sqlite3
    
  6. Now, restore your database content:

    $ sqlite3 ~/Library/Wired/database.sqlite3
    sqlite > .read /tmp/database.sqlite3.dump
    sqlite > .exit
    

The error message should be gone.