Nexus logoNexus 4.0 New Installation Instructions

These instructions are for new installations of Nexus 4.0 only. Please log in to to access the New Features and Upgrade Guide as well as the Reference Guide.

Step 1. Download the Install Files.

If you haven't yet downloaded the Nexus install file to your PC, do that now Opens new window. Then return to this page. If you have already downloaded the install file you can continue with Step 2.

Save the downloaded file to a new folder on your PC:

The actual file name may change as different releases of the software are made available.


If you have a question about the install, give us a call. You can reach our Technical Support team at (250) 655-1766 [7:30-17:00 PST] or the Sales team at (630) 986-0800 [8:00-17:30 CST]. You can also email us.

You can also search our Knowledge Base Opens new window on this topic.

Step 2. Transfer the Install Files to your IBM i.

When the download completes, double-click the downloaded file to transfer the install library to your IBM i. After the file is unpacked, the FTP transfer utility is automatically presented.

Enter your IBM i IP address or domain name and your user profile information (QSECOFR is not required) as shown below:

Click the Upload button. This step takes a few minutes to complete. When the upload finishes the activity log displays the message 'File upload complete'. Close the FTP utility.


If the transfer is interrupted, you can restart it by executing install.exe (in the folder to which you downloaded the install file).

If the transfer fails, check the Activity Log window for errors. BCD's Knowledge Base Opens new window includes a number of useful troubleshooting options.

You can also run the command WRKSPLF QTCP and check the last joblog there.

This article Opens new window lists a couple ways on how to find your IBM i's IP address.

Step 3. Install the IBM i Components.

Begin the IBM i Installation
To begin the installation log in to an IBM i session as QSECOFR and execute the command BCDINSTALL/BCDINSTALL. The install will present a summary list of the installation steps. Review the instructions and press Enter to continue.

Enter your License Key
Nexus 4 requires a valid license key before beginning the install. Enter your key at this screen:

If you don't have a license key handy, you can exit the installation here and contact your sales representative at BCD, or log in to to submit a request. After entering your key, press enter to continue.

Set your Environment Name
As the first step of the actual installation, enter the name of the library to install to:

The default library name is XL_NEXUS. We recommend you use this default unless you are installing multiple instances, or upgrading a previous library with a different name.

When you press Enter, Nexus displays a summary of the installation locations:

You may wish to print this screen for your records.

Continue with the next step.


License Keys
If you are an existing customer with a current maintenance contract, log in to to submit a request for a Nexus 4 license key.

Entering License Keys

Visit the License Key Entry Instructions for more infomation on how to enter your keys.

Restoring the Product Library
After you select the library to install to, BCDINSTALL attempts to restore the product library. It's very rare to have a problem with this step, but any that do come are usually due to changes to the RSTLIB command defaults.

You can also search our Knowledge Base Opens new window on this topic.

Step 4. Start the HTTP Server Instance.

After the product libraries and IFS files have been restored you need to start the Nexus Apache HTTP server instance:

Press Enter at this screen to finish the install.

To start the XL_NEXUS HTTP server instance, enter your IBM i IP address below and click the Manage HTTP Servers button. When prompted, log on as QSECOFR and then continue with the instructions below:

. . .

This page may take a few seconds to load. At the page presented go to the Manage tab and select the XL_NEXUS server instance from the dropdown list:

After selecting the server instance, verify its status. If it's stopped (as shown above), click the green button to start it.

You can also start the server instance directly from an IBM i session using the command STRTCPSVR SERVER(*HTTP) HTTPSVR(XL_NEXUS).

Once the server instance is shown as running, click this button to present the Nexus login program:

This test uses the IP address you entered above. If the program isn't found, verify your system IP address in the new browser window.

At the page presented, take note the URL of the page that opens: we have automatically appended the XL_NEXUS configuration's port number (8010) to your IP address, as well as the default Nexus login program's URL. We recommend that you bookmark that page.

If you get a Nexus login, it means you have successfully installed the portal, and started a functioning HTTP server instance. You can log in using the profile 'NEXUSADMIN' (password also 'NEXUSADMIN').


If when you attempt to access the :2001 interface, the page won't load, it's probably because you don't have the ADMIN HTTP server instance started on your IBM i. To start it, run this command: STRTCPSVR SERVER(*HTTP) HTTPSVR(ADMIN).

The XL_NEXUS server instance runs on port 8010; if you wish to change this value you can edit the configuration file before starting the server instance

The URL for the Admin interface is, where the x's represent your IBM i IP address or domain name. If you log in this way, at the first page presented you'll need to click on the first link. The text for this link may vary depending on your OS/400 release level, but it will be something like 'IBM Web Administration for i5/OS.

You can also search our Knowledge Base Opens new window on this topic.

Step 5. Enable ECM Document Emailing.

The Nexus ECM supports the ability to email certain types of documents. In order to use this feature you need to configure your SMTP settings for Nexus. These settings are shared with WebSmart, if you use it, and may already be set.

Follow the steps below to set this up:

At your IBM i session add XL_WEBSPT to your library list.

Type the command ECFGSMTP and press F4. A panel similar to this one is displayed:

Enter your mail server's IP address & port and press Enter.

Most email servers won't send messages from invalid addresses, so you need to also check that the Nexus profile NEXUSADMIN has a valid email address.
  1. To check this start by logging into Nexus as NEXUSADMIN.
  2. Once you have logged in click the "Settings" link in the top right.
  3. At the page presented, click the option Edit My Account, then re-enter your password to proceed.
  4. At the Edit My Account page, verify that the Email Address field contains a valid address. If not, change it and click Change to save the new address.
  5. To test the emailing, click the My Pages link to return to the main ECM window, and in the Navigator on the right, click the Key Features document. When it loads, you'll see an email link in the top right of the window on the right. Click this button.

After making these changes you should be able to email ECM documents.

This concludes the installation instructions.


Once you set up and enable emailing, you should also get confirmation of new users who's profiles are self-created from the Login Page, when the 'Create a new Account' button is enabled.

You can also search our Knowledge Base Opens new window on this topic.

Step 5. Verifying your Configuration and Learning to Use the Software.

If you got to a Nexus login in Step 4, it means you have successfully installed the portal and started a functioning HTTP server instance. You can use the NEXUSADMIN profile to log in.

Now you're ready to start learning how to use Nexus.

Continue with Step 2 of the 5 Steps to Success with Nexus.

If at any point in this process you would like to have an informal chat with someone to get some suggestions on how to address your particular needs, then by all means get in touch with our Sales or Technical Support teams.

We will look forward to hearing from you soon.


If the page doesn't load at all, confirm that you entered the right IP address for your IBM i.

If you get a Nexus license key error, contact BCD to verify your license key. Then use the command XL_NEXUS/UNLOCK to enter the license key provided.