5733XJ1 IBM i Access Client Solutions – QuickStartGuide

IBM i

Jul 29

The content of this document was last updated on: March 29, 2019

Contents:

1.0 Introduction
2.0 Installation for Windows
3.0 Installation for Mac
4.0 Installation for Linux
5.0 Installing Updates
6.0 More Information
7.0 Uninstall


1.0 Introduction

This guide provides instructions on how to deploy this product on a local disk drive for a single user.

There are a variety of other ways this product can also be deployed including:

To deploy this product on the local disk drive for a single user, see the remaining sections of this document.


2.0 Installation for Windows

Locate the product zip archive or product CD.

If you are using the product zip archive, extract the the contents of the zip archive. 
Suggestion: This can be done by using Windows Explorer to select the zip archive, then right-clicking on it, and then selecting “Extract All…”.

Using Windows Explorer, locate the product’s Windows_Application folder.

To install the 32 bit version for the current user, double-click on install_acs_32.

To install the 64 bit version for the current user, double-click on install_acs_64.

To install the 32 bit version for all users on a multi-user PC, double-click on install_acs_32_allusers.

To install the 64 bit version for all users on a multi-user PC, double-click on install_acs_64_allusers.

If this is a new installation, there will be several prompts that will help you customize the initial installation. If a license agreement appears, accept it.

If this is an upgrade, the previous settings will be preserved.

When the install has finished, a completion message will be displayed.

A successful single-user install will copy the application to:

    /Users/user_id/IBM/ClientSolutions/

Note: The initial version of these scripts copied the product files to a path relative to MyDocuments. The current version copies the product files to a path based on the environment variables %HOMEDRIVE% and %HOMEPATH%. When using these scripts to update the product, updates will occur to the first location found.

A successful multi-user install will copy the application to:

    /Users/Public/IBM/ClientSolutions/

2.1 Starting the product on Windows

Double-click the “Access Client Solutions” icon on the desktop.


3.0 Installation for Mac

Locate the product zip archive or CD using Finder.

If you are using the product zip archive, extract the the contents of the zip archive. 
Suggestion: If you just downloaded the product, look in Downloads. If the contents of the zip archive have not been extracted, then you may extract the contents of the zip archive by double-clicking it.

Locate the Mac_Application folder. Double click install_acs

If this is a new installation, there will be several prompts that will help you customize the initial installation. If a license agreement appears, accept it.

If this is an upgrade, the previous settings will be preserved.

When the install has finished, a completion message will be displayed.

A successful install will copy the application to the Applications folder.

If you started the install from Finder, a terminal window was opened to perform the installation. When the installation is complete, you can close the terminal window.

Tech Note:
Depending on your security settings and the version of OS X you are using, you may get a pop-up window indicating install_acs is not authorized to run. If that happens, you will need to authorize install_acs to run by using one of following methods:

  • If you are presented with an option to “Open” install_acs, then select it.
  • Right-click on install_acs and select “Open”.
    When presented with a pop-up window, select “Open”.
  • If neither of the above options work, then go to:
    System Preferences…
    Security & Privacy
    If there is an option to Open “IBM i Access Client Solutions”, select it. Otherwise, you will need to adjust the settings on the General tab to allow other applications to run. After “IBM i Access Client Solutions” starts the first time, you may change your security settings back.

3.1 Starting the product on Mac

Use Finder to go to Applications.

Locate “IBM i Access Client Solutions” and double click it to start the product.

Tech Note:
Depending on your security settings and the version of OS X you are using, you may get a pop-up window indicating the application is not authorized to run. If that happens, you will need to authorize the application to run by using one of the following methods:

  • If you are presented with an option to “Open” it, select it.
  • Right-click on the “IBM i Access Client Solutions” icon and select “Open”.
    When presented with a pop-up window, select “Open”.
  • If neither of the above options work, then go to:
    System Preferences…
    Security & Privacy
    If there is an option to Open “IBM i Access Client Solutions”, select it. Otherwise, you will need to adjust the settings on the General tab to allow other applications to run. After “IBM i Access Client Solutions” starts the first time, you may change your security settings back.

Tech Notes:

  • If you are prompted to install “Java 6 SE runtime”, you do not need to install Java 6. Install Java 8 and then try to start the product again.
  • When installing Java on Mac, select a JDK instead of a JRE. The JRE for Mac installs Java for only the browser. It does not install Java for other applications. Installing the JDK will make Java available to other applications such as IBM i Access Client Solutions.

4.0 Installation for Linux

Locate the product zip archive or product CD.

If you are using the product zip archive, extract the the contents of the zip archive. 
Suggestion: From a terminal window, use the unzip command.

Locate the Linux_Application folder.

Since you will need to have root authority to use the install script, use sudo to run the install script from a terminal window. For example:

If you are on a 32 bit architecture, use the following command:

    sudo ./install_acs_32

If you are on a 64 bit architecture, use the following command:

    sudo ./install_acs_64

If this is a new installation, there will be several prompts that will help you customize the initial installation. If a license agreement appears, accept it.

If this is an upgrade, the previous settings will be preserved.

When the install has finished, a completion message will be displayed.

A successful install will copy the application to:

    /opt/ibm/iAccessClientSolutions/
    /usr/share/applications/

4.1 Starting the product on Linux

Search for “IBM i Access Client Solutions” in the applications folder or by using the Super key and then typing “IBM i Access Client Solutions”.


5.0 Installing Updates

When a new version becomes available, you can follow the installation instructions in this document to apply the updates. If you are prompted to overlay existing files, answer with “Yes to all”.

If you are using the install_acs scripts for Windows, Mac or Linux, the AcsConfig.properties file will not be updated so any custom configuration changes you have made to that file will not be lost.


6.0 More Information

For additional information about customizing the product or if you experience problems while installing or starting the product, see the GettingStarted document located in the Documentation folder.


7.0 Uninstall

To remove the application files that were copied to the above locations by the install script, use the platform-specific uninstall script found in the same folder as the install script:

    Windows_Application/uninstall_acs.js
    Mac_Application/uninstall_acs
    Linux_Application/uninstall_acs
Follow

About the Author

IBM i Software Developer, Digital Dad, AS400 Anarchist, RPG Modernizer, Alpha Nerd and Passionate Eater of Cheese and Biscuits. Nick Litten Dot Com is a mixture of blog posts that can be sometimes serious, frequently playful and probably down-right pointless all in the space of a day. Enjoy your stay, feel free to comment and in the words of the most interesting man in the world: Stay thirsty my friend.