uDeploy® Administration Guide 4.8.5 uDeploy Administration Guide: 4.8.5 Publication date August 2013 Copyright © 2011, 2013 UrbanCode, an IBM Company, Inc. About ............................................................................................................................... 1 Product Documentation ............................................................................................... 1 Product Support ......................................................................................................... 1 Document Conventions ................................................................................................ 1 Documentation notices for IBM uDeploy ................................................................................ 2 Installing and Upgrading Servers and Agents .......................................................................... 5 Installation Recommendations ....................................................................................... 6 System Requirements .................................................................................................. 6 Server Minimum Installation Requirements ............................................................. 6 Recommended Server Installation .......................................................................... 6 Agent Minimum Requirements ............................................................................. 7 32- and 64-bit JVM Support ................................................................................. 7 Performance Recommendations ............................................................................. 8 Download uDeploy ..................................................................................................... 8 Database Installation ................................................................................................... 8 Installing Oracle ................................................................................................. 9 Installing MySQL ............................................................................................... 9 Installing Microsoft SQL Server .......................................................................... 10 Server Installation ..................................................................................................... 11 Windows Server Installation ............................................................................... 11 Unix/Linux Installation ...................................................................................... 13 Agent Installation ..................................................................................................... 14 Installing an Agent ............................................................................................ 15 Connecting Agents to Agent Relays ..................................................................... 16 Installing Agent Relays .............................................................................................. 16 Upgrading uDeploy ................................................................................................... 18 Upgrading Agents ............................................................................................. 18 Migrating Security .................................................................................................... 18 Creating an Agent Pool ...................................................................................... 18 Managing Agent Pools ....................................................................................... 19 SSL Configuration .................................................................................................... 19 Configuring SSL Unauthenticated Mode for HTTP Communications .......................... 20 Configuring Mutual Authentication ...................................................................... 20 Exchanging keystores between servers .................................................................. 22 Running uDeploy ...................................................................................................... 23 Running the Server ........................................................................................... 23 Running an Agent ............................................................................................. 23 Running an Agent Relay .................................................................................... 23 Accessing uDeploy ............................................................................................ 23 uDeploy Security .............................................................................................................. 24 Roles and Permissions ............................................................................................... 25 Default Roles ................................................................................................... 25 Creating and Editing Roles ................................................................................. 26 Agent Roles ..................................................................................................... 26 Application Roles ............................................................................................. 27 Component Template Roles ................................................................................ 27 Component Roles .............................................................................................. 27 Environment Roles ............................................................................................ 28 License Roles ................................................................................................... 28 Resource Roles ................................................................................................. 28 Default Permissions ................................................................................................... 29 Setting Default Permissions ................................................................................ 29 Authorization Realms ................................................................................................ 30 Creating an LDAP Authorization Realm ............................................................... 30 iii uDeploy® Administration Guide Groups ............................................................................................................ 31 Authentication Realms ............................................................................................... 32 Creating an Authentication Realm ........................................................................ 32 Creating Users .................................................................................................. 33 Importing LDAP Users ...................................................................................... 33 Tokens .................................................................................................................... 33 User Interface Security .............................................................................................. 34 System Security ........................................................................................................ 35 System Settings ................................................................................................................ 36 Installing Plug-ins ..................................................................................................... 36 Locks ...................................................................................................................... 36 Managing Locks ............................................................................................... 36 Post-Processing Scripts .............................................................................................. 37 Inventory and Component Statuses .............................................................................. 38 Creating Statuses .............................................................................................. 38 Using Statuses .................................................................................................. 39 Licenses .................................................................................................................. 39 Adding a License .............................................................................................. 39 Adding Agents to a License ................................................................................ 40 Log Settings ............................................................................................................ 40 Network Settings ...................................................................................................... 40 Notifications ............................................................................................................ 41 Output Log .............................................................................................................. 43 System Properties ..................................................................................................... 43 System Settings ........................................................................................................ 44 Preview Version Cleanup ................................................................................... 45 Configuration ..................................................................................................................